<?xml version="1.0" encoding="utf-8" standalone="no"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
-
-<!ENTITY % aptent SYSTEM "apt.ent">
-%aptent;
-
-<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent">
-%aptverbatiment;
-
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % aptent SYSTEM "apt.ent"> %aptent;
+<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> %aptverbatiment;
+<!ENTITY % aptvendor SYSTEM "apt-vendor.ent"> %aptvendor;
]>
<refentry>
&apt-email;
&apt-product;
<!-- The last update date -->
- <date>2009-08-17T00:00:00Z</date>
+ <date>2016-08-06T00:00:00Z</date>
</refentryinfo>
<refmeta>
programs aside from &gzip;. When doing a full generate it automatically
performs file-change checks and builds the desired compressed output files.</para>
- <para>Unless the <option>-h</option>, or <option>--help</option> option is given one of the
- commands below must be present.</para>
+ <para>Unless the <option>-h</option>, or <option>--help</option> option is given,
+ one of the commands below must be present.</para>
<variablelist>
<varlistentry><term><option>packages</option></term>
<varlistentry><term><option>release</option></term>
<listitem><para>
The <literal>release</literal> command generates a Release file from a
- directory tree. It recursively searches the given directory for uncompressed
- <filename>Packages</filename> and <filename>Sources</filename> files and the ones
- compressed with <command>gzip</command>, <command>bzip2</command> or <command>lzma</command>
- as well as <filename>Release</filename> and <filename>md5sum.txt</filename> files by default
- (<literal>APT::FTPArchive::Release::Default-Patterns</literal>). Additional filename patterns
- can be added by listing them in <literal>APT::FTPArchive::Release::Patterns</literal>.
- It then writes to stdout a Release file containing a MD5, SHA1 and SHA256 digest
- for each file.</para>
+ directory tree. It recursively searches the given directory for
+ uncompressed and compressed <filename>Packages</filename>,
+ <filename>Sources</filename>, <filename>Contents</filename>,
+ <filename>Components</filename> and <filename>icons</filename> files as
+ well as <filename>Release</filename>, <filename>Index</filename> and
+ <filename>md5sum.txt</filename> files by default
+ (<literal>APT::FTPArchive::Release::Default-Patterns</literal>).
+ Additional filename patterns can be added by listing them in
+ <literal>APT::FTPArchive::Release::Patterns</literal>. It then writes to
+ stdout a <filename>Release</filename> file containing (by default) an MD5,
+ SHA1, SHA256 and SHA512 digest for each file.</para>
<para>
Values for the additional metadata fields in the Release file are
taken from the corresponding variables under
<literal>APT::FTPArchive::Release</literal>,
- e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported fields
- are: <literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>,
+ e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported fields
+ are <literal>Origin</literal>, <literal>Label</literal>, <literal>Suite</literal>,
<literal>Version</literal>, <literal>Codename</literal>, <literal>Date</literal>,
- <literal>Valid-Until</literal>, <literal>Architectures</literal>,
- <literal>Components</literal>, <literal>Description</literal>.</para></listitem>
+ <literal>NotAutomatic</literal>, <literal>ButAutomaticUpgrades</literal>,
+ <literal>Acquire-By-Hash</literal>, <literal>Valid-Until</literal>,
+ <literal>Signed-By</literal>, <literal>Architectures</literal>,
+ <literal>Components</literal> and <literal>Description</literal>.</para></listitem>
</varlistentry>
tree manner. This only effects how the scope tag is handled.</para>
<para>
- The generate configuration has 4 separate sections, each described below.</para>
+ The generate configuration has four separate sections, each described below.</para>
- <refsect2><title>Dir Section</title>
+ <refsect2><title><literal>Dir</literal> Section</title>
<para>
The <literal>Dir</literal> section defines the standard directories needed to
locate the files required during the generation process. These
<varlistentry><term><option>CacheDir</option></term>
<listitem><para>
- Specifies the location of the cache files</para></listitem>
+ Specifies the location of the cache files.</para></listitem>
</varlistentry>
<varlistentry><term><option>FileListDir</option></term>
</variablelist>
</refsect2>
- <refsect2><title>Default Section</title>
+ <refsect2><title><literal>Default</literal> Section</title>
<para>
The <literal>Default</literal> section specifies default values, and settings
that control the operation of the generator. Other sections may override
<variablelist>
<varlistentry><term><option>Packages::Compress</option></term>
<listitem><para>
- Sets the default compression schemes to use
- for the Package index files. It is a string that contains a space
- separated list of at least one of: '.' (no compression), 'gzip' and
- 'bzip2'. The default for all compression schemes is '. gzip'.</para></listitem>
+ Sets the default compression schemes to use
+ for the package index files. It is a string that contains a space
+ separated list of at least one of the compressors configured via the
+ <option>APT::Compressor</option> configuration scope.
+ The default for all compression schemes is '. gzip'.</para></listitem>
</varlistentry>
<varlistentry><term><option>Packages::Extensions</option></term>
<varlistentry><term><option>LongDescription</option></term>
<listitem><para>
- Sets if long descriptions should be included in the Packages file or split
- out into a master Translation-en file.</para></listitem>
+ Specifies whether long descriptions should be included in the <filename>Packages</filename> file or split
+ out into a master <filename>Translation-en</filename> file.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
- <refsect2><title>TreeDefault Section</title>
+ <refsect2><title><literal>TreeDefault</literal> Section</title>
<para>
Sets defaults specific to <literal>Tree</literal> sections. All of these
variables are substitution variables and have the strings $(DIST),
<varlistentry><term><option>Translation</option></term>
<listitem><para>
- Set the output Translation-en master file with the long descriptions if they
+ Sets the output Translation-en master file with the long descriptions if they
should be not included in the Packages file. Defaults to
<filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename></para></listitem>
</varlistentry>
<varlistentry><term><option>Contents</option></term>
<listitem><para>
Sets the output Contents file. Defaults to
- <filename>$(DIST)/Contents-$(ARCH)</filename>. If this setting causes multiple
- Packages files to map onto a single Contents file (such as the default)
+ <filename>$(DIST)/$(SECTION)/Contents-$(ARCH)</filename>. If this setting causes multiple
+ Packages files to map onto a single Contents file (as is the default)
then <command>apt-ftparchive</command> will integrate those package files
together automatically.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
- <refsect2><title>Tree Section</title>
+ <refsect2><title><literal>Tree</literal> Section</title>
<para>
The <literal>Tree</literal> section defines a standard Debian file tree which
consists of a base directory, then multiple sections in that base
The <literal>Tree</literal> section takes a scope tag which sets the
<literal>$(DIST)</literal> variable and defines the root of the tree
(the path is prefixed by <literal>ArchiveDir</literal>).
- Typically this is a setting such as <filename>dists/&stable-codename;</filename>.</para>
+ Typically this is a setting such as <filename>dists/&debian-stable-codename;</filename>.</para>
<para>
All of the settings defined in the <literal>TreeDefault</literal> section can be
- use in a <literal>Tree</literal> section as well as three new variables.</para>
+ used in a <literal>Tree</literal> section as well as three new variables.</para>
<para>
When processing a <literal>Tree</literal> section <command>apt-ftparchive</command>
performs an operation similar to:
<varlistentry><term><option>Sections</option></term>
<listitem><para>
This is a space separated list of sections which appear
- under the distribution, typically this is something like
+ under the distribution; typically this is something like
<literal>main contrib non-free</literal></para></listitem>
</varlistentry>
<varlistentry><term><option>Architectures</option></term>
<listitem><para>
- This is a space separated list of all the
- architectures that appear under search section. The special architecture
- 'source' is used to indicate that this tree has a source archive.</para></listitem>
+ This is a space separated list of all the architectures that appear under
+ search section. The special architecture 'source' is used to indicate
+ that this tree has a source archive. The architecture 'all' signals that
+ architecture specific files like <filename>Packages</filename> should not
+ include information about architecture <literal>all</literal> packages in
+ all files as they will be available in a dedicated file.
+ </para></listitem>
</varlistentry>
<varlistentry><term><option>LongDescription</option></term>
<listitem><para>
- Sets if long descriptions should be included in the Packages file or split
- out into a master Translation-en file.</para></listitem>
+ Specifies whether long descriptions should be included in the <filename>Packages</filename> file or split
+ out into a master <filename>Translation-en</filename> file.</para></listitem>
</varlistentry>
<varlistentry><term><option>BinOverride</option></term>
</variablelist>
</refsect2>
- <refsect2><title>BinDirectory Section</title>
+ <refsect2><title><literal>BinDirectory</literal> Section</title>
<para>
The <literal>bindirectory</literal> section defines a binary directory tree
with no special structure. The scope tag specifies the location of
<varlistentry><term><option>Contents</option></term>
<listitem><para>
- Sets the Contents file output. (optional)</para></listitem>
+ Sets the Contents file output (optional).</para></listitem>
</varlistentry>
<varlistentry><term><option>BinOverride</option></term>
<refsect1><title>The Binary Override File</title>
<para>The binary override file is fully compatible with &dpkg-scanpackages;. It
- contains 4 fields separated by spaces. The first field is the package name,
- the second is the priority to force that package to, the third is the
+ contains four fields separated by spaces. The first field is the package name,
+ the second is the priority to force that package to, the third is
the section to force that package to and the final field is the maintainer
permutation field.</para>
<para>The general form of the maintainer field is:
<refsect1><title>The Source Override File</title>
<para>
The source override file is fully compatible with &dpkg-scansources;. It
- contains 2 fields separated by spaces. The first fields is the source
+ contains two fields separated by spaces. The first field is the source
package name, the second is the section to assign it.</para>
</refsect1>
<refsect1><title>The Extra Override File</title>
<para>
The extra override file allows any arbitrary tag to be added or replaced
- in the output. It has 3 columns, the first is the package, the second is
+ in the output. It has three columns, the first is the package, the second is
the tag and the remainder of the line is the new value.</para>
</refsect1>
&apt-cmdblurb;
<variablelist>
- <varlistentry><term><option>--md5</option></term><term><option>--sha1</option></term><term><option>--sha256</option></term>
+ <varlistentry>
+ <term><option>--md5</option></term>
+ <term><option>--sha1</option></term>
+ <term><option>--sha256</option></term>
+ <term><option>--sha512</option></term>
<listitem><para>
Generate the given checksum. These options default to on, when turned off the generated
index files will not have the checksum fields where possible.
<literal>APT::FTPArchive::<replaceable>Index</replaceable>::<replaceable>Checksum</replaceable></literal> where
<literal><replaceable>Index</replaceable></literal> can be <literal>Packages</literal>, <literal>Sources</literal> or
<literal>Release</literal> and <literal><replaceable>Checksum</replaceable></literal> can be <literal>MD5</literal>,
- <literal>SHA1</literal> or <literal>SHA256</literal>.</para></listitem>
+ <literal>SHA1</literal>, <literal>SHA256</literal> or <literal>SHA512</literal>.</para></listitem>
</varlistentry>
<varlistentry><term><option>-d</option></term><term><option>--db</option></term>
</varlistentry>
&apt-commonoptions;
-
+
</variablelist>
</refsect1>
projects / apt.git / blobdiff