187 lines
5.4 KiB
HTML
187 lines
5.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dpkg-name</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dpkg-name</H1>
|
|
Section: dpkg suite (1)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
dpkg-name - rename Debian packages to full package names
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>dpkg-name</B>
|
|
|
|
[<I>option</I>...]
|
|
|
|
[<B>--</B>]
|
|
|
|
<I>file</I>...
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
This manual page documents the
|
|
<B>dpkg-name</B>
|
|
|
|
program which provides an easy way to rename
|
|
<B>Debian</B>
|
|
|
|
packages into their full package names. A full package name consists of
|
|
<I>package</I><B>_</B><I>version</I><B>_</B><I>architecture</I><B>.</B><I>package-type</I>
|
|
|
|
as specified in the control file of the package. The <I>version</I> part
|
|
of the filename
|
|
consists of the upstream version information optionally followed by a
|
|
hyphen and the revision information. The <I>package-type</I> part comes
|
|
from that field if present or fallbacks to <B>deb</B>.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-a</B>, <B>--no-architecture</B>
|
|
|
|
<DD>
|
|
The destination filename will not have the architecture information.
|
|
<DT id="2"><B>-k</B>, <B>--symlink</B>
|
|
|
|
<DD>
|
|
Create a symlink, instead of moving.
|
|
<DT id="3"><B>-o</B>, <B>--overwrite</B>
|
|
|
|
<DD>
|
|
Existing files will be overwritten if they have the same name as the
|
|
destination filename.
|
|
<DT id="4"><B>-s</B>, <B>--subdir</B> [<I>dir</I>]
|
|
|
|
<DD>
|
|
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>/<I>section</I>».
|
|
If the section is not found in the control, then <B>no-section</B> is assumed,
|
|
and in this case, as well as for sections <B>non-free</B> and <B>contrib</B>
|
|
the target directory is «<I>section</I>/binary-<I>architecture</I>».
|
|
The section field is not required so a lot of packages will find their way
|
|
to the <B>no-section</B> area.
|
|
Use this option with care, it's messy.
|
|
<DT id="5"><B>-c</B>, <B>--create-dir</B>
|
|
|
|
<DD>
|
|
This option can used together with the <B>-s</B> option. If a target
|
|
directory isn't found it will be created automatically.
|
|
<B>Use this option with care.</B>
|
|
|
|
<DT id="6"><B>-?</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Show the usage message and exit.
|
|
<DT id="7"><B>-v</B>, <B>--version</B>
|
|
|
|
<DD>
|
|
Show the version and exit.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="8"><B>DPKG_COLORS</B>
|
|
|
|
<DD>
|
|
Sets the color mode (since dpkg 1.18.5).
|
|
The currently accepted values are: <B>auto</B> (default), <B>always</B> and
|
|
<B>never</B>.
|
|
<DT id="9"><B>DPKG_NLS</B>
|
|
|
|
<DD>
|
|
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</B> and <B>1</B> (default).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Some packages don't follow the name structure
|
|
<I>package</I><B>_</B><I>version</I><B>_</B><I>architecture</I><B>.deb</B>.
|
|
|
|
Packages renamed by <B>dpkg-name</B>
|
|
will follow this structure. Generally this will have no impact on how
|
|
packages are installed by
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dselect">dselect</A></B>(1)/<B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1),
|
|
|
|
but other installation tools
|
|
might depend on this naming structure.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><B>dpkg-name bar-foo.deb</B>
|
|
|
|
<DD>
|
|
The file <B>bar-foo.deb</B> 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</B>).
|
|
<DT id="11"><B>find /root/debian/ -name '*.deb' | xargs -n 1 dpkg-name -a</B>
|
|
|
|
<DD>
|
|
All files with the extension <B>deb</B> in the directory /root/debian and its
|
|
subdirectory's will be renamed by <B>dpkg-name</B> if required into names
|
|
with no architecture information.
|
|
<DT id="12"><B>find -name '*.deb' | xargs -n 1 dpkg-name -a -o -s -c</B>
|
|
|
|
<DD>
|
|
<B>Don't do this.</B>
|
|
|
|
Your archive will be messed up completely because a lot of packages
|
|
don't come with section information.
|
|
<B>Don't do this.</B>
|
|
|
|
<DT id="13"><B>dpkg-deb --build debian-tmp && dpkg-name -o -s .. debian-tmp.deb</B>
|
|
|
|
<DD>
|
|
This can be used when building new packages.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb">deb</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-control">deb-control</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-deb">dpkg-deb</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+find">find</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xargs">xargs</A></B>(1).
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="14"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="15"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="16"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="17"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="18"><A HREF="#lbAF">ENVIRONMENT</A><DD>
|
|
<DT id="19"><A HREF="#lbAG">BUGS</A><DD>
|
|
<DT id="20"><A HREF="#lbAH">EXAMPLES</A><DD>
|
|
<DT id="21"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:11 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|