dpkg-name(e)              dpkg utilities             dpkg-name(e)



NAME
       dpkg-name - rename Debian packages to full package names

SYNOPSIS
       dpkg-name      [-a|--no-architecture]     [-o|--overwrite]
       [-s|--subdir    [dir]]    [-c|--create-dir]    [-h|--help]
       [-v|--version]    [-l|--license]   [-k|--symlink]   [-[--]
       [files]

DESCRIPTION
       This manual page documents the dpkg-name sh  script  which
       provides  an easy way to rename Debian packages into their
       full package names. A full package name consists of <pack-
       age>_<version>_<architecture>.deb as specified in the con-
       trol file of the package. The <version> part of the  file-
       name   consists  of  the  mainstream  version  information
       optionally followed by a hyphen and the revision  informa-
       tion.

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  archi-
              tecture information.

       find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c
              Don't do this.  Your archive will be messed up com-
              pletely 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.

   OPTIONS
       -a, --no-architecture
              The  destination  filename will not have the archi-
              tecture 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 subdir. If directory given
              as argument exists the files  will  be  moved  into
              that  direcotory  otherswise the name of the target
              directory is extracted from the  section  field  in
              the  control part of the package. The target direc-
              tory will be  `unstable/binary-<architecture>/<sec-
              tion>'.  If the section is `non-free', `contrib' or
              no section information is found in the control file
              the  target  directory is `<section>/binary-<archi-
              tecture>'. The section field isn't  required  so  a
              lot of packages will find their way to the `no-sec-
              tion' 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  cre-
              ated automatically.  Use this option with care.

       -h, --help
              Print a usage message and exit successfully.

       -v, --version
              Print version information and exit successfully.

       -l, --license
              Print  copyright  information  and  (a reference to
              GNU) license information and exit successfully.

BUGS
       Some packages  don't  follow  the  name  structure  <pack-
       age>_<version>_<architecture>.deb.   Packages  renamed  by
       dpkg-name will follow this structure. Generally this  will
       have  no  impact  on  how  packages  are installed by dse-
       lect/dpkg, but other installation tools  might  depend  on
       this naming structure.

SEE ALSO
       deb(b),  deb-control(l),  dpkg(g),  dpkg(g),  dpkg-deb(b),
       find(d), xargs(s).

COPYRIGHT
       Copyright 1995,1996 Erick Branderhorst.  dpkg-name is free
       software;  see the GNU General Public Licence version 2 or
       later for copying conditions. There is no warranty.



Debian Project               May 1996                dpkg-name(e)