summaryrefslogtreecommitdiffstats
path: root/man/dpkg-name.pod
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--man/dpkg-name.pod162
1 files changed, 162 insertions, 0 deletions
diff --git a/man/dpkg-name.pod b/man/dpkg-name.pod
new file mode 100644
index 0000000..66b3af6
--- /dev/null
+++ b/man/dpkg-name.pod
@@ -0,0 +1,162 @@
+# dpkg manual page - dpkg-name(1)
+#
+# Copyright © 1995-1996 Erick Branderhorst
+# Copyright © 2007-2013, 2015 Guillem Jover <guillem@debian.org>
+#
+# This is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+=encoding utf8
+
+=head1 NAME
+
+dpkg-name - rename Debian packages to full package names
+
+=head1 SYNOPSIS
+
+B<dpkg-name>
+[I<option>...]
+[B<-->]
+I<file>...
+
+=head1 DESCRIPTION
+
+This manual page documents the
+B<dpkg-name>
+program which provides an easy way to rename
+B<Debian>
+packages into their full package names. A full package name consists of
+I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type>
+as specified in the control file of the package. The I<version> part
+of the filename
+consists of the upstream version information optionally followed by a
+hyphen and the revision information. The I<package-type> part comes
+from that field if present or fallbacks to B<deb>.
+
+=head1 OPTIONS
+
+=over
+
+=item B<-a>, B<--no-architecture>
+
+The destination filename will not have the architecture information.
+
+=item B<-k>, B<--symlink>
+
+Create a symlink, instead of moving.
+
+=item B<-o>, B<--overwrite>
+
+Existing files will be overwritten if they have the same name as the
+destination filename.
+
+=item B<-s>, B<--subdir> [I<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-I<architecture>/I<section>».
+If the section is not found in the control, then B<no-section> is assumed,
+and in this case, as well as for sections B<non-free> and B<contrib>
+the target directory is «I<section>/binary-I<architecture>».
+The section field is not required so a lot of packages will find their way
+to the B<no-section> area.
+
+B<Warning:>
+I<Use this option with care, it is messy.>
+
+=item B<-c>, B<--create-dir>
+
+This option can used together with the B<-s> option. If a target
+directory isn't found it will be created automatically.
+
+B<Warning:>
+I<Use this option with care.>
+
+=item B<-?>, B<--help>
+
+Show the usage message and exit.
+
+=item B<-v>, B<--version>
+
+Show the version and exit.
+
+=back
+
+=head1 ENVIRONMENT
+
+=over
+
+=item B<DPKG_COLORS>
+
+Sets the color mode (since dpkg 1.18.5).
+The currently accepted values are: B<auto> (default), B<always> and
+B<never>.
+
+=item B<DPKG_NLS>
+
+If set, it will be used to decide whether to activate Native Language Support,
+also known as internationalization (or i18n) support (since dpkg 1.19.0).
+The accepted values are: B<0> and B<1> (default).
+
+=back
+
+=head1 BUGS
+
+Some packages don't follow the name structure
+I<package>B<_>I<version>B<_>I<architecture>B<.deb>.
+Packages renamed by B<dpkg-name>
+will follow this structure. Generally this will have no impact on how
+packages are installed by
+B<dselect>(1)/B<dpkg>(1),
+but other installation tools
+might depend on this naming structure.
+
+=head1 EXAMPLES
+
+=over
+
+=item B<dpkg-name bar-foo.deb>
+
+The file B<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 B<bar-foo.deb>).
+
+=item B<find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a>
+
+All files with the extension B<deb> in the directory /root/debian and its
+subdirectory's will be renamed by B<dpkg-name> if required into names
+with no architecture information.
+
+=item B<find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c>
+
+B<Don't do this.>
+Your archive will be messed up completely because a lot of packages
+don't come with section information.
+B<Don't do this.>
+
+=item B<dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb>
+
+This can be used when building new packages.
+
+=back
+
+=head1 SEE ALSO
+
+B<deb>(5),
+B<deb-control>(5),
+B<dpkg>(1),
+B<dpkg-deb>(1),
+B<find>(1),
+B<xargs>(1).