dpkg-name(1) dpkg utilities dpkg-name(1)
NAME
dpkg-name - rename Debian packages to full package names
SYNOPSIS
dpkg-name [options] [--] files
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 <pack-
age_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.
-h, --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 --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 struc-
ture. 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).
AUTHOR
Copyright (C) 1995,1996 Erick Branderhorst
This is free software; see the GNU General Public Licence version 2 or later for copying conditions. There is NO WARRANTY.
Debian Project 2008-08-18 dpkg-name(1)