dpkg-name(1)							  dpkg utilities						      dpkg-name(1)

NAME

       dpkg-name - rename Debian packages to full package names

SYNOPSIS

       dpkg-name [option...]  [--] file...

DESCRIPTION

       This manual page documents the dpkg-name program which provides an easy way to rename Debian packages into their full package names. A full
       package name consists of package_version_architecture.package-type as specified in the control file of the package. The version part of the
       filename  consists  of the upstream version information optionally followed by a hyphen and the revision information. The package-type part
       comes from that field if present or fallbacks to deb.

OPTIONS

       -a, --no-architecture
	      The destination filename will not have the architecture information.

       -k, --symlink
	      Create a symlink, instead of moving.

       -o, --overwrite
	      Existing files will be overwritten if they have the same name as the destination filename.

       -s, --subdir [dir]
	      Files will be moved into a subdirectory. If the directory given as argument exists the files will be moved into that directory  oth-
	      erwise the name of the target directory is extracted from the section field in the control part of the package. The target directory
	      will be `unstable/binary-architecture/section'. If the section is not found in the control, then `no-section'  is  assumed,  and	in
	      this case, as well as for sections `non-free' and `contrib' the target directory is `section/binary-architecture'. The section field
	      isn't required so a lot of packages will find their way to the `no-section' area. Use this option with care, it's messy.

       -c, --create-dir
	      This option can used together with the -s option. If a target directory isn't found it will  be  created	automatically.	 Use  this
	      option with care.

       -?, --help
	      Show the usage message and exit.

       -v, --version
	      Show the version and exit.

EXAMPLES

       dpkg-name bar-foo.deb
	      The  file  `bar-foo.deb' will be renamed to bar-foo_1.0-2_i386.deb or something similar (depending on whatever information is in the
	      control part of `bar-foo.deb').

       find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a
	      All files with the extension `deb' in the directory /root/debian and its subdirectory's will be renamed  by  dpkg-name  if  required
	      into names with no architecture information.

       find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c
	      Don't  do  this.	Your archive will be messed up completely because a lot of packages don't come with section information.  Don't do
	      this.

       dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb
	      This can be used when building new packages.

BUGS

       Some packages don't follow the name structure package_version_architecture.deb.	Packages renamed by dpkg-name will follow this	structure.
       Generally  this	will have no impact on how packages are installed by dselect(1)/dpkg(1), but other installation tools might depend on this
       naming structure.

SEE ALSO

       deb(5), deb-control(5), dpkg(1), dpkg-deb(1), find(1), xargs(1).

Debian Project							    2012-04-15							      dpkg-name(1)