man-pages/man1/dpkg-scanpackages.1.html
2021-03-31 01:06:50 +01:00

206 lines
5.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of dpkg-scanpackages</TITLE>
</HEAD><BODY>
<H1>dpkg-scanpackages</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">&nbsp;</A>
<H2>NAME</H2>
dpkg-scanpackages - create Packages index files
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>dpkg-scanpackages</B>
[<I>option</I>...] <I>binary-path</I>
[<I>override-file</I>
[<I>path-prefix</I>]]
<B>&gt;</B>
<I>Packages</I>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>dpkg-scanpackages</B>
sorts through a tree of Debian binary packages and creates a Packages
file, used by
<B><A HREF="/cgi-bin/man/man2html?8+apt">apt</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?1+dselect">dselect</A></B>(1),
etc, to tell the user what packages are available for installation. These
Packages files are the same as those found on Debian archive sites
and CD-ROMs. You might use
<B>dpkg-scanpackages</B>
yourself if making a directory of local packages to install on a cluster
of machines.
<P>
<B>Note:</B>
If you want to access the generated Packages file with
<B>apt</B>
you will probably need to compress the file with
<B><A HREF="/cgi-bin/man/man2html?1+xz">xz</A></B>(1)
(generating a Packages.xz file),
<B><A HREF="/cgi-bin/man/man2html?1+bzip2">bzip2</A></B>(1)
(generating a Packages.bz2 file) or
<B><A HREF="/cgi-bin/man/man2html?1+gzip">gzip</A></B>(1)
(generating a Packages.gz file). apt ignores uncompressed Packages
files except on local access (i.e.
<B>file://</B>
sources).
<P>
<I>binary-path</I>
is the name of the tree of the binary packages to process (for example,
<B>contrib/binary-i386</B>).
It is best to make this relative to the root of the Debian archive,
because every Filename field in the new Packages file will start with
this string.
<P>
<I>override-file</I>
is the name of a file to read which contains information about how the
package fits into the distribution (the file can be compressed
since dpkg 1.15.5); see
<B><A HREF="/cgi-bin/man/man2html?5+deb-override">deb-override</A></B>(5).
<P>
<I>path-prefix</I>
is an optional string to be prepended to the Filename fields.
<P>
If more than one version of a package is found only the newest one
is included in the output. If they have the same version and only
differ in architecture only the first one found is used.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-t</B>, <B>--type</B> <I>type</I>
<DD>
Scan for *.<I>type</I> packages, instead of *.deb.
<DT id="2"><B>-e</B>, <B>--extra-override</B> <I>file</I>
<DD>
Scan <I>file</I> to find supplementary overrides (the file can be
compressed since dpkg 1.15.5).
See
<B><A HREF="/cgi-bin/man/man2html?5+deb-extra-override">deb-extra-override</A></B>(5)
for more information on its format.
<DT id="3"><B>-a</B>, <B>--arch</B> <I>arch</I>
<DD>
Use a pattern consisting of <I>*_all.deb</I> and <I>*_arch.deb</I> instead of
scanning for all debs.
<DT id="4"><B>-h</B>, <B>--hash</B> <I>hash-list</I>
<DD>
Only generate file hashes for the comma-specified list specified
(since dpkg 1.17.14).
The default is to generate all currently supported hashes.
Supported values: <B>md5</B>, <B>sha1</B>, <B>sha256</B>.
<DT id="5"><B>-m</B>, <B>--multiversion</B>
<DD>
Include all found packages in the output.
<DT id="6"><B>-M</B>, <B>--medium</B> <I>id-string</I>
<DD>
Add an <B>X-Medium</B> field containing the value <I>id-string</I>
(since dpkg 1.15.5).
This field is required if you want to generate <B>Packages.cd</B> files
for use by the multicd access method of dselect.
<DT id="7"><B>-?</B>, <B>--help</B>
<DD>
Show the usage message and exit.
<DT id="8"><B>--version</B>
<DD>
Show the version and exit.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>ENVIRONMENT</H2>
<DL COMPACT>
<DT id="9"><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="10"><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">&nbsp;</A>
<H2>DIAGNOSTICS</H2>
<B>dpkg-scanpackages</B>
outputs the usual self-explanatory errors. It also warns about packages
that are in the wrong subdirectory, are duplicated, have a Filename
field in their control file, are missing from the override file, or have
maintainer substitutions which do not take effect.
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+dselect">dselect</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+deb-override">deb-override</A></B>(5),
<B><A HREF="/cgi-bin/man/man2html?5+deb-extra-override">deb-extra-override</A></B>(5),
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-scansources">dpkg-scansources</A></B>(1).
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="14"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="15"><A HREF="#lbAF">ENVIRONMENT</A><DD>
<DT id="16"><A HREF="#lbAG">DIAGNOSTICS</A><DD>
<DT id="17"><A HREF="#lbAH">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>