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



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|--sym
       link] [--] [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 __.deb as
       specified in the control file of the package. The  part of the
       filename  consists  of the upstream version information optionally fol
       lowed by a hyphen and the revision information.

OPTIONS
       -a, --no-architecture
	      The destination filename will not have the architecture informa
	      tion.

       -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
	      otherwise 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-/
. 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 
/binary-. The section field isnt required so a lot of packages
	      will  find  their  way to the no-section area. Use this option
	      with care, its messy.

       -c, --create-dir
	      This option can used together with the -s option.  If  a	target
	      directory  isnt  found  it  will be created 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.

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 subdirectorys 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
	      Dont  do	this.	Your  archive  will  be  messed up completely
	      because a lot of packages dont come with	section  information.
	      Dont do this.

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

BUGS
       Some   packages	 dont	follow	the  name  structure  __.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).

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



Debian Project			  2006-02-28			  dpkg-name(1)