From: Michael Vogt Date: Mon, 11 Jun 2012 12:56:11 +0000 (+0200) Subject: merged from donkult X-Git-Tag: 0.9.6~1 X-Git-Url: https://git.saurik.com/apt.git/commitdiff_plain/cb6a5776bfb5f74d94f32db55f2de148c27a5d10?ds=inline;hp=-c merged from donkult --- cb6a5776bfb5f74d94f32db55f2de148c27a5d10 diff --combined configure.in index 486b7a773,486b7a773..c1cdd3d5f --- a/configure.in +++ b/configure.in @@@ -18,7 -18,7 +18,7 @@@ AC_CONFIG_AUX_DIR(buildlib AC_CONFIG_HEADER(include/config.h:buildlib/config.h.in include/apti18n.h:buildlib/apti18n.h.in) PACKAGE="apt" --PACKAGE_VERSION="0.9.5.1" ++PACKAGE_VERSION="0.9.5.2~20120611" PACKAGE_MAIL="APT Development Team " AC_DEFINE_UNQUOTED(PACKAGE,"$PACKAGE") AC_DEFINE_UNQUOTED(PACKAGE_VERSION,"$PACKAGE_VERSION") diff --combined debian/changelog index 432032b1e,a89f78de9..f5a764185 --- a/debian/changelog +++ b/debian/changelog @@@ -1,18 -1,79 +1,83 @@@ apt (0.9.5.2) UNRELEASED; urgency=low - [ Translation of manpages ] - * Polish updated by Robert Luberda. Closes: #675603 - * French updated by Christian Perrier - - [ Translation of programs ] - * Danish by Joe Hansen. Closes: #675605 - * French updated by Christian Perrier - + [ David Kalnischkies ] + * apt-pkg/cdrom.cc: + - fix regression from 0.9.3 which dumped the main configuration + _config instead of the cdrom settings (Cnf) as identified and + tested by Milan Kupcevic, thanks! (Closes: #674100) + * cmdline/apt-get.cc: + - do not show 'list of broken packages' header if no package + is broken as it happens e.g. for external resolver errors + - print URIs for all changelogs in case of --print-uris, + thanks to Daniel Hartwig for the patch! (Closes: #674897) + - show 'bzr branch' as 'bzr get' is deprecated (LP: #1011032) + - check build-dep candidate if install is forbidden + * debian/apt-utils.links: + - the internal resolver 'apt' is now directly installed in + /usr/lib/apt/solvers, so don't instruct dh to create a broken link + * doc/apt-verbatim.ent: + - APT doesn't belong to the product 'Linux', so use 'APT' instead + as after all APT is a big suite of applications + * doc/examples/sources.list: + - use the codename instead of 'stable' in the examples sources.list + as we do in the manpage and as the debian-installer does + * doc/apt-get.8.xml: + - use apt-utils as package example instead of libc6 + * apt-pkg/contrib/cmdline.cc: + - apply patch from Daniel Hartwig to fix a segfault in case + the LongOpt is empty (Closes: #676331) + - fix segfault with empty LongOpt in --no-* branch + * ftparchive/apt-ftparchive.cc: + - default to putting the Contents-* files below $(SECTION) as apt-file + expects them there - thanks Martin-Éric Racine! (Closes: #675827) + * apt-pkg/deb/deblistparser.cc: + - set pkgCacheGen::Essential to "all" again (Closes: #675449) + * apt-pkg/algorithms.cc: + - force install only for one essential package out of a group + * apt-pkg/aptconfiguration.cc: + - if APT::Languages=none save "none" in allCodes so that the detected + configuration is cached as intended (Closes: #674690, LP: #1004947) + * apt-pkg/cacheiterators.h: + - add an IsMultiArchImplicit() method for Dep- and PrvIterator + + [ Justin B Rye ] + * doc/apt-cdrom.8.xml: + - replace CDROM with the proper CD-ROM in text + - correct disc vs. disk issues + * doc/apt-extracttemplates.1.xml: + - debconf is not DebConf + * doc/apt-get.8.xml: + - move dselect-upgrade below dist-upgrade + - review and fix spelling issues + * doc/apt-ftparchive.8.xml, doc/apt-config.8.xml, + doc/apt-key.8.xml, doc/apt-mark.8.xml, + doc/apt_preferences.5.xml, doc/apt-secure.8.xml, + doc/apt-sortpkgs.1.xml, sources.list.5.xml: + - review and fix typo, grammar and style issues + * doc/apt.conf.5.xml: + - review and fix typo, grammar and style issues + - rephrase APT::Immediate-Configuration and many others + + [ Sebastian Heinlein ] + * cmdline/apt-key: + - do not hardcode /etc but use Dir::Etc instead + - -- Christian Perrier Sat, 02 Jun 2012 18:25:18 +0200 + [ Robert Luberda ] + * Polish manpage translation update (Closes: #675603) + * doc/apt-mark.8.xml: + - in hold, the option name is --file not --filename + + [ Christian Perrier ] + * French program and manpage translation update + * Danish program translation by Joe Hansen. Closes: #675605 + + [ Thibaut Girka ] + * cmdline/apt-get.cc: + - complain correctly about :any build-dep on M-A:none packages + * apt-pkg/deb/deblistparser.cc: + - add support for arch-specific qualifiers in dependencies + + -- David Kalnischkies Wed, 06 Jun 2012 23:54:01 +0200 apt (0.9.5.1) unstable; urgency=low diff --combined doc/apt-verbatim.ent index ff37f4ae7,32ed2f678..9aec81e04 --- a/doc/apt-verbatim.ent +++ b/doc/apt-verbatim.ent @@@ -166,6 -166,12 +166,12 @@@ " > + + glob + 7 + " + > + @@@ -202,14 -208,25 +208,25 @@@ "> Linux + APT + &apt-product-version; "> + - ++ + - + + + + + + "> diff --combined doc/po/apt-doc.pot index a723feb8e,905bbb997..292b01971 --- a/doc/po/apt-doc.pot +++ b/doc/po/apt-doc.pot @@@ -8,7 -8,7 +8,7 @@@ msgid " msgstr "" "Project-Id-Version: apt-doc 0.9.5.1\n" "Report-Msgid-Bugs-To: APT Development Team \n" - "POT-Creation-Date: 2012-05-24 17:24+0300\n" -"POT-Creation-Date: 2012-06-09 23:05+0300\n" ++"POT-Creation-Date: 2012-06-11 14:45+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@@ -17,115 -17,6 +17,6 @@@ "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" - #. type: TH - #: apt.8:17 - #, no-wrap - msgid "apt" - msgstr "" - - #. type: TH - #: apt.8:17 - #, no-wrap - msgid "16 June 1998" - msgstr "" - - #. type: TH - #: apt.8:17 - #, no-wrap - msgid "Debian" - msgstr "" - - #. type: SH - #: apt.8:18 - #, no-wrap - msgid "NAME" - msgstr "" - - #. type: Plain text - #: apt.8:20 - msgid "apt - Advanced Package Tool" - msgstr "" - - #. type: SH - #: apt.8:20 - #, no-wrap - msgid "SYNOPSIS" - msgstr "" - - #. type: Plain text - #: apt.8:22 - msgid "B" - msgstr "" - - #. type: SH - #: apt.8:22 - #, no-wrap - msgid "DESCRIPTION" - msgstr "" - - #. type: Plain text - #: apt.8:31 - msgid "" - "APT is a management system for software packages. For normal day to day " - "package management there are several frontends available, such as " - "B(8) for the command line or B(8) for the X Window " - "System. Some options are only implemented in B(8) though." - msgstr "" - - #. type: SH - #: apt.8:31 - #, no-wrap - msgid "SEE ALSO" - msgstr "" - - #. type: Plain text - #: apt.8:38 - msgid "" - "B(8), B(8), B(5), B(5), " - "B(5), B(8)" - msgstr "" - - #. type: SH - #: apt.8:38 - #, no-wrap - msgid "DIAGNOSTICS" - msgstr "" - - #. type: Plain text - #: apt.8:40 - msgid "apt returns zero on normal operation, decimal 100 on error." - msgstr "" - - #. type: SH - #: apt.8:40 - #, no-wrap - msgid "BUGS" - msgstr "" - - #. type: Plain text - #: apt.8:42 - msgid "This manpage isn't even started." - msgstr "" - - #. type: Plain text - #: apt.8:51 - msgid "" - "See Ehttp://bugs.debian.org/aptE. If you wish to report a bug in " - "B, please see I or the " - "B(1) command." - msgstr "" - - #. type: SH - #: apt.8:51 - #, no-wrap - msgid "AUTHOR" - msgstr "" - - #. type: Plain text - #: apt.8:52 - msgid "apt was written by the APT team Eapt@packages.debian.orgE." - msgstr "" - #. type: Plain text #: apt.ent:7 #, no-wrap @@@ -606,5219 -497,5342 +497,5342 @@@ msgid " msgstr "" #. type: Content of: - #: apt-cache.8.xml:26 apt-cdrom.8.xml:25 apt-config.8.xml:26 apt-get.8.xml:26 apt-key.8.xml:25 apt-mark.8.xml:26 apt-secure.8.xml:25 + #: apt-get.8.xml:26 apt-cache.8.xml:26 apt-key.8.xml:25 apt-mark.8.xml:26 apt-secure.8.xml:25 apt-cdrom.8.xml:25 apt-config.8.xml:26 msgid "8" msgstr "" #. type: Content of: - #: apt-cache.8.xml:27 apt-cdrom.8.xml:26 apt-config.8.xml:27 apt-extracttemplates.1.xml:27 apt-ftparchive.1.xml:27 apt-get.8.xml:27 apt-key.8.xml:26 apt-mark.8.xml:27 apt-secure.8.xml:26 apt-sortpkgs.1.xml:27 apt.conf.5.xml:32 apt_preferences.5.xml:26 sources.list.5.xml:27 + #: apt-get.8.xml:27 apt-cache.8.xml:27 apt-key.8.xml:26 apt-mark.8.xml:27 apt-secure.8.xml:26 apt-cdrom.8.xml:26 apt-config.8.xml:27 apt.conf.5.xml:32 apt_preferences.5.xml:26 sources.list.5.xml:27 apt-extracttemplates.1.xml:27 apt-sortpkgs.1.xml:27 apt-ftparchive.1.xml:27 msgid "APT" msgstr "" #. type: Content of: - #: apt-cache.8.xml:33 - msgid "query the APT cache" + #: apt-get.8.xml:33 + msgid "APT package handling utility -- command-line interface" msgstr "" #. type: Content of: - #: apt-cache.8.xml:38 apt-cdrom.8.xml:37 apt-config.8.xml:38 apt-extracttemplates.1.xml:38 apt-ftparchive.1.xml:38 apt-get.8.xml:38 apt-key.8.xml:37 apt-mark.8.xml:38 apt-secure.8.xml:50 apt-sortpkgs.1.xml:38 apt.conf.5.xml:41 apt_preferences.5.xml:36 sources.list.5.xml:36 + #: apt-get.8.xml:38 apt-cache.8.xml:38 apt-key.8.xml:37 apt-mark.8.xml:38 apt-secure.8.xml:50 apt-cdrom.8.xml:37 apt-config.8.xml:38 apt.conf.5.xml:41 apt_preferences.5.xml:36 sources.list.5.xml:36 apt-extracttemplates.1.xml:38 apt-sortpkgs.1.xml:38 apt-ftparchive.1.xml:38 msgid "Description" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-cache.8.xml:39 + #: apt-get.8.xml:39 msgid "" - "<command>apt-cache</command> performs a variety of operations on APT's " - "package cache. <command>apt-cache</command> does not manipulate the state of " - "the system but does provide operations to search and generate interesting " - "output from the package metadata." + "<command>apt-get</command> is the command-line tool for handling packages, " + "and may be considered the user's \"back-end\" to other tools using the APT " + "library. Several \"front-end\" interfaces exist, such as &dselect;, " + "&aptitude;, &synaptic; and &wajig;." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-cache.8.xml:44 apt-cdrom.8.xml:51 apt-config.8.xml:44 apt-ftparchive.1.xml:54 apt-get.8.xml:44 + #: apt-get.8.xml:44 apt-cache.8.xml:44 apt-cdrom.8.xml:51 apt-config.8.xml:44 apt-ftparchive.1.xml:54 msgid "" "Unless the <option>-h</option>, or <option>--help</option> option is given, " "one of the commands below must be present." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:49 + #: apt-get.8.xml:49 msgid "" - "<literal>gencaches</literal> creates APT's package cache. This is done " - "implicitly by all commands needing this cache if it is missing or outdated." - msgstr "" - - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> - #: apt-cache.8.xml:53 apt-cache.8.xml:142 apt-cache.8.xml:163 apt-cache.8.xml:185 apt-cache.8.xml:190 apt-cache.8.xml:206 apt-cache.8.xml:224 apt-cache.8.xml:236 - msgid "&synopsis-pkg;" + "<literal>update</literal> is used to resynchronize the package index files " + "from their sources. The indexes of available packages are fetched from the " + "location(s) specified in <filename>/etc/apt/sources.list</filename>. For " + "example, when using a Debian archive, this command retrieves and scans the " + "<filename>Packages.gz</filename> files, so that information about new and " + "updated packages is available. An <literal>update</literal> should always be " + "performed before an <literal>upgrade</literal> or " + "<literal>dist-upgrade</literal>. Please be aware that the overall progress " + "meter will be incorrect as the size of the package files cannot be known in " + "advance." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:54 + #: apt-get.8.xml:61 msgid "" - "<literal>showpkg</literal> displays information about the packages listed on " - "the command line. Remaining arguments are package names. The available " - "versions and reverse dependencies of each package listed are listed, as well " - "as forward dependencies for each version. Forward (normal) dependencies are " - "those packages upon which the package in question depends; reverse " - "dependencies are those packages that depend upon the package in " - "question. Thus, forward dependencies must be satisfied for a package, but " - "reverse dependencies need not be. For instance, <command>apt-cache showpkg " - "libreadline2</command> would produce output similar to the following:" + "<literal>upgrade</literal> is used to install the newest versions of all " + "packages currently installed on the system from the sources enumerated in " + "<filename>/etc/apt/sources.list</filename>. Packages currently installed " + "with new versions available are retrieved and upgraded; under no " + "circumstances are currently installed packages removed, or packages not " + "already installed retrieved and installed. New versions of currently " + "installed packages that cannot be upgraded without changing the install " + "status of another package will be left at their current version. An " + "<literal>update</literal> must be performed first so that " + "<command>apt-get</command> knows that new versions of packages are " + "available." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting> - #: apt-cache.8.xml:66 - #, no-wrap + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:74 msgid "" - "Package: libreadline2\n" - "Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n" - "Reverse Depends: \n" - " libreadlineg2,libreadline2\n" - " libreadline2-altdev,libreadline2\n" - "Dependencies:\n" - "2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n" - "Provides:\n" - "2.1-12 - \n" - "Reverse Provides: \n" + "<literal>dist-upgrade</literal> in addition to performing the function of " + "<literal>upgrade</literal>, also intelligently handles changing dependencies " + "with new versions of packages; <command>apt-get</command> has a \"smart\" " + "conflict resolution system, and it will attempt to upgrade the most " + "important packages at the expense of less important ones if necessary. The " + "<literal>dist-upgrade</literal> command may therefore remove some packages. " + "The <filename>/etc/apt/sources.list</filename> file contains a list of " + "locations from which to retrieve desired package files. See also " + "&apt-preferences; for a mechanism for overriding the general settings for " + "individual packages." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:78 + #: apt-get.8.xml:87 msgid "" - "Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and " - "ncurses3.0 which must be installed for libreadline2 to work. In turn, " - "libreadlineg2 and libreadline2-altdev depend on libreadline2. If " - "libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be " - "installed; libreadlineg2 and libreadline2-altdev do not have to be " - "installed. For the specific meaning of the remainder of the output it is " - "best to consult the apt source code." + "<literal>dselect-upgrade</literal> is used in conjunction with the " + "traditional Debian packaging front-end, " + "&dselect;. <literal>dselect-upgrade</literal> follows the changes made by " + "&dselect; to the <literal>Status</literal> field of available packages, and " + "performs the actions necessary to realize that state (for instance, the " + "removal of old and the installation of new packages)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:87 + #: apt-get.8.xml:98 msgid "" - "<literal>stats</literal> displays some statistics about the cache. No " - "further arguments are expected. Statistics reported are:" + "<literal>install</literal> is followed by one or more packages desired for " + "installation or upgrading. Each package is a package name, not a fully " + "qualified filename (for instance, in a Debian system, " + "<package>apt-utils</package> would be the argument provided, not " + "<filename>apt-utils_&apt-product-version;_amd64.deb</filename>). All " + "packages required by the package(s) specified for installation will also be " + "retrieved and installed. The <filename>/etc/apt/sources.list</filename> " + "file is used to locate the desired packages. If a hyphen is appended to the " + "package name (with no intervening space), the identified package will be " + "removed if it is installed. Similarly a plus sign can be used to designate " + "a package to install. These latter features may be used to override " + "decisions made by apt-get's conflict resolution system." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:90 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:116 msgid "" - "<literal>Total package names</literal> is the number of package names found " - "in the cache." + "A specific version of a package can be selected for installation by " + "following the package name with an equals and the version of the package to " + "select. This will cause that version to be located and selected for " + "install. Alternatively a specific distribution can be selected by following " + "the package name with a slash and the version of the distribution or the " + "Archive name (stable, testing, unstable)." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:94 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:123 msgid "" - "<literal>Normal packages</literal> is the number of regular, ordinary " - "package names; these are packages that bear a one-to-one correspondence " - "between their names and the names used by other packages for them in " - "dependencies. The majority of packages fall into this category." + "Both of the version selection mechanisms can downgrade packages and must be " + "used with care." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:100 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:126 msgid "" - "<literal>Pure virtual packages</literal> is the number of packages that " - "exist only as a virtual package name; that is, packages only \"provide\" the " - "virtual package name, and no package actually uses the name. For instance, " - "\"mail-transport-agent\" in the Debian system is a pure virtual package; " - "several packages provide \"mail-transport-agent\", but there is no package " - "named \"mail-transport-agent\"." + "This is also the target to use if you want to upgrade one or more " + "already-installed packages without upgrading every package you have on your " + "system. Unlike the \"upgrade\" target, which installs the newest version of " + "all currently installed packages, \"install\" will install the newest " + "version of only the package(s) specified. Simply provide the name of the " + "package(s) you wish to upgrade, and if a newer version is available, it (and " + "its dependencies, as described above) will be downloaded and installed." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:108 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:137 msgid "" - "<literal>Single virtual packages</literal> is the number of packages with " - "only one package providing a particular virtual package. For example, in the " - "Debian system, \"X11-text-viewer\" is a virtual package, but only one " - "package, xless, provides \"X11-text-viewer\"." + "Finally, the &apt-preferences; mechanism allows you to create an alternative " + "installation policy for individual packages." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:114 - msgid "" - "<literal>Mixed virtual packages</literal> is the number of packages that " - "either provide a particular virtual package or have the virtual package name " - "as the package name. For instance, in the Debian system, \"debconf\" is both " - "an actual package, and provided by the debconf-tiny package." - msgstr "" - - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:121 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:141 msgid "" - "<literal>Missing</literal> is the number of package names that were " - "referenced in a dependency but were not provided by any package. Missing " - "packages may be an evidence if a full distribution is not accessed, or if a " - "package (real or virtual) has been dropped from the distribution. Usually " - "they are referenced from Conflicts or Breaks statements." + "If no package matches the given expression and the expression contains one " + "of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and " + "it is applied to all package names in the database. Any matches are then " + "installed (or removed). Note that matching is done by substring so 'lo.*' " + "matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular " + "expression with a '^' or '$' character, or create a more specific regular " + "expression." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:128 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:151 msgid "" - "<literal>Total distinct</literal> versions is the number of package versions " - "found in the cache; this value is therefore at least equal to the number of " - "total package names. If more than one distribution is being accessed (for " - "instance, \"stable\" and \"unstable\"), this value can be considerably " - "larger than the number of total package names." + "<literal>remove</literal> is identical to <literal>install</literal> except " + "that packages are removed instead of installed. Note that removing a package " + "leaves its configuration files on the system. If a plus sign is appended to " + "the package name (with no intervening space), the identified package will be " + "installed instead of removed." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> - #: apt-cache.8.xml:135 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:159 msgid "" - "<literal>Total dependencies</literal> is the number of dependency " - "relationships claimed by all of the packages in the cache." + "<literal>purge</literal> is identical to <literal>remove</literal> except " + "that packages are removed and purged (any configuration files are deleted " + "too)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:143 + #: apt-get.8.xml:164 msgid "" - "<literal>showsrc</literal> displays all the source package records that " - "match the given package names. All versions are shown, as well as all " - "records that declare the name to be a binary package." + "<literal>source</literal> causes <command>apt-get</command> to fetch source " + "packages. APT will examine the available packages to decide which source " + "package to fetch. It will then find and download into the current directory " + "the newest available version of that source package while respecting the " + "default release, set with the option " + "<literal>APT::Default-Release</literal>, the <option>-t</option> option or " + "per package with the <literal>pkg/release</literal> syntax, if possible." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:149 + #: apt-get.8.xml:172 msgid "" - "<literal>dump</literal> shows a short listing of every package in the " - "cache. It is primarily for debugging." + "Source packages are tracked separately from binary packages via " + "<literal>deb-src</literal> lines in the &sources-list; file. This means that " + "you will need to add such a line for each repository you want to get sources " + "from; otherwise you will probably get either the wrong (too old/too new) " + "source versions or none at all." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:154 + #: apt-get.8.xml:178 msgid "" - "<literal>dumpavail</literal> prints out an available list to stdout. This is " - "suitable for use with &dpkg; and is used by the &dselect; method." + "If the <option>--compile</option> option is specified then the package will " + "be compiled to a binary .deb using <command>dpkg-buildpackage</command> for " + "the architecture as defined by the <command>--host-architecture</command> " + "option. If <option>--download-only</option> is specified then the source " + "package will not be unpacked." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:159 + #: apt-get.8.xml:185 msgid "" - "<literal>unmet</literal> displays a summary of all unmet dependencies in the " - "package cache." + "A specific source version can be retrieved by postfixing the source name " + "with an equals and then the version to fetch, similar to the mechanism used " + "for the package files. This enables exact matching of the source package " + "name and version, implicitly enabling the " + "<literal>APT::Get::Only-Source</literal> option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:164 + #: apt-get.8.xml:191 msgid "" - "<literal>show</literal> performs a function similar to <command>dpkg " - "--print-avail</command>; it displays the package records for the named " - "packages." - msgstr "" - - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> - #: apt-cache.8.xml:169 - msgid "&synopsis-regex;" + "Note that source packages are not installed and tracked in the " + "<command>dpkg</command> database like binary packages; they are simply " + "downloaded to the current directory, like source tarballs." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:170 + #: apt-get.8.xml:197 msgid "" - "<literal>search</literal> performs a full text search on all available " - "package lists for the POSIX regex pattern given, see ®ex;. It searches " - "the package names and the descriptions for an occurrence of the regular " - "expression and prints out the package name and the short description, " - "including virtual package names. If <option>--full</option> is given then " - "output identical to <literal>show</literal> is produced for each matched " - "package, and if <option>--names-only</option> is given then the long " - "description is not searched, only the package name is." + "<literal>build-dep</literal> causes apt-get to install/remove packages in an " + "attempt to satisfy the build dependencies for a source package. By default " + "the dependencies are satisfied to build the package natively. If desired a " + "host-architecture can be specified with the " + "<option>--host-architecture</option> option instead." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:181 + #: apt-get.8.xml:204 msgid "" - "Separate arguments can be used to specify multiple search patterns that are " - "and'ed together." + "<literal>check</literal> is a diagnostic tool; it updates the package cache " + "and checks for broken dependencies." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:186 + #: apt-get.8.xml:209 msgid "" - "<literal>depends</literal> shows a listing of each dependency a package has " - "and all the possible other packages that can fulfill that dependency." + "<literal>download</literal> will download the given binary package into the " + "current directory." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:191 + #: apt-get.8.xml:215 msgid "" - "<literal>rdepends</literal> shows a listing of each reverse dependency a " - "package has." - msgstr "" - - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> - #: apt-cache.8.xml:195 - msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>" + "<literal>clean</literal> clears out the local repository of retrieved " + "package files. It removes everything but the lock file from " + "<filename>&cachedir;/archives/</filename> and " + "<filename>&cachedir;/archives/partial/</filename>. When APT is used as a " + "&dselect; method, <literal>clean</literal> is run automatically. Those who " + "do not use dselect will likely want to run <literal>apt-get clean</literal> " + "from time to time to free up disk space." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:196 + #: apt-get.8.xml:225 msgid "" - "This command prints the name of each package APT knows. The optional " - "argument is a prefix match to filter the name list. The output is suitable " - "for use in a shell tab complete function and the output is generated " - "extremely quickly. This command is best used with the " - "<option>--generate</option> option." + "Like <literal>clean</literal>, <literal>autoclean</literal> clears out the " + "local repository of retrieved package files. The difference is that it only " + "removes package files that can no longer be downloaded, and are largely " + "useless. This allows a cache to be maintained over a long period without it " + "growing out of control. The configuration option " + "<literal>APT::Clean-Installed</literal> will prevent installed packages from " + "being erased if it is set to off." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:201 + #: apt-get.8.xml:235 msgid "" - "Note that a package which APT knows of is not necessarily available to " - "download, installable or installed, e.g. virtual packages are also listed in " - "the generated list." + "<literal>autoremove</literal> is used to remove packages that were " + "automatically installed to satisfy dependencies for other packages and are " + "now no longer needed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:207 + #: apt-get.8.xml:240 msgid "" - "<literal>dotty</literal> takes a list of packages on the command line and " - "generates output suitable for use by dotty from the <ulink " - "url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> " - "package. The result will be a set of nodes and edges representing the " - "relationships between the packages. By default the given packages will trace " - "out all dependent packages; this can produce a very large graph. To limit " - "the output to only the packages listed on the command line, set the " - "<literal>APT::Cache::GivenOnly</literal> option." + "<literal>changelog</literal> downloads a package changelog and displays it " + "through <command>sensible-pager</command>. The server name and base " + "directory is defined in the <literal>APT::Changelogs::Server</literal> " + "variable (e.g. <ulink " + "url=\"http://packages.debian.org/changelogs\">packages.debian.org/changelogs</ulink> " + "for Debian or <ulink " + "url=\"http://changelogs.ubuntu.com/changelogs\">changelogs.ubuntu.com/changelogs</ulink> " + "for Ubuntu). By default it displays the changelog for the version that is " + "installed. However, you can specify the same options as for the " + "<option>install</option> command." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:216 - msgid "" - "The resulting nodes will have several shapes; normal packages are boxes, " - "pure virtual packages are triangles, mixed virtual packages are diamonds, " - "missing packages are hexagons. Orange boxes mean recursion was stopped (leaf " - "packages), blue lines are pre-depends, green lines are conflicts." + #. type: Content of: <refentry><refsect1><title> + #: apt-get.8.xml:258 apt-cache.8.xml:248 apt-mark.8.xml:108 apt-config.8.xml:84 apt-extracttemplates.1.xml:52 apt-sortpkgs.1.xml:48 apt-ftparchive.1.xml:504 + msgid "options" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:221 - msgid "Caution, dotty cannot graph larger sets of packages." + #: apt-get.8.xml:263 + msgid "" + "Do not consider recommended packages as a dependency for installing. " + "Configuration Item: <literal>APT::Install-Recommends</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:225 + #: apt-get.8.xml:268 msgid "" - "The same as <literal>dotty</literal>, only for xvcg from the <ulink " - "url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG " - "tool</ulink>." + "Consider suggested packages as a dependency for installing. Configuration " + "Item: <literal>APT::Install-Suggests</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> - #: apt-cache.8.xml:229 - msgid "<optional><replaceable>&synopsis-pkg;</replaceable>…</optional>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:273 + msgid "" + "Download only; package files are only retrieved, not unpacked or installed. " + "Configuration Item: <literal>APT::Get::Download-Only</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:230 + #: apt-get.8.xml:278 msgid "" - "<literal>policy</literal> is meant to help debug issues relating to the " - "preferences file. With no arguments it will print out the priorities of each " - "source. Otherwise it prints out detailed information about the priority " - "selection of the named package." + "Fix; attempt to correct a system with broken dependencies in place. This " + "option, when used with install/remove, can omit any packages to permit APT " + "to deduce a likely solution. If packages are specified, these have to " + "completely correct the problem. The option is sometimes necessary when " + "running APT for the first time; APT itself does not allow broken package " + "dependencies to exist on a system. It is possible that a system's dependency " + "structure can be so corrupt as to require manual intervention (which usually " + "means using &dselect; or <command>dpkg --remove</command> to eliminate some " + "of the offending packages). Use of this option together with " + "<option>-m</option> may produce an error in some situations. Configuration " + "Item: <literal>APT::Get::Fix-Broken</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:237 + #: apt-get.8.xml:293 msgid "" - "<literal>apt-cache</literal>'s <literal>madison</literal> command attempts " - "to mimic the output format and a subset of the functionality of the Debian " - "archive management tool, <literal>madison</literal>. It displays available " - "versions of a package in a tabular format. Unlike the original " - "<literal>madison</literal>, it can only display information for the " - "architecture for which APT has retrieved package lists " - "(<literal>APT::Architecture</literal>)." + "Ignore missing packages; if packages cannot be retrieved or fail the " + "integrity check after retrieval (corrupted package files), hold back those " + "packages and handle the result. Use of this option together with " + "<option>-f</option> may produce an error in some situations. If a package is " + "selected for installation (particularly if it is mentioned on the command " + "line) and it could not be downloaded then it will be silently held back. " + "Configuration Item: <literal>APT::Get::Fix-Missing</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-cache.8.xml:248 apt-config.8.xml:84 apt-extracttemplates.1.xml:52 apt-ftparchive.1.xml:504 apt-get.8.xml:259 apt-mark.8.xml:108 apt-sortpkgs.1.xml:48 - msgid "options" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:304 + msgid "" + "Disables downloading of packages. This is best used with " + "<option>--ignore-missing</option> to force APT to use only the .debs it has " + "already downloaded. Configuration Item: " + "<literal>APT::Get::Download</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:253 + #: apt-get.8.xml:311 msgid "" - "Select the file to store the package cache. The package cache is the primary " - "cache used by all operations. Configuration Item: " - "<literal>Dir::Cache::pkgcache</literal>." + "Quiet; produces output suitable for logging, omitting progress indicators. " + "More q's will produce more quiet up to a maximum of 2. You can also use " + "<option>-q=#</option> to set the quiet level, overriding the configuration " + "file. Note that quiet level 2 implies <option>-y</option>; you should never " + "use -qq without a no-action modifier such as -d, --print-uris or -s as APT " + "may decide to do something you did not expect. Configuration Item: " + "<literal>quiet</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:259 + #: apt-get.8.xml:326 msgid "" - "Select the file to store the source cache. The source is used only by " - "<literal>gencaches</literal> and it stores a parsed version of the package " - "information from remote sources. When building the package cache the source " - "cache is used to avoid reparsing all of the package files. Configuration " - "Item: <literal>Dir::Cache::srcpkgcache</literal>." + "No action; perform a simulation of events that would occur but do not " + "actually change the system. Configuration Item: " + "<literal>APT::Get::Simulate</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:267 + #: apt-get.8.xml:330 msgid "" - "Quiet; produces output suitable for logging, omitting progress indicators. " - "More q's will produce more quietness up to a maximum of 2. You can also use " - "<option>-q=#</option> to set the quietness level, overriding the " - "configuration file. Configuration Item: <literal>quiet</literal>." + "Simulated runs performed as a user will automatically deactivate locking " + "(<literal>Debug::NoLocking</literal>), and if the option " + "<literal>APT::Get::Show-User-Simulation-Note</literal> is set (as it is by " + "default) a notice will also be displayed indicating that this is only a " + "simulation. Runs performed as root do not trigger either NoLocking or the " + "notice - superusers should know what they are doing without further warnings " + "from <literal>apt-get</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:274 + #: apt-get.8.xml:338 msgid "" - "Print only important dependencies; for use with <literal>unmet</literal> and " - "<literal>depends</literal>. Causes only Depends and Pre-Depends relations to " - "be printed. Configuration Item: <literal>APT::Cache::Important</literal>." + "Simulated runs print out a series of lines, each representing a " + "<command>dpkg</command> operation: configure (<literal>Conf</literal>), " + "remove (<literal>Remv</literal>) or unpack " + "(<literal>Inst</literal>). Square brackets indicate broken packages, and " + "empty square brackets indicate breaks that are of no consequence (rare)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:288 + #: apt-get.8.xml:346 msgid "" - "Per default the <literal>depends</literal> and <literal>rdepends</literal> " - "print all dependencies. This can be tweaked with these flags which will omit " - "the specified dependency type. Configuration Item: " - "<literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> " - "e.g. <literal>APT::Cache::ShowRecommends</literal>." + "Automatic yes to prompts; assume \"yes\" as answer to all prompts and run " + "non-interactively. If an undesirable situation, such as changing a held " + "package, trying to install a unauthenticated package or removing an " + "essential package occurs then <literal>apt-get</literal> will abort. " + "Configuration Item: <literal>APT::Get::Assume-Yes</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:295 + #: apt-get.8.xml:354 msgid "" - "Print full package records when searching. Configuration Item: " - "<literal>APT::Cache::ShowFull</literal>." + "Automatic \"no\" to all prompts. Configuration Item: " + "<literal>APT::Get::Assume-No</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:300 + #: apt-get.8.xml:359 msgid "" - "Print full records for all available versions. This is the default; to turn " - "it off, use <option>--no-all-versions</option>. If " - "<option>--no-all-versions</option> is specified, only the candidate version " - "will be displayed (the one which would be selected for installation). This " - "option is only applicable to the <literal>show</literal> command. " - "Configuration Item: <literal>APT::Cache::AllVersions</literal>." + "Show upgraded packages; print out a list of all packages that are to be " + "upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:309 + #: apt-get.8.xml:365 msgid "" - "Perform automatic package cache regeneration, rather than use the cache as " - "it is. This is the default; to turn it off, use " - "<option>--no-generate</option>. Configuration Item: " - "<literal>APT::Cache::Generate</literal>." + "Show full versions for upgraded and installed packages. Configuration Item: " + "<literal>APT::Get::Show-Versions</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:315 + #: apt-get.8.xml:371 msgid "" - "Only search on the package names, not the long descriptions. Configuration " - "Item: <literal>APT::Cache::NamesOnly</literal>." + "This option controls the architecture packages are built for by " + "<command>apt-get source --compile</command> and how cross-builddependencies " + "are satisfied. By default is it not set which means that the host " + "architecture is the same as the build architecture (which is defined by " + "<literal>APT::Architecture</literal>). Configuration Item: " + "<literal>APT::Get::Host-Architecture</literal>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:320 + #: apt-get.8.xml:381 msgid "" - "Make <literal>pkgnames</literal> print all names, including virtual packages " - "and missing dependencies. Configuration Item: " - "<literal>APT::Cache::AllNames</literal>." + "Compile source packages after downloading them. Configuration Item: " + "<literal>APT::Get::Compile</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:326 + #: apt-get.8.xml:386 msgid "" - "Make <literal>depends</literal> and <literal>rdepends</literal> recursive so " - "that all packages mentioned are printed once. Configuration Item: " - "<literal>APT::Cache::RecurseDepends</literal>." + "Ignore package holds; this causes <command>apt-get</command> to ignore a " + "hold placed on a package. This may be useful in conjunction with " + "<literal>dist-upgrade</literal> to override a large number of undesired " + "holds. Configuration Item: <literal>APT::Ignore-Hold</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cache.8.xml:333 + #: apt-get.8.xml:393 msgid "" - "Limit the output of <literal>depends</literal> and " - "<literal>rdepends</literal> to packages which are currently installed. " - "Configuration Item: <literal>APT::Cache::Installed</literal>." - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt-cache.8.xml:343 apt-get.8.xml:519 apt-key.8.xml:174 apt-mark.8.xml:125 apt.conf.5.xml:1118 apt_preferences.5.xml:698 - msgid "Files" - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt-cache.8.xml:350 apt-cdrom.8.xml:144 apt-config.8.xml:109 apt-extracttemplates.1.xml:70 apt-ftparchive.1.xml:607 apt-get.8.xml:529 apt-key.8.xml:195 apt-mark.8.xml:131 apt-secure.8.xml:192 apt-sortpkgs.1.xml:63 apt.conf.5.xml:1124 apt_preferences.5.xml:705 sources.list.5.xml:252 - msgid "See Also" - msgstr "" - - #. type: Content of: <refentry><refsect1><para> - #: apt-cache.8.xml:351 - msgid "&apt-conf;, &sources-list;, &apt-get;" - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt-cache.8.xml:355 apt-cdrom.8.xml:149 apt-config.8.xml:114 apt-extracttemplates.1.xml:74 apt-ftparchive.1.xml:611 apt-get.8.xml:535 apt-mark.8.xml:135 apt-sortpkgs.1.xml:67 - msgid "Diagnostics" + "Do not upgrade packages; when used in conjunction with " + "<literal>install</literal>, <literal>no-upgrade</literal> will prevent " + "packages on the command line from being upgraded if they are already " + "installed. Configuration Item: <literal>APT::Get::Upgrade</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-cache.8.xml:356 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:400 msgid "" - "<command>apt-cache</command> returns zero on normal operation, decimal 100 " - "on error." + "Do not install new packages; when used in conjunction with " + "<literal>install</literal>, <literal>only-upgrade</literal> will install " + "upgrades for already installed packages only and ignore requests to install " + "new packages. Configuration Item: " + "<literal>APT::Get::Only-Upgrade</literal>." msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-cdrom.8.xml:32 - msgid "APT CDROM management utility" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:408 + msgid "" + "Force yes; this is a dangerous option that will cause apt to continue " + "without prompting if it is doing something potentially harmful. It should " + "not be used except in very special situations. Using " + "<literal>force-yes</literal> can potentially destroy your system! " + "Configuration Item: <literal>APT::Get::force-yes</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-cdrom.8.xml:38 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:416 msgid "" - "<command>apt-cdrom</command> is used to add a new CDROM to APTs list of " - "available sources. <command>apt-cdrom</command> takes care of determining " - "the structure of the disc as well as correcting for several possible " - "mis-burns and verifying the index files." + "Instead of fetching the files to install their URIs are printed. Each URI " + "will have the path, the destination file name, the size and the expected MD5 " + "hash. Note that the file name to write to will not always match the file " + "name on the remote site! This also works with the <literal>source</literal> " + "and <literal>update</literal> commands. When used with the " + "<literal>update</literal> command the MD5 and size are not included, and it " + "is up to the user to decompress any compressed files. Configuration Item: " + "<literal>APT::Get::Print-URIs</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-cdrom.8.xml:45 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:427 msgid "" - "It is necessary to use <command>apt-cdrom</command> to add CDs to the APT " - "system, it cannot be done by hand. Furthermore each disk in a multi-cd set " - "must be inserted and scanned separately to account for possible mis-burns." + "Use purge instead of remove for anything that would be removed. An asterisk " + "(\"*\") will be displayed next to packages which are scheduled to be " + "purged. <option>remove --purge</option> is equivalent to the " + "<option>purge</option> command. Configuration Item: " + "<literal>APT::Get::Purge</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:56 + #: apt-get.8.xml:435 msgid "" - "<literal>add</literal> is used to add a new disc to the source list. It will " - "unmount the CDROM device, prompt for a disk to be inserted and then proceed " - "to scan it and copy the index files. If the disc does not have a proper " - "<filename>disk</filename> directory you will be prompted for a descriptive " - "title." + "Re-install packages that are already installed and at the newest version. " + "Configuration Item: <literal>APT::Get::ReInstall</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:64 + #: apt-get.8.xml:440 msgid "" - "APT uses a CDROM ID to track which disc is currently in the drive and " - "maintains a database of these IDs in " - "<filename>&statedir;/cdroms.list</filename>" + "This option is on by default; use <literal>--no-list-cleanup</literal> to " + "turn it off. When it is on, <command>apt-get</command> will automatically " + "manage the contents of <filename>&statedir;/lists</filename> to ensure that " + "obsolete files are erased. The only reason to turn it off is if you " + "frequently change your sources list. Configuration Item: " + "<literal>APT::Get::List-Cleanup</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:72 + #: apt-get.8.xml:450 msgid "" - "A debugging tool to report the identity of the current disc as well as the " - "stored file name" + "This option controls the default input to the policy engine; it creates a " + "default pin at priority 990 using the specified release string. This " + "overrides the general settings in " + "<filename>/etc/apt/preferences</filename>. Specifically pinned packages are " + "not affected by the value of this option. In short, this option lets you " + "have simple control over which distribution packages will be retrieved " + "from. Some common examples might be <option>-t '2.1*'</option>, <option>-t " + "unstable</option> or <option>-t sid</option>. Configuration Item: " + "<literal>APT::Default-Release</literal>; see also the &apt-preferences; " + "manual page." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-cdrom.8.xml:80 apt-key.8.xml:160 - msgid "Options" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-get.8.xml:465 + msgid "" + "Only perform operations that are 'trivial'. Logically this can be considered " + "related to <option>--assume-yes</option>; where " + "<option>--assume-yes</option> will answer yes to any prompt, " + "<option>--trivial-only</option> will answer no. Configuration Item: " + "<literal>APT::Get::Trivial-Only</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:85 + #: apt-get.8.xml:472 msgid "" - "Mount point; specify the location to mount the cdrom. This mount point must " - "be listed in <filename>/etc/fstab</filename> and properly configured. " - "Configuration Item: <literal>Acquire::cdrom::mount</literal>." + "If any packages are to be removed apt-get immediately aborts without " + "prompting. Configuration Item: <literal>APT::Get::Remove</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:94 + #: apt-get.8.xml:478 msgid "" - "Rename a disc; change the label of a disk or override the disks given " - "label. This option will cause <command>apt-cdrom</command> to prompt for a " - "new label. Configuration Item: <literal>APT::CDROM::Rename</literal>." + "If the command is either <literal>install</literal> or " + "<literal>remove</literal>, then this option acts like running the " + "<literal>autoremove</literal> command, removing unused dependency " + "packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:103 + #: apt-get.8.xml:485 msgid "" - "No mounting; prevent <command>apt-cdrom</command> from mounting and " - "unmounting the mount point. Configuration Item: " - "<literal>APT::CDROM::NoMount</literal>." + "Only has meaning for the <literal>source</literal> and " + "<literal>build-dep</literal> commands. Indicates that the given source " + "names are not to be mapped through the binary table. This means that if " + "this option is specified, these commands will only accept source package " + "names as arguments, rather than accepting binary package names and looking " + "up the corresponding source package. Configuration Item: " + "<literal>APT::Get::Only-Source</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:111 + #: apt-get.8.xml:496 msgid "" - "Fast Copy; Assume the package files are valid and do not check every " - "package. This option should be used only if <command>apt-cdrom</command> has " - "been run on this disc before and did not detect any errors. Configuration " - "Item: <literal>APT::CDROM::Fast</literal>." + "Download only the diff, dsc, or tar file of a source archive. Configuration " + "Item: <literal>APT::Get::Diff-Only</literal>, " + "<literal>APT::Get::Dsc-Only</literal>, and " + "<literal>APT::Get::Tar-Only</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:121 + #: apt-get.8.xml:502 msgid "" - "Thorough Package Scan; This option may be needed with some old Debian " - "1.1/1.2 discs that have Package files in strange places. It takes much " - "longer to scan the CD but will pick them all up." + "Only process architecture-dependent build-dependencies. Configuration Item: " + "<literal>APT::Get::Arch-Only</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-cdrom.8.xml:132 + #: apt-get.8.xml:507 msgid "" - "No Changes; Do not change the &sources-list; file and do not write index " - "files. Everything is still checked however. Configuration Item: " - "<literal>APT::CDROM::NoAct</literal>." + "Ignore if packages can't be authenticated and don't prompt about it. This " + "is useful for tools like pbuilder. Configuration Item: " + "<literal>APT::Get::AllowUnauthenticated</literal>." + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt-get.8.xml:518 apt-cache.8.xml:343 apt-key.8.xml:174 apt-mark.8.xml:125 apt.conf.5.xml:1156 apt_preferences.5.xml:698 + msgid "Files" + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt-get.8.xml:528 apt-cache.8.xml:350 apt-key.8.xml:195 apt-mark.8.xml:131 apt-secure.8.xml:191 apt-cdrom.8.xml:144 apt-config.8.xml:109 apt.conf.5.xml:1162 apt_preferences.5.xml:705 sources.list.5.xml:252 apt-extracttemplates.1.xml:70 apt-sortpkgs.1.xml:63 apt-ftparchive.1.xml:607 + msgid "See Also" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-cdrom.8.xml:145 - msgid "&apt-conf;, &apt-get;, &sources-list;" + #: apt-get.8.xml:529 + msgid "" + "&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, " + "&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, " + "&apt-preferences;, the APT Howto." + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt-get.8.xml:534 apt-cache.8.xml:355 apt-mark.8.xml:135 apt-cdrom.8.xml:149 apt-config.8.xml:114 apt-extracttemplates.1.xml:74 apt-sortpkgs.1.xml:67 apt-ftparchive.1.xml:611 + msgid "Diagnostics" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-cdrom.8.xml:150 + #: apt-get.8.xml:535 msgid "" - "<command>apt-cdrom</command> returns zero on normal operation, decimal 100 " - "on error." + "<command>apt-get</command> returns zero on normal operation, decimal 100 on " + "error." msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-config.8.xml:33 - msgid "APT Configuration Query program" + #: apt-cache.8.xml:33 + msgid "query the APT cache" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-config.8.xml:39 + #: apt-cache.8.xml:39 msgid "" - "<command>apt-config</command> is an internal program used by various " - "portions of the APT suite to provide consistent configurability. It accesses " - "the main configuration file <filename>/etc/apt/apt.conf</filename> in a " - "manner that is easy to use by scripted applications." + "<command>apt-cache</command> performs a variety of operations on APT's " + "package cache. <command>apt-cache</command> does not manipulate the state of " + "the system but does provide operations to search and generate interesting " + "output from the package metadata." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-config.8.xml:51 + #: apt-cache.8.xml:49 msgid "" - "shell is used to access the configuration information from a shell " - "script. It is given pairs of arguments, the first being a shell variable and " - "the second the configuration value to query. As output it lists a series of " - "shell assignments commands for each present value. In a shell script it " - "should be used like:" + "<literal>gencaches</literal> creates APT's package cache. This is done " + "implicitly by all commands needing this cache if it is missing or outdated." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting> - #: apt-config.8.xml:59 - #, no-wrap - msgid "" - "OPTS=\"-f\"\n" - "RES=`apt-config shell OPTS MyApp::options`\n" - "eval $RES\n" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> + #: apt-cache.8.xml:53 apt-cache.8.xml:142 apt-cache.8.xml:163 apt-cache.8.xml:185 apt-cache.8.xml:190 apt-cache.8.xml:206 apt-cache.8.xml:224 apt-cache.8.xml:236 + msgid "&synopsis-pkg;" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-config.8.xml:64 + #: apt-cache.8.xml:54 msgid "" - "This will set the shell environment variable $OPTS to the value of " - "MyApp::options with a default of <option>-f</option>." + "<literal>showpkg</literal> displays information about the packages listed on " + "the command line. Remaining arguments are package names. The available " + "versions and reverse dependencies of each package listed are listed, as well " + "as forward dependencies for each version. Forward (normal) dependencies are " + "those packages upon which the package in question depends; reverse " + "dependencies are those packages that depend upon the package in " + "question. Thus, forward dependencies must be satisfied for a package, but " + "reverse dependencies need not be. For instance, <command>apt-cache showpkg " + "libreadline2</command> would produce output similar to the following:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-config.8.xml:68 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting> + #: apt-cache.8.xml:66 + #, no-wrap msgid "" - "The configuration item may be postfixed with a /[fdbi]. f returns file " - "names, d returns directories, b returns true or false and i returns an " - "integer. Each of the returns is normalized and verified internally." + "Package: libreadline2\n" + "Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n" + "Reverse Depends: \n" + " libreadlineg2,libreadline2\n" + " libreadline2-altdev,libreadline2\n" + "Dependencies:\n" + "2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n" + "Provides:\n" + "2.1-12 - \n" + "Reverse Provides: \n" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-config.8.xml:77 - msgid "Just show the contents of the configuration space." + #: apt-cache.8.xml:78 + msgid "" + "Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and " + "ncurses3.0 which must be installed for libreadline2 to work. In turn, " + "libreadlineg2 and libreadline2-altdev depend on libreadline2. If " + "libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be " + "installed; libreadlineg2 and libreadline2-altdev do not have to be " + "installed. For the specific meaning of the remainder of the output it is " + "best to consult the apt source code." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-config.8.xml:90 + #: apt-cache.8.xml:87 msgid "" - "Include options which have an empty value. This is the default, so use " - "--no-empty to remove them from the output." - msgstr "" - - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> - #: apt-config.8.xml:95 - msgid "%f "%v";%n" + "<literal>stats</literal> displays some statistics about the cache. No " + "further arguments are expected. Statistics reported are:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-config.8.xml:96 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:90 msgid "" - "Defines the output of each config option. %t will be replaced with " - "the name of the option, %f with the complete optionname and %v " - "with the value of the option. Use uppercase letters and special characters " - "in the value will be encoded to ensure that it can e.g. be savely used in a " - "quoted-string as defined by RFC822. Additionally %n will be replaced " - "by a newline, %N by a tab. A % can be printed by using " - "%%." + "<literal>Total package names</literal> is the number of package names found " + "in the cache." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-config.8.xml:110 apt-extracttemplates.1.xml:71 apt-ftparchive.1.xml:608 apt-sortpkgs.1.xml:64 - msgid "&apt-conf;" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:94 + msgid "" + "<literal>Normal packages</literal> is the number of regular, ordinary " + "package names; these are packages that bear a one-to-one correspondence " + "between their names and the names used by other packages for them in " + "dependencies. The majority of packages fall into this category." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-config.8.xml:115 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:100 msgid "" - "<command>apt-config</command> returns zero on normal operation, decimal 100 " - "on error." + "<literal>Pure virtual packages</literal> is the number of packages that " + "exist only as a virtual package name; that is, packages only \"provide\" the " + "virtual package name, and no package actually uses the name. For instance, " + "\"mail-transport-agent\" in the Debian system is a pure virtual package; " + "several packages provide \"mail-transport-agent\", but there is no package " + "named \"mail-transport-agent\"." msgstr "" - #. type: Content of: <refentry><refmeta><manvolnum> - #: apt-extracttemplates.1.xml:26 apt-ftparchive.1.xml:26 apt-sortpkgs.1.xml:26 - msgid "1" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:108 + msgid "" + "<literal>Single virtual packages</literal> is the number of packages with " + "only one package providing a particular virtual package. For example, in the " + "Debian system, \"X11-text-viewer\" is a virtual package, but only one " + "package, xless, provides \"X11-text-viewer\"." msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-extracttemplates.1.xml:33 - msgid "Utility to extract DebConf config and templates from Debian packages" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:114 + msgid "" + "<literal>Mixed virtual packages</literal> is the number of packages that " + "either provide a particular virtual package or have the virtual package name " + "as the package name. For instance, in the Debian system, \"debconf\" is both " + "an actual package, and provided by the debconf-tiny package." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-extracttemplates.1.xml:39 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:121 msgid "" - "<command>apt-extracttemplates</command> will take one or more Debian package " - "files as input and write out (to a temporary directory) all associated " - "config scripts and template files. For each passed in package that contains " - "config scripts and templates, one line of output will be generated in the " - "format:" + "<literal>Missing</literal> is the number of package names that were " + "referenced in a dependency but were not provided by any package. Missing " + "packages may be an evidence if a full distribution is not accessed, or if a " + "package (real or virtual) has been dropped from the distribution. Usually " + "they are referenced from Conflicts or Breaks statements." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-extracttemplates.1.xml:44 - msgid "package version template-file config-script" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:128 + msgid "" + "<literal>Total distinct</literal> versions is the number of package versions " + "found in the cache; this value is therefore at least equal to the number of " + "total package names. If more than one distribution is being accessed (for " + "instance, \"stable\" and \"unstable\"), this value can be considerably " + "larger than the number of total package names." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-extracttemplates.1.xml:45 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para> + #: apt-cache.8.xml:135 msgid "" - "template-file and config-script are written to the temporary directory " - "specified by the <option>-t</option> or <option>--tempdir</option> " - "(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with " - "filenames of the form <filename>package.template.XXXX</filename> and " - "<filename>package.config.XXXX</filename>" + "<literal>Total dependencies</literal> is the number of dependency " + "relationships claimed by all of the packages in the cache." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-extracttemplates.1.xml:58 + #: apt-cache.8.xml:143 msgid "" - "Temporary directory in which to write extracted debconf template files and " - "config scripts. Configuration Item: " - "<literal>APT::ExtractTemplates::TempDir</literal>" + "<literal>showsrc</literal> displays all the source package records that " + "match the given package names. All versions are shown, as well as all " + "records that declare the name to be a binary package." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-extracttemplates.1.xml:75 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:149 msgid "" - "<command>apt-extracttemplates</command> returns zero on normal operation, " - "decimal 100 on error." + "<literal>dump</literal> shows a short listing of every package in the " + "cache. It is primarily for debugging." msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-ftparchive.1.xml:33 - msgid "Utility to generate index files" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:154 + msgid "" + "<literal>dumpavail</literal> prints out an available list to stdout. This is " + "suitable for use with &dpkg; and is used by the &dselect; method." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:39 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:159 msgid "" - "<command>apt-ftparchive</command> is the command line tool that generates " - "the index files that APT uses to access a distribution source. The index " - "files should be generated on the origin site based on the content of that " - "site." + "<literal>unmet</literal> displays a summary of all unmet dependencies in the " + "package cache." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:43 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:164 msgid "" - "<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; " - "program, incorporating its entire functionality via the " - "<literal>packages</literal> command. It also contains a contents file " - "generator, <literal>contents</literal>, and an elaborate means to 'script' " - "the generation process for a complete archive." + "<literal>show</literal> performs a function similar to <command>dpkg " + "--print-avail</command>; it displays the package records for the named " + "packages." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:49 - msgid "" - "Internally <command>apt-ftparchive</command> can make use of binary " - "databases to cache the contents of a .deb file and it does not rely on any " - "external programs aside from &gzip;. When doing a full generate it " - "automatically performs file-change checks and builds the desired compressed " - "output files." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> + #: apt-cache.8.xml:169 + msgid "&synopsis-regex;" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:60 + #: apt-cache.8.xml:170 msgid "" - "The packages command generates a package file from a directory tree. It " - "takes the given directory and recursively searches it for .deb files, " - "emitting a package record to stdout for each. This command is approximately " - "equivalent to &dpkg-scanpackages;." + "<literal>search</literal> performs a full text search on all available " + "package lists for the POSIX regex pattern given, see ®ex;. It searches " + "the package names and the descriptions for an occurrence of the regular " + "expression and prints out the package name and the short description, " + "including virtual package names. If <option>--full</option> is given then " + "output identical to <literal>show</literal> is produced for each matched " + "package, and if <option>--names-only</option> is given then the long " + "description is not searched, only the package name is." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:65 apt-ftparchive.1.xml:89 - msgid "The option <option>--db</option> can be used to specify a binary caching DB." + #: apt-cache.8.xml:181 + msgid "" + "Separate arguments can be used to specify multiple search patterns that are " + "and'ed together." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:70 + #: apt-cache.8.xml:186 msgid "" - "The <literal>sources</literal> command generates a source index file from a " - "directory tree. It takes the given directory and recursively searches it " - "for .dsc files, emitting a source record to stdout for each. This command is " - "approximately equivalent to &dpkg-scansources;." + "<literal>depends</literal> shows a listing of each dependency a package has " + "and all the possible other packages that can fulfill that dependency." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:75 + #: apt-cache.8.xml:191 msgid "" - "If an override file is specified then a source override file will be looked " - "for with an extension of .src. The --source-override option can be used to " - "change the source override file that will be used." + "<literal>rdepends</literal> shows a listing of each reverse dependency a " + "package has." + msgstr "" + + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> + #: apt-cache.8.xml:195 + msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:82 + #: apt-cache.8.xml:196 msgid "" - "The <literal>contents</literal> command generates a contents file from a " - "directory tree. It takes the given directory and recursively searches it for " - ".deb files, and reads the file list from each file. It then sorts and writes " - "to stdout the list of files matched to packages. Directories are not written " - "to the output. If multiple packages own the same file then each package is " - "separated by a comma in the output." + "This command prints the name of each package APT knows. The optional " + "argument is a prefix match to filter the name list. The output is suitable " + "for use in a shell tab complete function and the output is generated " + "extremely quickly. This command is best used with the " + "<option>--generate</option> option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:94 + #: apt-cache.8.xml:201 msgid "" - "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." + "Note that a package which APT knows of is not necessarily available to " + "download, installable or installed, e.g. virtual packages are also listed in " + "the generated list." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:104 + #: apt-cache.8.xml:207 msgid "" - "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>, <literal>Version</literal>, " - "<literal>Codename</literal>, <literal>Date</literal>, " - "<literal>Valid-Until</literal>, <literal>Architectures</literal>, " - "<literal>Components</literal>, <literal>Description</literal>." + "<literal>dotty</literal> takes a list of packages on the command line and " + "generates output suitable for use by dotty from the <ulink " + "url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> " + "package. The result will be a set of nodes and edges representing the " + "relationships between the packages. By default the given packages will trace " + "out all dependent packages; this can produce a very large graph. To limit " + "the output to only the packages listed on the command line, set the " + "<literal>APT::Cache::GivenOnly</literal> option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:117 + #: apt-cache.8.xml:216 msgid "" - "The <literal>generate</literal> command is designed to be runnable from a " - "cron script and builds indexes according to the given config file. The " - "config language provides a flexible means of specifying which index files " - "are built from which directories, as well as providing a simple means of " - "maintaining the required settings." + "The resulting nodes will have several shapes; normal packages are boxes, " + "pure virtual packages are triangles, mixed virtual packages are diamonds, " + "missing packages are hexagons. Orange boxes mean recursion was stopped (leaf " + "packages), blue lines are pre-depends, green lines are conflicts." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:126 - msgid "" - "The <literal>clean</literal> command tidies the databases used by the given " - "configuration file by removing any records that are no longer necessary." - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt-ftparchive.1.xml:132 - msgid "The Generate Configuration" + #: apt-cache.8.xml:221 + msgid "Caution, dotty cannot graph larger sets of packages." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:134 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:225 msgid "" - "The <literal>generate</literal> command uses a configuration file to " - "describe the archives that are going to be generated. It follows the typical " - "ISC configuration format as seen in ISC tools like bind 8 and dhcpd. " - "&apt-conf; contains a description of the syntax. Note that the generate " - "configuration is parsed in sectional manner, but &apt-conf; is parsed in a " - "tree manner. This only effects how the scope tag is handled." - msgstr "" - - #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:142 - msgid "The generate configuration has 4 separate sections, each described below." + "The same as <literal>dotty</literal>, only for xvcg from the <ulink " + "url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG " + "tool</ulink>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt-ftparchive.1.xml:144 - msgid "<literal>Dir</literal> Section" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> + #: apt-cache.8.xml:229 + msgid "<optional><replaceable>&synopsis-pkg;</replaceable>…</optional>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:146 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:230 msgid "" - "The <literal>Dir</literal> section defines the standard directories needed " - "to locate the files required during the generation process. These " - "directories are prepended certain relative paths defined in later sections " - "to produce a complete an absolute path." + "<literal>policy</literal> is meant to help debug issues relating to the " + "preferences file. With no arguments it will print out the priorities of each " + "source. Otherwise it prints out detailed information about the priority " + "selection of the named package." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:153 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:237 msgid "" - "Specifies the root of the FTP archive, in a standard Debian configuration " - "this is the directory that contains the <filename>ls-LR</filename> and dist " - "nodes." + "<literal>apt-cache</literal>'s <literal>madison</literal> command attempts " + "to mimic the output format and a subset of the functionality of the Debian " + "archive management tool, <literal>madison</literal>. It displays available " + "versions of a package in a tabular format. Unlike the original " + "<literal>madison</literal>, it can only display information for the " + "architecture for which APT has retrieved package lists " + "(<literal>APT::Architecture</literal>)." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:160 - msgid "Specifies the location of the override files." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:253 + msgid "" + "Select the file to store the package cache. The package cache is the primary " + "cache used by all operations. Configuration Item: " + "<literal>Dir::Cache::pkgcache</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:165 - msgid "Specifies the location of the cache files" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:259 + msgid "" + "Select the file to store the source cache. The source is used only by " + "<literal>gencaches</literal> and it stores a parsed version of the package " + "information from remote sources. When building the package cache the source " + "cache is used to avoid reparsing all of the package files. Configuration " + "Item: <literal>Dir::Cache::srcpkgcache</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:170 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:267 msgid "" - "Specifies the location of the file list files, if the " - "<literal>FileList</literal> setting is used below." + "Quiet; produces output suitable for logging, omitting progress indicators. " + "More q's will produce more quietness up to a maximum of 2. You can also use " + "<option>-q=#</option> to set the quietness level, overriding the " + "configuration file. Configuration Item: <literal>quiet</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt-ftparchive.1.xml:176 - msgid "<literal>Default</literal> Section" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:274 + msgid "" + "Print only important dependencies; for use with <literal>unmet</literal> and " + "<literal>depends</literal>. Causes only Depends and Pre-Depends relations to " + "be printed. Configuration Item: <literal>APT::Cache::Important</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:178 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:288 msgid "" - "The <literal>Default</literal> section specifies default values, and " - "settings that control the operation of the generator. Other sections may " - "override these defaults with a per-section setting." + "Per default the <literal>depends</literal> and <literal>rdepends</literal> " + "print all dependencies. This can be tweaked with these flags which will omit " + "the specified dependency type. Configuration Item: " + "<literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> " + "e.g. <literal>APT::Cache::ShowRecommends</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:184 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:295 msgid "" - "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'." + "Print full package records when searching. Configuration Item: " + "<literal>APT::Cache::ShowFull</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:192 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:300 msgid "" - "Sets the default list of file extensions that are package files. This " - "defaults to '.deb'." + "Print full records for all available versions. This is the default; to turn " + "it off, use <option>--no-all-versions</option>. If " + "<option>--no-all-versions</option> is specified, only the candidate version " + "will be displayed (the one which would be selected for installation). This " + "option is only applicable to the <literal>show</literal> command. " + "Configuration Item: <literal>APT::Cache::AllVersions</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:198 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:309 msgid "" - "This is similar to <literal>Packages::Compress</literal> except that it " - "controls the compression for the Sources files." + "Perform automatic package cache regeneration, rather than use the cache as " + "it is. This is the default; to turn it off, use " + "<option>--no-generate</option>. Configuration Item: " + "<literal>APT::Cache::Generate</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:204 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:315 msgid "" - "Sets the default list of file extensions that are source files. This " - "defaults to '.dsc'." + "Only search on the package names, not the long descriptions. Configuration " + "Item: <literal>APT::Cache::NamesOnly</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:210 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:320 msgid "" - "This is similar to <literal>Packages::Compress</literal> except that it " - "controls the compression for the Contents files." + "Make <literal>pkgnames</literal> print all names, including virtual packages " + "and missing dependencies. Configuration Item: " + "<literal>APT::Cache::AllNames</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:216 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:326 msgid "" - "This is similar to <literal>Packages::Compress</literal> except that it " - "controls the compression for the Translation-en master file." + "Make <literal>depends</literal> and <literal>rdepends</literal> recursive so " + "that all packages mentioned are printed once. Configuration Item: " + "<literal>APT::Cache::RecurseDepends</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:222 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-cache.8.xml:333 msgid "" - "Specifies the number of kilobytes to delink (and replace with hard links) " - "per run. This is used in conjunction with the per-section " - "<literal>External-Links</literal> setting." + "Limit the output of <literal>depends</literal> and " + "<literal>rdepends</literal> to packages which are currently installed. " + "Configuration Item: <literal>APT::Cache::Installed</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:229 - msgid "" - "Specifies the mode of all created index files. It defaults to 0644. All " - "index files are set to this mode with no regard to the umask." + #. type: Content of: <refentry><refsect1><para> + #: apt-cache.8.xml:351 + msgid "&apt-conf;, &sources-list;, &apt-get;" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:236 apt-ftparchive.1.xml:382 + #. type: Content of: <refentry><refsect1><para> + #: apt-cache.8.xml:356 msgid "" - "Sets if long descriptions should be included in the Packages file or split " - "out into a master Translation-en file." + "<command>apt-cache</command> returns zero on normal operation, decimal 100 " + "on error." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt-ftparchive.1.xml:242 - msgid "<literal>TreeDefault</literal> Section" + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt-key.8.xml:32 + msgid "APT key management utility" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:244 + #. type: Content of: <refentry><refsect1><para> + #: apt-key.8.xml:39 msgid "" - "Sets defaults specific to <literal>Tree</literal> sections. All of these " - "variables are substitution variables and have the strings $(DIST), " - "$(SECTION) and $(ARCH) replaced with their respective values." + "<command>apt-key</command> is used to manage the list of keys used by apt to " + "authenticate packages. Packages which have been authenticated using these " + "keys will be considered trusted." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:251 - msgid "" - "Sets the number of kilobytes of contents files that are generated each " - "day. The contents files are round-robined so that over several days they " - "will all be rebuilt." + #. type: Content of: <refentry><refsect1><title> + #: apt-key.8.xml:45 + msgid "Commands" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:258 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:50 msgid "" - "Controls the number of days a contents file is allowed to be checked without " - "changing. If this limit is passed the mtime of the contents file is " - "updated. This case can occur if the package file is changed in such a way " - "that does not result in a new contents file [override edit for instance]. A " - "hold off is allowed in hopes that new .debs will be installed, requiring a " - "new file anyhow. The default is 10, the units are in days." + "Add a new key to the list of trusted keys. The key is read from the " + "filename given with the parameter &synopsis-param-filename; or if the " + "filename is <literal>-</literal> from standard input." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:269 - msgid "" - "Sets the top of the .deb directory tree. Defaults to " - "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:63 + msgid "Remove a key from the list of trusted keys." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:275 - msgid "" - "Sets the top of the source package directory tree. Defaults to " - "<filename>$(DIST)/$(SECTION)/source/</filename>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:74 + msgid "Output the key &synopsis-param-keyid; to standard output." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:281 - msgid "" - "Sets the output Packages file. Defaults to " - "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:85 + msgid "Output all trusted keys to standard output." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:287 - msgid "" - "Sets the output Sources file. Defaults to " - "<filename>$(DIST)/$(SECTION)/source/Sources</filename>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:96 + msgid "List trusted keys." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:293 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:107 + msgid "List fingerprints of trusted keys." + msgstr "" + + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:118 msgid "" - "Set 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>" + "Pass advanced options to gpg. With adv --recv-key you can download the " + "public key." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:300 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:130 msgid "" - "Sets the path prefix that causes a symlink to be considered an internal link " - "instead of an external link. Defaults to " - "<filename>$(DIST)/$(SECTION)/</filename>" + "Update the local keyring with the archive keyring and remove from the local " + "keyring the archive keys which are no longer valid. The archive keyring is " + "shipped in the <literal>archive-keyring</literal> package of your " + "distribution, e.g. the <literal>debian-archive-keyring</literal> package in " + "Debian." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:307 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:144 msgid "" - "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) then <command>apt-ftparchive</command> will integrate those " - "package files together automatically." + "Perform an update working similarly to the <command>update</command> command " + "above, but get the archive keyring from a URI instead and validate it " + "against a master key. This requires an installed &wget; and an APT build " + "configured to have a server to fetch from and a master keyring to validate. " + "APT in Debian does not support this command, relying on " + "<command>update</command> instead, but Ubuntu's APT does." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:316 - msgid "Sets header file to prepend to the contents output." + #. type: Content of: <refentry><refsect1><title> + #: apt-key.8.xml:160 apt-cdrom.8.xml:80 + msgid "Options" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:321 + #. type: Content of: <refentry><refsect1><para> + #: apt-key.8.xml:161 msgid "" - "Sets the binary cache database to use for this section. Multiple sections " - "can share the same database." + "Note that options need to be defined before the commands described in the " + "previous section." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:327 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:164 msgid "" - "Specifies that instead of walking the directory tree, " - "<command>apt-ftparchive</command> should read the list of files from the " - "given file. Relative files names are prefixed with the archive directory." + "With this option it is possible to specify a particular keyring file the " + "command should operate on. The default is that a command is executed on the " + "<filename>trusted.gpg</filename> file as well as on all parts in the " + "<filename>trusted.gpg.d</filename> directory, though " + "<filename>trusted.gpg</filename> is the primary keyring which means that " + "e.g. new keys are added to this one." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:334 - msgid "" - "Specifies that instead of walking the directory tree, " - "<command>apt-ftparchive</command> should read the list of files from the " - "given file. Relative files names are prefixed with the archive directory. " - "This is used when processing source indexes." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> + #: apt-key.8.xml:179 + msgid "<filename>/etc/apt/trustdb.gpg</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt-ftparchive.1.xml:342 - msgid "<literal>Tree</literal> Section" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:180 + msgid "Local trust database of archive keys." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:344 - msgid "" - "The <literal>Tree</literal> section defines a standard Debian file tree " - "which consists of a base directory, then multiple sections in that base " - "directory and finally multiple Architectures in each section. The exact " - "pathing used is defined by the <literal>Directory</literal> substitution " - "variable." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> + #: apt-key.8.xml:183 + msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:349 - msgid "" - "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>." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:184 + msgid "Keyring of Debian archive trusted keys." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:354 - msgid "" - "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." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> + #: apt-key.8.xml:187 + msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt-ftparchive.1.xml:360 - #, no-wrap - msgid "" - "for i in Sections do \n" - " for j in Architectures do\n" - " Generate for DIST=scope SECTION=i ARCH=j\n" - " " + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-key.8.xml:188 + msgid "Keyring of Debian archive removed trusted keys." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:357 - msgid "" - "When processing a <literal>Tree</literal> section " - "<command>apt-ftparchive</command> performs an operation similar to: " - "<placeholder type=\"programlisting\" id=\"0\"/>" + #. type: Content of: <refentry><refsect1><para> + #: apt-key.8.xml:197 + msgid "&apt-get;, &apt-secure;" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:368 - msgid "" - "This is a space separated list of sections which appear under the " - "distribution, typically this is something like <literal>main contrib " - "non-free</literal>" + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt-mark.8.xml:33 + msgid "mark/unmark a package as being automatically-installed" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:375 + #. type: Content of: <refentry><refsect1><para> + #: apt-mark.8.xml:39 msgid "" - "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." + "<command>apt-mark</command> will change whether a package has been marked as " + "being automatically installed." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:388 + #. type: Content of: <refentry><refsect1><para> + #: apt-mark.8.xml:43 msgid "" - "Sets the binary override file. The override file contains section, priority " - "and maintainer address information." + "When you request that a package is installed, and as a result other packages " + "are installed to satisfy its dependencies, the dependencies are marked as " + "being automatically installed. Once these automatically installed packages " + "are no longer depended on by any manually installed packages, they will be " + "removed by e.g. <command>apt-get</command> or <command>aptitude</command>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:394 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:52 msgid "" - "Sets the source override file. The override file contains section " - "information." + "<literal>auto</literal> is used to mark a package as being automatically " + "installed, which will cause the package to be removed when no more manually " + "installed packages depend on this package." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:400 apt-ftparchive.1.xml:446 - msgid "Sets the binary extra override file." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:60 + msgid "" + "<literal>manual</literal> is used to mark a package as being manually " + "installed, which will prevent the package from being automatically removed " + "if no other packages depend on it." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:405 apt-ftparchive.1.xml:451 - msgid "Sets the source extra override file." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:68 + msgid "" + "<literal>hold</literal> is used to mark a package as held back, which will " + "prevent the package from being automatically installed, upgraded or " + "removed. The command is only a wrapper around <command>dpkg " + "--set-selections</command> and the state is therefore maintained by &dpkg; " + "and not affected by the <option>--file</option> option." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt-ftparchive.1.xml:410 - msgid "<literal>BinDirectory</literal> Section" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:78 + msgid "" + "<literal>unhold</literal> is used to cancel a previously set hold on a " + "package to allow all actions again." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt-ftparchive.1.xml:412 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:84 msgid "" - "The <literal>bindirectory</literal> section defines a binary directory tree " - "with no special structure. The scope tag specifies the location of the " - "binary directory and the settings are similar to the <literal>Tree</literal> " - "section with no substitution variables or " - "<literal>Section</literal><literal>Architecture</literal> settings." + "<literal>showauto</literal> is used to print a list of automatically " + "installed packages with each package on a new line. All automatically " + "installed packages will be listed if no package is given. If packages are " + "given only those which are automatically installed will be shown." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:420 - msgid "Sets the Packages file output." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:92 + msgid "" + "<literal>showmanual</literal> can be used in the same way as " + "<literal>showauto</literal> except that it will print a list of manually " + "installed packages instead." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:425 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:99 msgid "" - "Sets the Sources file output. At least one of <literal>Packages</literal> or " - "<literal>Sources</literal> is required." + "<literal>showhold</literal> is used to print a list of packages on hold in " + "the same way as for the other show commands." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:431 - msgid "Sets the Contents file output. (optional)" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-mark.8.xml:115 + msgid "" + "Read/Write package stats from the filename given with the parameter " + "&synopsis-param-filename; instead of from the default location, which is " + "<filename>extended_status</filename> in the directory defined by the " + "Configuration Item: <literal>Dir::State</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:436 - msgid "Sets the binary override file." + #. type: Content of: <refentry><refsect1><para> + #: apt-mark.8.xml:136 + msgid "" + "<command>apt-mark</command> returns zero on normal operation, non-zero on " + "error." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:441 - msgid "Sets the source override file." + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt-secure.8.xml:47 + msgid "Archive authentication support for APT" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:456 - msgid "Sets the cache DB." + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:52 + msgid "" + "Starting with version 0.6, <command>apt</command> contains code that does " + "signature checking of the Release file for all archives. This ensures that " + "packages in the archive can't be modified by people who have no access to " + "the Release file signing key." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:461 - msgid "Appends a path to all the output paths." + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:60 + msgid "" + "If a package comes from a archive without a signature, or with a signature " + "that apt does not have a key for, that package is considered untrusted, and " + "installing it will result in a big warning. <command>apt-get</command> will " + "currently only warn for unsigned archives; future releases might force all " + "sources to be verified before downloading packages from them." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:466 - msgid "Specifies the file list file." + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:69 + msgid "" + "The package frontends &apt-get;, &aptitude; and &synaptic; support this new " + "authentication feature." msgstr "" #. type: Content of: <refentry><refsect1><title> - #: apt-ftparchive.1.xml:473 - msgid "The Binary Override File" + #: apt-secure.8.xml:74 + msgid "Trusted archives" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:474 + #: apt-secure.8.xml:77 msgid "" - "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 the " - "section to force that package to and the final field is the maintainer " - "permutation field." - msgstr "" - - #. type: Content of: <refentry><refsect1><para><literallayout> - #: apt-ftparchive.1.xml:480 - #, no-wrap - msgid "old [// oldn]* => new" - msgstr "" - - #. type: Content of: <refentry><refsect1><para><literallayout> - #: apt-ftparchive.1.xml:482 - #, no-wrap - msgid "new" + "The chain of trust from an apt archive to the end user is made up of several " + "steps. <command>apt-secure</command> is the last step in this chain; " + "trusting an archive does not mean that you trust its packages not to contain " + "malicious code, but means that you trust the archive maintainer. It's the " + "archive maintainer's responsibility to ensure that the archive's integrity " + "is preserved." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:479 + #: apt-secure.8.xml:85 msgid "" - "The general form of the maintainer field is: <placeholder " - "type=\"literallayout\" id=\"0\"/> or simply, <placeholder " - "type=\"literallayout\" id=\"1\"/> The first form allows a double-slash " - "separated list of old email addresses to be specified. If any of those are " - "found then new is substituted for the maintainer field. The second form " - "unconditionally substitutes the maintainer field." + "apt-secure does not review signatures at a package level. If you require " + "tools to do this you should look at <command>debsig-verify</command> and " + "<command>debsign</command> (provided in the debsig-verify and devscripts " + "packages respectively)." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-ftparchive.1.xml:490 - msgid "The Source Override File" + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:92 + msgid "" + "The chain of trust in Debian starts when a maintainer uploads a new package " + "or a new version of a package to the Debian archive. In order to become " + "effective, this upload needs to be signed by a key contained in the Debian " + "Maintainers keyring (available in the debian-keyring package). Maintainers' " + "keys are signed by other maintainers following pre-established procedures to " + "ensure the identity of the key holder." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:492 + #: apt-secure.8.xml:102 msgid "" - "The source override file is fully compatible with &dpkg-scansources;. It " - "contains 2 fields separated by spaces. The first fields is the source " - "package name, the second is the section to assign it." + "Once the uploaded package is verified and included in the archive, the " + "maintainer signature is stripped off, and checksums of the package are " + "computed and put in the Packages file. The checksums of all of the Packages " + "files are then computed and put into the Release file. The Release file is " + "then signed by the archive key for this Debian release, and distributed " + "alongside the packages and the Packages files on Debian mirrors. The keys " + "are in the Debian archive keyring available in the " + "<package>debian-archive-keyring</package> package." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-ftparchive.1.xml:497 - msgid "The Extra Override File" + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:113 + msgid "" + "End users can check the signature of the Release file, extract a checksum of " + "a package from it and compare it with the checksum of the package they " + "downloaded by hand - or rely on APT doing this automatically." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:499 + #: apt-secure.8.xml:118 msgid "" - "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 the " - "tag and the remainder of the line is the new value." + "Notice that this is distinct from checking signatures on a per package " + "basis. It is designed to prevent two possible attacks:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:510 + #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> + #: apt-secure.8.xml:123 msgid "" - "Generate the given checksum. These options default to on, when turned off " - "the generated index files will not have the checksum fields where possible. " - "Configuration Items: " - "<literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and " - "<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>." + "<literal>Network \"man in the middle\" attacks</literal>. Without signature " + "checking, malicious agents can introduce themselves into the package " + "download process and provide malicious software either by controlling a " + "network element (router, switch, etc.) or by redirecting traffic to a rogue " + "server (through ARP or DNS spoofing attacks)." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:521 + #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> + #: apt-secure.8.xml:131 msgid "" - "Use a binary caching DB. This has no effect on the generate command. " - "Configuration Item: <literal>APT::FTPArchive::DB</literal>." + "<literal>Mirror network compromise</literal>. Without signature checking, a " + "malicious agent can compromise a mirror host and modify the files in it to " + "propagate malicious software to all users downloading packages from that " + "host." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:527 + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:138 msgid "" - "Quiet; produces output suitable for logging, omitting progress indicators. " - "More q's will produce more quiet up to a maximum of 2. You can also use " - "<option>-q=#</option> to set the quiet level, overriding the configuration " - "file. Configuration Item: <literal>quiet</literal>." + "However, it does not defend against a compromise of the Debian master server " + "itself (which signs the packages) or against a compromise of the key used to " + "sign the Release files. In any case, this mechanism can complement a " + "per-package signature." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:535 - msgid "" - "Perform Delinking. If the <literal>External-Links</literal> setting is used " - "then this option actually enables delinking of the files. It defaults to on " - "and can be turned off with <option>--no-delink</option>. Configuration " - "Item: <literal>APT::FTPArchive::DeLinkAct</literal>." + #. type: Content of: <refentry><refsect1><title> + #: apt-secure.8.xml:144 + msgid "User configuration" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:543 + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:146 msgid "" - "Perform contents generation. When this option is set and package indexes are " - "being generated with a cache DB then the file listing will also be extracted " - "and stored in the DB for later use. When using the generate command this " - "option also allows the creation of any Contents files. The default is on. " - "Configuration Item: <literal>APT::FTPArchive::Contents</literal>." + "<command>apt-key</command> is the program that manages the list of keys used " + "by apt. It can be used to add or remove keys, although an installation of " + "this release will automatically contain the default Debian archive signing " + "keys used in the Debian package repositories." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:553 + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:153 msgid "" - "Select the source override file to use with the <literal>sources</literal> " - "command. Configuration Item: " - "<literal>APT::FTPArchive::SourceOverride</literal>." + "In order to add a new key you need to first download it (you should make " + "sure you are using a trusted communication channel when retrieving it), add " + "it with <command>apt-key</command> and then run <command>apt-get " + "update</command> so that apt can download and verify the " + "<filename>InRelease</filename> or <filename>Release.gpg</filename> files " + "from the archives you have configured." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:559 + #. type: Content of: <refentry><refsect1><title> + #: apt-secure.8.xml:162 + msgid "Archive configuration" + msgstr "" + + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:164 msgid "" - "Make the caching databases read only. Configuration Item: " - "<literal>APT::FTPArchive::ReadOnlyDB</literal>." + "If you want to provide archive signatures in an archive under your " + "maintenance you have to:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:564 + #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> + #: apt-secure.8.xml:169 msgid "" - "Accept in the <literal>packages</literal> and <literal>contents</literal> " - "commands only package files matching <literal>*_arch.deb</literal> or " - "<literal>*_all.deb</literal> instead of all package files in the given " - "path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>." + "<emphasis>Create a toplevel Release file</emphasis>, if it does not exist " + "already. You can do this by running <command>apt-ftparchive " + "release</command> (provided in apt-utils)." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:572 + #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> + #: apt-secure.8.xml:174 msgid "" - "&apt-ftparchive; caches as much as possible of metadata in a cachedb. If " - "packages are recompiled and/or republished with the same version again, this " - "will lead to problems as the now outdated cached metadata like size and " - "checksums will be used. With this option enabled this will no longer happen " - "as it will be checked if the file was changed. Note that this option is set " - "to \"<literal>false</literal>\" by default as it is not recommend to upload " - "multiply versions/builds of a package with the same versionnumber, so in " - "theory nobody will have these problems and therefore all these extra checks " - "are useless." + "<emphasis>Sign it</emphasis>. You can do this by running <command>gpg " + "--clearsign -o InRelease Release</command> and <command>gpg -abs -o " + "Release.gpg Release</command>." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-ftparchive.1.xml:584 + #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> + #: apt-secure.8.xml:178 msgid "" - "This configuration option defaults to \"<literal>true</literal>\" and should " - "only be set to <literal>\"false\"</literal> if the Archive generated with " - "&apt-ftparchive; also provides <filename>Translation</filename> files. Note " - "that the <filename>Translation-en</filename> master file can only be created " - "in the generate command." + "<emphasis>Publish the key fingerprint</emphasis>, that way your users will " + "know what key they need to import in order to authenticate the files in the " + "archive." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-ftparchive.1.xml:596 apt.conf.5.xml:1112 apt_preferences.5.xml:545 sources.list.5.xml:211 - msgid "Examples" + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:185 + msgid "" + "Whenever the contents of the archive change (new packages are added or " + "removed) the archive maintainer has to follow the first two steps outlined " + "above." msgstr "" - #. type: Content of: <refentry><refsect1><para><programlisting> - #: apt-ftparchive.1.xml:602 - #, no-wrap + #. type: Content of: <refentry><refsect1><para> + #: apt-secure.8.xml:193 msgid "" - "<command>apt-ftparchive</command> packages " - "<replaceable>directory</replaceable> | <command>gzip</command> > " - "<filename>Packages.gz</filename>\n" + "&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, " + "&debsign; &debsig-verify;, &gpg;" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:598 + #: apt-secure.8.xml:197 msgid "" - "To create a compressed Packages file for a directory containing binary " - "packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>" + "For more background information you might want to review the <ulink " + "url=\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian " + "Security Infrastructure</ulink> chapter of the Securing Debian Manual " + "(available also in the harden-doc package) and the <ulink " + "url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong " + "Distribution HOWTO</ulink> by V. Alex Brennen." + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt-secure.8.xml:210 + msgid "Manpage Authors" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-ftparchive.1.xml:612 + #: apt-secure.8.xml:212 msgid "" - "<command>apt-ftparchive</command> returns zero on normal operation, decimal " - "100 on error." + "This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac " + "Jones, Colin Walters, Florian Weimer and Michael Vogt." msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-get.8.xml:33 - msgid "APT package handling utility -- command-line interface" + #: apt-cdrom.8.xml:32 + msgid "APT CD-ROM management utility" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-get.8.xml:39 + #: apt-cdrom.8.xml:38 msgid "" - "<command>apt-get</command> is the command-line tool for handling packages, " - "and may be considered the user's \"back-end\" to other tools using the APT " - "library. Several \"front-end\" interfaces exist, such as &dselect;, " - "&aptitude;, &synaptic; and &wajig;." + "<command>apt-cdrom</command> is used to add a new CD-ROM to APT's list of " + "available sources. <command>apt-cdrom</command> takes care of determining " + "the structure of the disc as well as correcting for several possible " + "mis-burns and verifying the index files." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:49 + #. type: Content of: <refentry><refsect1><para> + #: apt-cdrom.8.xml:45 msgid "" - "<literal>update</literal> is used to resynchronize the package index files " - "from their sources. The indexes of available packages are fetched from the " - "location(s) specified in <filename>/etc/apt/sources.list</filename>. For " - "example, when using a Debian archive, this command retrieves and scans the " - "<filename>Packages.gz</filename> files, so that information about new and " - "updated packages is available. An <literal>update</literal> should always be " - "performed before an <literal>upgrade</literal> or " - "<literal>dist-upgrade</literal>. Please be aware that the overall progress " - "meter will be incorrect as the size of the package files cannot be known in " - "advance." + "It is necessary to use <command>apt-cdrom</command> to add CDs to the APT " + "system; it cannot be done by hand. Furthermore each disc in a multi-CD set " + "must be inserted and scanned separately to account for possible mis-burns." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:61 + #: apt-cdrom.8.xml:56 msgid "" - "<literal>upgrade</literal> is used to install the newest versions of all " - "packages currently installed on the system from the sources enumerated in " - "<filename>/etc/apt/sources.list</filename>. Packages currently installed " - "with new versions available are retrieved and upgraded; under no " - "circumstances are currently installed packages removed, or packages not " - "already installed retrieved and installed. New versions of currently " - "installed packages that cannot be upgraded without changing the install " - "status of another package will be left at their current version. An " - "<literal>update</literal> must be performed first so that " - "<command>apt-get</command> knows that new versions of packages are " - "available." + "<literal>add</literal> is used to add a new disc to the source list. It will " + "unmount the CD-ROM device, prompt for a disc to be inserted and then proceed " + "to scan it and copy the index files. If the disc does not have a proper " + "<filename>.disk</filename> directory you will be prompted for a descriptive " + "title." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:74 + #: apt-cdrom.8.xml:64 msgid "" - "<literal>dselect-upgrade</literal> is used in conjunction with the " - "traditional Debian packaging front-end, " - "&dselect;. <literal>dselect-upgrade</literal> follows the changes made by " - "&dselect; to the <literal>Status</literal> field of available packages, and " - "performs the actions necessary to realize that state (for instance, the " - "removal of old and the installation of new packages)." + "APT uses a CD-ROM ID to track which disc is currently in the drive and " + "maintains a database of these IDs in " + "<filename>&statedir;/cdroms.list</filename>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:84 + #: apt-cdrom.8.xml:72 msgid "" - "<literal>dist-upgrade</literal> in addition to performing the function of " - "<literal>upgrade</literal>, also intelligently handles changing dependencies " - "with new versions of packages; <command>apt-get</command> has a \"smart\" " - "conflict resolution system, and it will attempt to upgrade the most " - "important packages at the expense of less important ones if necessary. So, " - "<literal>dist-upgrade</literal> command may remove some packages. The " - "<filename>/etc/apt/sources.list</filename> file contains a list of locations " - "from which to retrieve desired package files. See also &apt-preferences; " - "for a mechanism for overriding the general settings for individual packages." + "A debugging tool to report the identity of the current disc as well as the " + "stored file name" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:98 + #: apt-cdrom.8.xml:85 msgid "" - "<literal>install</literal> is followed by one or more packages desired for " - "installation or upgrading. Each package is a package name, not a fully " - "qualified filename (for instance, in a Debian system, libc6 would be the " - "argument provided, not <literal>libc6_1.9.6-2.deb</literal>). All packages " - "required by the package(s) specified for installation will also be retrieved " - "and installed. The <filename>/etc/apt/sources.list</filename> file is used " - "to locate the desired packages. If a hyphen is appended to the package name " - "(with no intervening space), the identified package will be removed if it is " - "installed. Similarly a plus sign can be used to designate a package to " - "install. These latter features may be used to override decisions made by " - "apt-get's conflict resolution system." + "Mount point; specify the location to mount the CD-ROM. This mount point must " + "be listed in <filename>/etc/fstab</filename> and properly configured. " + "Configuration Item: <literal>Acquire::cdrom::mount</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:116 + #: apt-cdrom.8.xml:94 msgid "" - "A specific version of a package can be selected for installation by " - "following the package name with an equals and the version of the package to " - "select. This will cause that version to be located and selected for " - "install. Alternatively a specific distribution can be selected by following " - "the package name with a slash and the version of the distribution or the " - "Archive name (stable, testing, unstable)." + "Rename a disc; change the label of a disc or override the disc's given " + "label. This option will cause <command>apt-cdrom</command> to prompt for a " + "new label. Configuration Item: <literal>APT::CDROM::Rename</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:123 + #: apt-cdrom.8.xml:103 msgid "" - "Both of the version selection mechanisms can downgrade packages and must be " - "used with care." + "No mounting; prevent <command>apt-cdrom</command> from mounting and " + "unmounting the mount point. Configuration Item: " + "<literal>APT::CDROM::NoMount</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:126 + #: apt-cdrom.8.xml:111 msgid "" - "This is also the target to use if you want to upgrade one or more " - "already-installed packages without upgrading every package you have on your " - "system. Unlike the \"upgrade\" target, which installs the newest version of " - "all currently installed packages, \"install\" will install the newest " - "version of only the package(s) specified. Simply provide the name of the " - "package(s) you wish to upgrade, and if a newer version is available, it (and " - "its dependencies, as described above) will be downloaded and installed." + "Fast Copy; Assume the package files are valid and do not check every " + "package. This option should be used only if <command>apt-cdrom</command> has " + "been run on this disc before and did not detect any errors. Configuration " + "Item: <literal>APT::CDROM::Fast</literal>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:137 + #: apt-cdrom.8.xml:121 msgid "" - "Finally, the &apt-preferences; mechanism allows you to create an alternative " - "installation policy for individual packages." + "Thorough Package Scan; This option may be needed with some old Debian " + "1.1/1.2 discs that have Package files in strange places. It takes much " + "longer to scan the CD but will pick them all up." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:141 + #: apt-cdrom.8.xml:132 msgid "" - "If no package matches the given expression and the expression contains one " - "of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and " - "it is applied to all package names in the database. Any matches are then " - "installed (or removed). Note that matching is done by substring so 'lo.*' " - "matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular " - "expression with a '^' or '$' character, or create a more specific regular " - "expression." + "No Changes; Do not change the &sources-list; file and do not write index " + "files. Everything is still checked however. Configuration Item: " + "<literal>APT::CDROM::NoAct</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:151 - msgid "" - "<literal>remove</literal> is identical to <literal>install</literal> except " - "that packages are removed instead of installed. Note the removing a package " - "leaves its configuration files in system. If a plus sign is appended to the " - "package name (with no intervening space), the identified package will be " - "installed instead of removed." + #. type: Content of: <refentry><refsect1><para> + #: apt-cdrom.8.xml:145 + msgid "&apt-conf;, &apt-get;, &sources-list;" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:159 + #. type: Content of: <refentry><refsect1><para> + #: apt-cdrom.8.xml:150 msgid "" - "<literal>purge</literal> is identical to <literal>remove</literal> except " - "that packages are removed and purged (any configuration files are deleted " - "too)." + "<command>apt-cdrom</command> returns zero on normal operation, decimal 100 " + "on error." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:164 - msgid "" - "<literal>source</literal> causes <command>apt-get</command> to fetch source " - "packages. APT will examine the available packages to decide which source " - "package to fetch. It will then find and download into the current directory " - "the newest available version of that source package while respecting the " - "default release, set with the option " - "<literal>APT::Default-Release</literal>, the <option>-t</option> option or " - "per package with the <literal>pkg/release</literal> syntax, if possible." + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt-config.8.xml:33 + msgid "APT Configuration Query program" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:172 + #. type: Content of: <refentry><refsect1><para> + #: apt-config.8.xml:39 msgid "" - "Source packages are tracked separately from binary packages via " - "<literal>deb-src</literal> type lines in the &sources-list; file. This means " - "that you will need to add such a line for each repository you want to get " - "sources from. If you don't do this you will properly get another (newer, " - "older or none) source version than the one you have installed or could " - "install." + "<command>apt-config</command> is an internal program used by various " + "portions of the APT suite to provide consistent configurability. It accesses " + "the main configuration file <filename>/etc/apt/apt.conf</filename> in a " + "manner that is easy to use for scripted applications." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:179 + #: apt-config.8.xml:51 msgid "" - "If the <option>--compile</option> option is specified then the package will " - "be compiled to a binary .deb using <command>dpkg-buildpackage</command> for " - "the architecture as defined by the <command>--host-architecture</command> " - "option. If <option>--download-only</option> is specified then the source " - "package will not be unpacked." + "shell is used to access the configuration information from a shell " + "script. It is given pairs of arguments, the first being a shell variable and " + "the second the configuration value to query. As output it lists shell " + "assignment commands for each value present. In a shell script it should be " + "used as follows:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:186 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting> + #: apt-config.8.xml:59 + #, no-wrap msgid "" - "A specific source version can be retrieved by postfixing the source name " - "with an equals and then the version to fetch, similar to the mechanism used " - "for the package files. This enables exact matching of the source package " - "name and version, implicitly enabling the " - "<literal>APT::Get::Only-Source</literal> option." + "OPTS=\"-f\"\n" + "RES=`apt-config shell OPTS MyApp::options`\n" + "eval $RES\n" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:192 + #: apt-config.8.xml:64 msgid "" - "Note that source packages are not tracked like binary packages, they exist " - "only in the current directory and are similar to downloading source tar " - "balls." + "This will set the shell environment variable $OPTS to the value of " + "MyApp::options with a default of <option>-f</option>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:198 + #: apt-config.8.xml:68 msgid "" - "<literal>build-dep</literal> causes apt-get to install/remove packages in an " - "attempt to satisfy the build dependencies for a source package. By default " - "the dependencies are satisfied to build the package natively. If desired a " - "host-architecture can be specified with the " - "<option>--host-architecture</option> option instead." + "The configuration item may be postfixed with a /[fdbi]. f returns file " + "names, d returns directories, b returns true or false and i returns an " + "integer. Each of the returns is normalized and verified internally." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:205 - msgid "" - "<literal>check</literal> is a diagnostic tool; it updates the package cache " - "and checks for broken dependencies." + #: apt-config.8.xml:77 + msgid "Just show the contents of the configuration space." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:210 + #: apt-config.8.xml:90 msgid "" - "<literal>download</literal> will download the given binary package into the " - "current directory." + "Include options which have an empty value. This is the default, so use " + "--no-empty to remove them from the output." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:216 - msgid "" - "<literal>clean</literal> clears out the local repository of retrieved " - "package files. It removes everything but the lock file from " - "<filename>&cachedir;/archives/</filename> and " - "<filename>&cachedir;/archives/partial/</filename>. When APT is used as a " - "&dselect; method, <literal>clean</literal> is run automatically. Those who " - "do not use dselect will likely want to run <literal>apt-get clean</literal> " - "from time to time to free up disk space." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable> + #: apt-config.8.xml:95 + msgid "%f "%v";%n" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:226 + #: apt-config.8.xml:96 msgid "" - "Like <literal>clean</literal>, <literal>autoclean</literal> clears out the " - "local repository of retrieved package files. The difference is that it only " - "removes package files that can no longer be downloaded, and are largely " - "useless. This allows a cache to be maintained over a long period without it " - "growing out of control. The configuration option " - "<literal>APT::Clean-Installed</literal> will prevent installed packages from " - "being erased if it is set to off." + "Defines the output of each config option. %t will be replaced with " + "its individual name, %f with its full hierarchical name and %v " + "with its value. Use uppercase letters and special characters in the value " + "will be encoded to ensure that it can e.g. be safely used in a quoted-string " + "as defined by RFC822. Additionally %n will be replaced by a newline, " + "and %N by a tab. A % can be printed by using %%." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:236 - msgid "" - "<literal>autoremove</literal> is used to remove packages that were " - "automatically installed to satisfy dependencies for other packages and are " - "now no longer needed." + #. type: Content of: <refentry><refsect1><para> + #: apt-config.8.xml:110 apt-extracttemplates.1.xml:71 apt-sortpkgs.1.xml:64 apt-ftparchive.1.xml:608 + msgid "&apt-conf;" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:241 + #. type: Content of: <refentry><refsect1><para> + #: apt-config.8.xml:115 msgid "" - "<literal>changelog</literal> downloads a package changelog and displays it " - "through <command>sensible-pager</command>. The server name and base " - "directory is defined in the <literal>APT::Changelogs::Server</literal> " - "variable (e. g. <ulink " - "url=\"http://packages.debian.org/changelogs\">packages.debian.org/changelogs</ulink> " - "for Debian or <ulink " - "url=\"http://changelogs.ubuntu.com/changelogs\">changelogs.ubuntu.com/changelogs</ulink> " - "for Ubuntu). By default it displays the changelog for the version that is " - "installed. However, you can specify the same options as for the " - "<option>install</option> command." + "<command>apt-config</command> returns zero on normal operation, decimal 100 " + "on error." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:264 - msgid "" - "Do not consider recommended packages as a dependency for installing. " - "Configuration Item: <literal>APT::Install-Recommends</literal>." + #. type: Content of: <refentry><refentryinfo><author><contrib> + #: apt.conf.5.xml:20 + msgid "Initial documentation of Debug::*." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:269 + #. type: Content of: <refentry><refentryinfo><author><email> + #: apt.conf.5.xml:21 + msgid "dburrows@debian.org" + msgstr "" + + #. type: Content of: <refentry><refmeta><manvolnum> + #: apt.conf.5.xml:31 apt_preferences.5.xml:25 sources.list.5.xml:26 + msgid "5" + msgstr "" + + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt.conf.5.xml:38 + msgid "Configuration file for APT" + msgstr "" + + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:42 msgid "" - "Consider suggested packages as a dependency for installing. Configuration " - "Item: <literal>APT::Install-Suggests</literal>." + "<filename>/etc/apt/apt.conf</filename> is the main configuration file shared " + "by all the tools in the APT suite of tools, though it is by no means the " + "only place options can be set. The suite also shares a common command line " + "parser to provide a uniform environment." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:274 + #. type: Content of: <refentry><refsect1><orderedlist><para> + #: apt.conf.5.xml:48 msgid "" - "Download only; package files are only retrieved, not unpacked or installed. " - "Configuration Item: <literal>APT::Get::Download-Only</literal>." + "When an APT tool starts up it will read the configuration files in the " + "following order:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:279 + #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> + #: apt.conf.5.xml:50 msgid "" - "Fix; attempt to correct a system with broken dependencies in place. This " - "option, when used with install/remove, can omit any packages to permit APT " - "to deduce a likely solution. If packages are specified, these have to " - "completely correct the problem. The option is sometimes necessary when " - "running APT for the first time; APT itself does not allow broken package " - "dependencies to exist on a system. It is possible that a system's dependency " - "structure can be so corrupt as to require manual intervention (which usually " - "means using &dselect; or <command>dpkg --remove</command> to eliminate some " - "of the offending packages). Use of this option together with " - "<option>-m</option> may produce an error in some situations. Configuration " - "Item: <literal>APT::Get::Fix-Broken</literal>." + "the file specified by the <envar>APT_CONFIG</envar> environment variable (if " + "any)" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:294 + #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> + #: apt.conf.5.xml:52 msgid "" - "Ignore missing packages; If packages cannot be retrieved or fail the " - "integrity check after retrieval (corrupted package files), hold back those " - "packages and handle the result. Use of this option together with " - "<option>-f</option> may produce an error in some situations. If a package is " - "selected for installation (particularly if it is mentioned on the command " - "line) and it could not be downloaded then it will be silently held back. " - "Configuration Item: <literal>APT::Get::Fix-Missing</literal>." + "all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending " + "order which have either no or \"<literal>conf</literal>\" as filename " + "extension and which only contain alphanumeric, hyphen (-), underscore (_) " + "and period (.) characters. Otherwise APT will print a notice that it has " + "ignored a file, unless that file matches a pattern in the " + "<literal>Dir::Ignore-Files-Silently</literal> configuration list - in which " + "case it will be silently ignored." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:305 - msgid "" - "Disables downloading of packages. This is best used with " - "<option>--ignore-missing</option> to force APT to use only the .debs it has " - "already downloaded. Configuration Item: " - "<literal>APT::Get::Download</literal>." + #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> + #: apt.conf.5.xml:59 + msgid "the main configuration file specified by <literal>Dir::Etc::main</literal>" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:312 + #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> + #: apt.conf.5.xml:61 msgid "" - "Quiet; produces output suitable for logging, omitting progress indicators. " - "More q's will produce more quiet up to a maximum of 2. You can also use " - "<option>-q=#</option> to set the quiet level, overriding the configuration " - "file. Note that quiet level 2 implies <option>-y</option>, you should never " - "use -qq without a no-action modifier such as -d, --print-uris or -s as APT " - "may decided to do something you did not expect. Configuration Item: " - "<literal>quiet</literal>." + "the command line options are applied to override the configuration " + "directives or to load even more configuration files." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:327 + #. type: Content of: <refentry><refsect1><title> + #: apt.conf.5.xml:65 + msgid "Syntax" + msgstr "" + + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:66 msgid "" - "No action; perform a simulation of events that would occur but do not " - "actually change the system. Configuration Item: " - "<literal>APT::Get::Simulate</literal>." + "The configuration file is organized in a tree with options organized into " + "functional groups. Option specification is given with a double colon " + "notation; for instance <literal>APT::Get::Assume-Yes</literal> is an option " + "within the APT tool group, for the Get tool. Options do not inherit from " + "their parent groups." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:331 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:72 msgid "" - "Simulation run as user will deactivate locking " - "(<literal>Debug::NoLocking</literal>) automatic. Also a notice will be " - "displayed indicating that this is only a simulation, if the option " - "<literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: " - "true). Neither NoLocking nor the notice will be triggered if run as root " - "(root should know what he is doing without further warnings by " - "<literal>apt-get</literal>)." + "Syntactically the configuration language is modeled after what the ISC tools " + "such as bind and dhcp use. Lines starting with <literal>//</literal> are " + "treated as comments (ignored), as well as all text between " + "<literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments. " + "Each line is of the form <literal>APT::Get::Assume-Yes \"true\";</literal>. " + "The quotation marks and trailing semicolon are required. The value must be " + "on one line, and there is no kind of string concatenation. Values must not " + "include backslashes or extra quotation marks. Option names are made up of " + "alphanumeric characters and the characters \"/-:._+\". A new scope can be " + "opened with curly braces, like this:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:337 + #. type: Content of: <refentry><refsect1><informalexample><programlisting> + #: apt.conf.5.xml:85 + #, no-wrap msgid "" - "Simulate prints out a series of lines each one representing a dpkg " - "operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets " - "indicate broken packages and empty set of square brackets meaning breaks " - "that are of no consequence (rare)." + "APT {\n" + " Get {\n" + " Assume-Yes \"true\";\n" + " Fix-Broken \"true\";\n" + " };\n" + "};\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:346 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:93 msgid "" - "Automatic yes to prompts; assume \"yes\" as answer to all prompts and run " - "non-interactively. If an undesirable situation, such as changing a held " - "package, trying to install a unauthenticated package or removing an " - "essential package occurs then <literal>apt-get</literal> will abort. " - "Configuration Item: <literal>APT::Get::Assume-Yes</literal>." + "with newlines placed to make it more readable. Lists can be created by " + "opening a scope and including a single string enclosed in quotes followed by " + "a semicolon. Multiple entries can be included, separated by a semicolon." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:354 + #. type: Content of: <refentry><refsect1><informalexample><programlisting> + #: apt.conf.5.xml:98 + #, no-wrap + msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n" + msgstr "" + + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:101 msgid "" - "Automatic \"no\" to all prompts. Configuration Item: " - "<literal>APT::Get::Assume-No</literal>." + "In general the sample configuration file in " + "<filename>&docdir;examples/apt.conf</filename> &configureindex; is a good " + "guide for how it should look." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:359 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:105 msgid "" - "Show upgraded packages; Print out a list of all packages that are to be " - "upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>." + "Case is not significant in names of configuration items, so in the previous " + "example you could use <literal>dpkg::pre-install-pkgs</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:365 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:108 msgid "" - "Show full versions for upgraded and installed packages. Configuration Item: " - "<literal>APT::Get::Show-Versions</literal>." + "Names for the configuration items are optional if a list is defined as can " + "be seen in the <literal>DPkg::Pre-Install-Pkgs</literal> example above. If " + "you don't specify a name a new entry will simply add a new option to the " + "list. If you specify a name you can override the option in the same way as " + "any other option by reassigning a new value to the option." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:371 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:113 msgid "" - "This option controls the architecture packages are built for by " - "<command>apt-get source --compile</command> and how cross-builddependencies " - "are satisfied. By default is it not set which means that the host " - "architecture is the same as the build architecture (which is defined by " - "<literal>APT::Architecture</literal>). Configuration Item: " - "<literal>APT::Get::Host-Architecture</literal>" + "Two special commands are defined: <literal>#include</literal> (which is " + "deprecated and not supported by alternative implementations) and " + "<literal>#clear</literal>. <literal>#include</literal> will include the " + "given file, unless the filename ends in a slash, in which case the whole " + "directory is included. <literal>#clear</literal> is used to erase a part of " + "the configuration tree. The specified element and all its descendants are " + "erased. (Note that these lines also need to end with a semicolon.)" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:381 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:123 msgid "" - "Compile source packages after downloading them. Configuration Item: " - "<literal>APT::Get::Compile</literal>." + "The <literal>#clear</literal> command is the only way to delete a list or a " + "complete scope. Reopening a scope (or using the syntax described below with " + "an appended <literal>::</literal>) will <emphasis>not</emphasis> override " + "previously written entries. Options can only be overridden by addressing a " + "new value to them - lists and scopes can't be overridden, only cleared." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:386 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:131 msgid "" - "Ignore package Holds; This causes <command>apt-get</command> to ignore a " - "hold placed on a package. This may be useful in conjunction with " - "<literal>dist-upgrade</literal> to override a large number of undesired " - "holds. Configuration Item: <literal>APT::Ignore-Hold</literal>." + "All of the APT tools take an -o option which allows an arbitrary " + "configuration directive to be specified on the command line. The syntax is a " + "full option name (<literal>APT::Get::Assume-Yes</literal> for instance) " + "followed by an equals sign then the new value of the option. To append a new " + "element to a list, add a trailing <literal>::</literal> to the name of the " + "list. (As you might suspect, the scope syntax can't be used on the command " + "line.)" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:393 + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:139 + msgid "" + "Note that appending items to a list using <literal>::</literal> only works " + "for one item per line, and that you should not use it in combination with " + "the scope syntax (which adds <literal>::</literal> implicitly). Using both " + "syntaxes together will trigger a bug which some users unfortunately depend " + "on: an option with the unusual name \"<literal>::</literal>\" which acts " + "like every other option with a name. This introduces many problems; for one " + "thing, users who write multiple lines in this <emphasis>wrong</emphasis> " + "syntax in the hope of appending to a list will achieve the opposite, as only " + "the last assignment for this option \"<literal>::</literal>\" will be " + "used. Future versions of APT will raise errors and stop working if they " + "encounter this misuse, so please correct such statements now while APT " + "doesn't explicitly complain about them." + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt.conf.5.xml:154 + msgid "The APT Group" + msgstr "" + + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:155 msgid "" - "Do not upgrade packages; When used in conjunction with " - "<literal>install</literal>, <literal>no-upgrade</literal> will prevent " - "packages on the command line from being upgraded if they are already " - "installed. Configuration Item: <literal>APT::Get::Upgrade</literal>." + "This group of options controls general APT behavior as well as holding the " + "options for all of the tools." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:400 + #: apt.conf.5.xml:160 msgid "" - "Do not install new packages; When used in conjunction with " - "<literal>install</literal>, <literal>only-upgrade</literal> will install " - "upgrades for already installed packages only and ignore requests to install " - "new packages. Configuration Item: " - "<literal>APT::Get::Only-Upgrade</literal>." + "System Architecture; sets the architecture to use when fetching files and " + "parsing package lists. The internal default is the architecture apt was " + "compiled for." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:408 + #: apt.conf.5.xml:167 msgid "" - "Force yes; This is a dangerous option that will cause apt to continue " - "without prompting if it is doing something potentially harmful. It should " - "not be used except in very special situations. Using " - "<literal>force-yes</literal> can potentially destroy your system! " - "Configuration Item: <literal>APT::Get::force-yes</literal>." + "All Architectures the system supports. For instance, CPUs implementing the " + "<literal>amd64</literal> (also called <literal>x86-64</literal>) " + "instruction set are also able to execute binaries compiled for the " + "<literal>i386</literal> (<literal>x86</literal>) instruction set. This list " + "is used when fetching files and parsing package lists. The initial default " + "is always the system's native architecture " + "(<literal>APT::Architecture</literal>), and foreign architectures are added " + "to the default list when they are registered via <command>dpkg " + "--add-architecture</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:416 + #: apt.conf.5.xml:180 msgid "" - "Instead of fetching the files to install their URIs are printed. Each URI " - "will have the path, the destination file name, the size and the expected md5 " - "hash. Note that the file name to write to will not always match the file " - "name on the remote site! This also works with the <literal>source</literal> " - "and <literal>update</literal> commands. When used with the " - "<literal>update</literal> command the MD5 and size are not included, and it " - "is up to the user to decompress any compressed files. Configuration Item: " - "<literal>APT::Get::Print-URIs</literal>." + "Default release to install packages from if more than one version is " + "available. Contains release name, codename or release version. Examples: " + "'stable', 'testing', 'unstable', '&stable-codename;', '&testing-codename;', " + "'4.0', '5.0*'. See also &apt-preferences;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:427 + #: apt.conf.5.xml:186 msgid "" - "Use purge instead of remove for anything that would be removed. An asterisk " - "(\"*\") will be displayed next to packages which are scheduled to be " - "purged. <option>remove --purge</option> is equivalent to the " - "<option>purge</option> command. Configuration Item: " - "<literal>APT::Get::Purge</literal>." + "Ignore held packages; this global option causes the problem resolver to " + "ignore held packages in its decision making." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:435 + #: apt.conf.5.xml:191 msgid "" - "Re-Install packages that are already installed and at the newest version. " - "Configuration Item: <literal>APT::Get::ReInstall</literal>." + "Defaults to on. When turned on the autoclean feature will remove any " + "packages which can no longer be downloaded from the cache. If turned off " + "then packages that are locally installed are also excluded from cleaning - " + "but note that APT provides no direct means to reinstall them." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:440 + #: apt.conf.5.xml:199 msgid "" - "This option defaults to on, use <literal>--no-list-cleanup</literal> to turn " - "it off. When on <command>apt-get</command> will automatically manage the " - "contents of <filename>&statedir;/lists</filename> to ensure that obsolete " - "files are erased. The only reason to turn it off is if you frequently " - "change your source list. Configuration Item: " - "<literal>APT::Get::List-Cleanup</literal>." + "Defaults to on, which will cause APT to install essential and important " + "packages as soon as possible in an install/upgrade operation, in order to " + "limit the effect of a failing &dpkg; call. If this option is disabled, APT " + "treats an important package in the same way as an extra package: between the " + "unpacking of the package A and its configuration there can be many other " + "unpack or configuration calls for other unrelated packages B, C etc. If " + "these cause the &dpkg; call to fail (e.g. because package B's maintainer " + "scripts generate an error), this results in a system state in which package " + "A is unpacked but unconfigured - so any package depending on A is now no " + "longer guaranteed to work, as its dependency on A is no longer satisfied." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:451 + #: apt.conf.5.xml:211 msgid "" - "This option controls the default input to the policy engine, it creates a " - "default pin at priority 990 using the specified release string. This " - "overrides the general settings in " - "<filename>/etc/apt/preferences</filename>. Specifically pinned packages are " - "not affected by the value of this option. In short, this option lets you " - "have simple control over which distribution packages will be retrieved " - "from. Some common examples might be <option>-t '2.1*'</option>, <option>-t " - "unstable</option> or <option>-t sid</option>. Configuration Item: " - "<literal>APT::Default-Release</literal>; see also the &apt-preferences; " - "manual page." + "The immediate configuration marker is also applied in the potentially " + "problematic case of circular dependencies, since a dependency with the " + "immediate flag is equivalent to a Pre-Dependency. In theory this allows APT " + "to recognise a situation in which it is unable to perform immediate " + "configuration, abort, and suggest to the user that the option should be " + "temporarily deactivated in order to allow the operation to proceed. Note " + "the use of the word \"theory\" here; in the real world this problem has " + "rarely been encountered, in non-stable distribution versions, and was caused " + "by wrong dependencies of the package in question or by a system in an " + "already broken state; so you should not blindly disable this option, as the " + "scenario mentioned above is not the only problem it can help to prevent in " + "the first place." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:466 + #: apt.conf.5.xml:224 msgid "" - "Only perform operations that are 'trivial'. Logically this can be considered " - "related to <option>--assume-yes</option>, where " - "<option>--assume-yes</option> will answer yes to any prompt, " - "<option>--trivial-only</option> will answer no. Configuration Item: " - "<literal>APT::Get::Trivial-Only</literal>." + "Before a big operation like <literal>dist-upgrade</literal> is run with this " + "option disabled you should try to explicitly <literal>install</literal> the " + "package APT is unable to configure immediately; but please make sure you " + "also report your problem to your distribution and to the APT team with the " + "buglink below, so they can work on improving or correcting the upgrade " + "process." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:473 + #: apt.conf.5.xml:235 msgid "" - "If any packages are to be removed apt-get immediately aborts without " - "prompting. Configuration Item: <literal>APT::Get::Remove</literal>." + "Never enable this option unless you <emphasis>really</emphasis> know what " + "you are doing. It permits APT to temporarily remove an essential package to " + "break a Conflicts/Conflicts or Conflicts/Pre-Depends loop between two " + "essential packages. <emphasis>Such a loop should never exist and is a grave " + "bug</emphasis>. This option will work if the essential packages are not " + "<command>tar</command>, <command>gzip</command>, <command>libc</command>, " + "<command>dpkg</command>, <command>dash</command> or anything that those " + "packages depend on." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:479 + #: apt.conf.5.xml:247 msgid "" - "If the command is either <literal>install</literal> or " - "<literal>remove</literal>, then this option acts like running " - "<literal>autoremove</literal> command, removing the unused dependency " - "packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>." + "APT uses since version 0.7.26 a resizable memory mapped cache file to store " + "the available information. <literal>Cache-Start</literal> acts as a hint of " + "the size the cache will grow to, and is therefore the amount of memory APT " + "will request at startup. The default value is 20971520 bytes (~20 MB). Note " + "that this amount of space needs to be available for APT; otherwise it will " + "likely fail ungracefully, so for memory restricted devices this value should " + "be lowered while on systems with a lot of configured sources it should be " + "increased. <literal>Cache-Grow</literal> defines in bytes with the default " + "of 1048576 (~1 MB) how much the cache size will be increased in the event " + "the space defined by <literal>Cache-Start</literal> is not enough. This " + "value will be applied again and again until either the cache is big enough " + "to store all information or the size of the cache reaches the " + "<literal>Cache-Limit</literal>. The default of " + "<literal>Cache-Limit</literal> is 0 which stands for no limit. If " + "<literal>Cache-Grow</literal> is set to 0 the automatic growth of the cache " + "is disabled." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:486 - msgid "" - "Only has meaning for the <literal>source</literal> and " - "<literal>build-dep</literal> commands. Indicates that the given source " - "names are not to be mapped through the binary table. This means that if " - "this option is specified, these commands will only accept source package " - "names as arguments, rather than accepting binary package names and looking " - "up the corresponding source package. Configuration Item: " - "<literal>APT::Get::Only-Source</literal>." + #: apt.conf.5.xml:263 + msgid "Defines which packages are considered essential build dependencies." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:497 + #: apt.conf.5.xml:267 msgid "" - "Download only the diff, dsc, or tar file of a source archive. Configuration " - "Item: <literal>APT::Get::Diff-Only</literal>, " - "<literal>APT::Get::Dsc-Only</literal>, and " - "<literal>APT::Get::Tar-Only</literal>." + "The Get subsection controls the &apt-get; tool; please see its documentation " + "for more information about the options here." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:503 + #: apt.conf.5.xml:272 msgid "" - "Only process architecture-dependent build-dependencies. Configuration Item: " - "<literal>APT::Get::Arch-Only</literal>." + "The Cache subsection controls the &apt-cache; tool; please see its " + "documentation for more information about the options here." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-get.8.xml:508 + #: apt.conf.5.xml:277 msgid "" - "Ignore if packages can't be authenticated and don't prompt about it. This " - "is useful for tools like pbuilder. Configuration Item: " - "<literal>APT::Get::AllowUnauthenticated</literal>." + "The CDROM subsection controls the &apt-cdrom; tool; please see its " + "documentation for more information about the options here." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-get.8.xml:530 - msgid "" - "&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, " - "&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, " - "&apt-preferences;, the APT Howto." + #. type: Content of: <refentry><refsect1><title> + #: apt.conf.5.xml:283 + msgid "The Acquire Group" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-get.8.xml:536 + #: apt.conf.5.xml:284 msgid "" - "<command>apt-get</command> returns zero on normal operation, decimal 100 on " - "error." + "The <literal>Acquire</literal> group of options controls the download of " + "packages as well as the various \"acquire methods\" responsible for the " + "download itself (see also &sources-list;)." msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-key.8.xml:32 - msgid "APT key management utility" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:291 + msgid "" + "Security related option defaulting to true, as giving a Release file's " + "validation an expiration date prevents replay attacks over a long timescale, " + "and can also for example help users to identify mirrors that are no longer " + "updated - but the feature depends on the correctness of the clock on the " + "user system. Archive maintainers are encouraged to create Release files with " + "the <literal>Valid-Until</literal> header, but if they don't or a stricter " + "value is desired the <literal>Max-ValidTime</literal> option below can be " + "used." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-key.8.xml:39 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:304 msgid "" - "<command>apt-key</command> is used to manage the list of keys used by apt to " - "authenticate packages. Packages which have been authenticated using these " - "keys will be considered trusted." + "Maximum time (in seconds) after its creation (as indicated by the " + "<literal>Date</literal> header) that the <filename>Release</filename> file " + "should be considered valid. If the Release file itself includes a " + "<literal>Valid-Until</literal> header the earlier date of the two is used as " + "the expiration date. The default value is <literal>0</literal> which stands " + "for \"valid forever\". Archive specific settings can be made by appending " + "the label of the archive to the option name." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-key.8.xml:45 - msgid "Commands" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:316 + msgid "" + "Minimum time (in seconds) after its creation (as indicated by the " + "<literal>Date</literal> header) that the <filename>Release</filename> file " + "should be considered valid. Use this if you need to use a seldom updated " + "(local) mirror of a more frequently updated archive with a " + "<literal>Valid-Until</literal> header instead of completely disabling the " + "expiration date checking. Archive specific settings can and should be used " + "by appending the label of the archive to the option name." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:50 + #: apt.conf.5.xml:328 msgid "" - "Add a new key to the list of trusted keys. The key is read from the " - "filename given with the parameter &synopsis-param-filename; or if the " - "filename is <literal>-</literal> from standard input." + "Try to download deltas called <literal>PDiffs</literal> for indexes (like " + "<filename>Packages</filename> files) instead of downloading whole ones. True " + "by default." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:63 - msgid "Remove a key from the list of trusted keys." + #: apt.conf.5.xml:331 + msgid "" + "Two sub-options to limit the use of PDiffs are also available: " + "<literal>FileLimit</literal> can be used to specify a maximum number of " + "PDiff files should be downloaded to update a " + "file. <literal>SizeLimit</literal> on the other hand is the maximum " + "percentage of the size of all patches compared to the size of the targeted " + "file. If one of these limits is exceeded the complete file is downloaded " + "instead of the patches." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:74 - msgid "Output the key &synopsis-param-keyid; to standard output." + #: apt.conf.5.xml:341 + msgid "" + "Queuing mode; <literal>Queue-Mode</literal> can be one of " + "<literal>host</literal> or <literal>access</literal> which determines how " + "APT parallelizes outgoing connections. <literal>host</literal> means that " + "one connection per target host will be opened, <literal>access</literal> " + "means that one connection per URI type will be opened." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:85 - msgid "Output all trusted keys to standard output." + #: apt.conf.5.xml:349 + msgid "" + "Number of retries to perform. If this is non-zero APT will retry failed " + "files the given number of times." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:96 - msgid "List trusted keys." + #: apt.conf.5.xml:354 + msgid "" + "Use symlinks for source archives. If set to true then source archives will " + "be symlinked when possible instead of copying. True is the default." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:107 - msgid "List fingerprints of trusted keys." + #: apt.conf.5.xml:359 + msgid "" + "<literal>http::Proxy</literal> sets the default proxy to use for HTTP " + "URIs. It is in the standard form of " + "<literal>http://[[user][:pass]@]host[:port]/</literal>. Per host proxies " + "can also be specified by using the form " + "<literal>http::Proxy::<host></literal> with the special keyword " + "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above " + "settings is specified, <envar>http_proxy</envar> environment variable will " + "be used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:118 + #: apt.conf.5.xml:367 msgid "" - "Pass advanced options to gpg. With adv --recv-key you can download the " - "public key." + "Three settings are provided for cache control with HTTP/1.1 compliant proxy " + "caches. <literal>No-Cache</literal> tells the proxy not to use its cached " + "response under any circumstances. <literal>Max-Age</literal> sets the " + "allowed maximum age (in seconds) of an index file in the cache of the " + "proxy. <literal>No-Store</literal> specifies that the proxy should not " + "store the requested archive files in its cache, which can be used to prevent " + "the proxy from polluting its cache with (big) .deb files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:130 + #: apt.conf.5.xml:377 apt.conf.5.xml:449 msgid "" - "Update the local keyring with the archive keyring and remove from the local " - "keyring the archive keys which are no longer valid. The archive keyring is " - "shipped in the <literal>archive-keyring</literal> package of your " - "distribution, e.g. the <literal>debian-archive-keyring</literal> package in " - "Debian." + "The option <literal>timeout</literal> sets the timeout timer used by the " + "method; this value applies to the connection as well as the data timeout." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:144 + #: apt.conf.5.xml:380 msgid "" - "Work similar to the <command>update</command> command above, but get the " - "archive keyring from an URI instead and validate it against a master key. " - "This requires an installed &wget; and an APT build configured to have a " - "server to fetch from and a master keyring to validate. APT in Debian does " - "not support this command and relies on <command>update</command> instead, " - "but Ubuntu's APT does." + "The setting <literal>Acquire::http::Pipeline-Depth</literal> can be used to " + "enable HTTP pipelining (RFC 2616 section 8.1.2.2) which can be beneficial " + "e.g. on high-latency connections. It specifies how many requests are sent in " + "a pipeline. Previous APT versions had a default of 10 for this setting, but " + "the default value is now 0 (= disabled) to avoid problems with the " + "ever-growing amount of webservers and proxies which choose to not conform to " + "the HTTP/1.1 specification." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-key.8.xml:161 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:387 msgid "" - "Note that options need to be defined before the commands described in the " - "previous section." + "<literal>Acquire::http::AllowRedirect</literal> controls whether APT will " + "follow redirects, which is enabled by default." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:164 + #: apt.conf.5.xml:390 msgid "" - "With this option it is possible to specify a specific keyring file the " - "command should operate on. The default is that a command is executed on the " - "<filename>trusted.gpg</filename> file as well as on all parts in the " - "<filename>trusted.gpg.d</filename> directory, though " - "<filename>trusted.gpg</filename> is the primary keyring which means that " - "e.g. new keys are added to this one." + "The used bandwidth can be limited with " + "<literal>Acquire::http::Dl-Limit</literal> which accepts integer values in " + "kilobytes. The default value is 0 which deactivates the limit and tries to " + "use all available bandwidth (note that this option implicitly disables " + "downloading from multiple servers at the same time.)" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> - #: apt-key.8.xml:179 - msgid "<filename>/etc/apt/trustdb.gpg</filename>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:395 + msgid "" + "<literal>Acquire::http::User-Agent</literal> can be used to set a different " + "User-Agent for the http download method as some proxies allow access for " + "clients only if the client uses a known identifier." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:180 - msgid "Local trust database of archive keys." + #: apt.conf.5.xml:403 + msgid "" + "The <literal>Cache-control</literal>, <literal>Timeout</literal>, " + "<literal>AllowRedirect</literal>, <literal>Dl-Limit</literal> and " + "<literal>proxy</literal> options work for HTTPS URIs in the same way as for " + "the <literal>http</literal> method, and default to the same values if they " + "are not explicitly set. The <literal>Pipeline-Depth</literal> option is not " + "yet supported." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> - #: apt-key.8.xml:183 - msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:411 + msgid "" + "<literal>CaInfo</literal> suboption specifies place of file that holds info " + "about trusted certificates. <literal><host>::CaInfo</literal> is the " + "corresponding per-host option. <literal>Verify-Peer</literal> boolean " + "suboption determines whether or not the server's host certificate should be " + "verified against trusted certificates. " + "<literal><host>::Verify-Peer</literal> is the corresponding per-host " + "option. <literal>Verify-Host</literal> boolean suboption determines whether " + "or not the server's hostname should be verified. " + "<literal><host>::Verify-Host</literal> is the corresponding per-host " + "option. <literal>SslCert</literal> determines what certificate to use for " + "client authentication. <literal><host>::SslCert</literal> is the " + "corresponding per-host option. <literal>SslKey</literal> determines what " + "private key to use for client " + "authentication. <literal><host>::SslKey</literal> is the corresponding " + "per-host option. <literal>SslForceVersion</literal> overrides default SSL " + "version to use. It can contain either of the strings " + "'<literal>TLSv1</literal>' or '<literal>SSLv3</literal>'. " + "<literal><host>::SslForceVersion</literal> is the corresponding " + "per-host option." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:184 - msgid "Keyring of Debian archive trusted keys." + #: apt.conf.5.xml:432 + msgid "" + "<literal>ftp::Proxy</literal> sets the default proxy to use for FTP URIs. " + "It is in the standard form of " + "<literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host proxies can " + "also be specified by using the form " + "<literal>ftp::Proxy::<host></literal> with the special keyword " + "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above " + "settings is specified, <envar>ftp_proxy</envar> environment variable will be " + "used. To use an FTP proxy you will have to set the " + "<literal>ftp::ProxyLogin</literal> script in the configuration file. This " + "entry specifies the commands to send to tell the proxy server what to " + "connect to. Please see &configureindex; for an example of how to do " + "this. The substitution variables representing the corresponding URI " + "component are <literal>$(PROXY_USER)</literal>, " + "<literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, " + "<literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal> and " + "<literal>$(SITE_PORT)</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> - #: apt-key.8.xml:187 - msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:452 + msgid "" + "Several settings are provided to control passive mode. Generally it is safe " + "to leave passive mode on; it works in nearly every environment. However, " + "some situations require that passive mode be disabled and port mode FTP used " + "instead. This can be done globally or for connections that go through a " + "proxy or for a specific host (see the sample config file for examples)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-key.8.xml:188 - msgid "Keyring of Debian archive removed trusted keys." + #: apt.conf.5.xml:459 + msgid "" + "It is possible to proxy FTP over HTTP by setting the " + "<envar>ftp_proxy</envar> environment variable to an HTTP URL - see the " + "discussion of the http method above for syntax. You cannot set this in the " + "configuration file and it is not recommended to use FTP over HTTP due to its " + "low efficiency." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-key.8.xml:197 - msgid "&apt-get;, &apt-secure;" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:464 + msgid "" + "The setting <literal>ForceExtended</literal> controls the use of RFC2428 " + "<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is " + "false, which means these commands are only used if the control connection is " + "IPv6. Setting this to true forces their use even on IPv4 connections. Note " + "that most FTP servers do not support RFC2428." msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-mark.8.xml:33 - msgid "mark/unmark a package as being automatically-installed" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><literallayout> + #: apt.conf.5.xml:478 + #, no-wrap + msgid "/cdrom/::Mount \"foo\";" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-mark.8.xml:39 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:473 msgid "" - "<command>apt-mark</command> will change whether a package has been marked as " - "being automatically installed." + "For URIs using the <literal>cdrom</literal> method, the only configurable " + "option is the mount point, <literal>cdrom::Mount</literal>, which must be " + "the mount point for the CD-ROM (or DVD, or whatever) drive as specified in " + "<filename>/etc/fstab</filename>. It is possible to provide alternate mount " + "and unmount commands if your mount point cannot be listed in the fstab. The " + "syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the " + "<literal>cdrom</literal> block. It is important to have the trailing slash. " + "Unmount commands can be specified using UMount." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-mark.8.xml:43 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:486 msgid "" - "When you request that a package is installed, and as a result other packages " - "are installed to satisfy its dependencies, the dependencies are marked as " - "being automatically installed. Once these automatically installed packages " - "are no longer depended on by any manually installed packages, they will be " - "removed by e.g. <command>apt-get</command> or <command>aptitude</command>." + "For GPGV URIs the only configurable option is " + "<literal>gpgv::Options</literal>, which passes additional parameters to " + "gpgv." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:52 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis> + #: apt.conf.5.xml:497 + #, no-wrap msgid "" - "<literal>auto</literal> is used to mark a package as being automatically " - "installed, which will cause the package to be removed when no more manually " - "installed packages depend on this package." + "Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> " + "\"<replaceable>Methodname</replaceable>\";" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:60 + #: apt.conf.5.xml:492 msgid "" - "<literal>manual</literal> is used to mark a package as being manually " - "installed, which will prevent the package from being automatically removed " - "if no other packages depend on it." + "List of compression types which are understood by the acquire methods. " + "Files like <filename>Packages</filename> can be available in various " + "compression formats. By default the acquire methods can decompress " + "<command>bzip2</command>, <command>lzma</command> and " + "<command>gzip</command> compressed files; with this setting more formats can " + "be added on the fly or the used method can be changed. The syntax for this " + "is: <placeholder type=\"synopsis\" id=\"0\"/>" + msgstr "" + + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis> + #: apt.conf.5.xml:502 + #, no-wrap + msgid "Acquire::CompressionTypes::Order:: \"gz\";" + msgstr "" + + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis> + #: apt.conf.5.xml:505 + #, no-wrap + msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:68 + #: apt.conf.5.xml:498 msgid "" - "<literal>hold</literal> is used to mark a package as hold back, which will " - "prevent the package from being automatically installed, upgraded or " - "removed. The command is only a wrapper around <command>dpkg " - "--set-selections</command> and the state is therefore maintained by &dpkg; " - "and not effected by the <option>--filename</option> option." + "Also, the <literal>Order</literal> subgroup can be used to define in which " + "order the acquire system will try to download the compressed files. The " + "acquire system will try the first and proceed with the next compression type " + "in this list on error, so to prefer one over the other type simply add the " + "preferred type first - default types not already added will be implicitly " + "appended to the end of the list, so e.g. <placeholder type=\"synopsis\" " + "id=\"0\"/> can be used to prefer <command>gzip</command> compressed files " + "over <command>bzip2</command> and <command>lzma</command>. If " + "<command>lzma</command> should be preferred over <command>gzip</command> and " + "<command>bzip2</command> the configure setting should look like this: " + "<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add " + "<literal>bz2</literal> to the list explicitly as it will be added " + "automatically." + msgstr "" + + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><literallayout> + #: apt.conf.5.xml:512 + #, no-wrap + msgid "Dir::Bin::bzip2 \"/bin/bzip2\";" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:78 + #: apt.conf.5.xml:507 msgid "" - "<literal>unhold</literal> is used to cancel a previously set hold on a " - "package to allow all actions again." + "Note that the " + "<literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be " + "checked at run time. If this option has been set, the method will only be " + "used if this file exists; e.g. for the <literal>bzip2</literal> method (the " + "inbuilt) setting is: <placeholder type=\"literallayout\" id=\"0\"/> Note " + "also that list entries specified on the command line will be added at the " + "end of the list specified in the configuration files, but before the default " + "entries. To prefer a type in this case over the ones specified in the " + "configuration files you can set the option direct - not in list style. This " + "will not override the defined list; it will only prefix the list with this " + "type." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:84 + #: apt.conf.5.xml:517 msgid "" - "<literal>showauto</literal> is used to print a list of automatically " - "installed packages with each package on a new line. All automatically " - "installed packages will be listed if no package is given. If packages are " - "given only those which are automatically installed will be shown." + "The special type <literal>uncompressed</literal> can be used to give " + "uncompressed files a preference, but note that most archives don't provide " + "uncompressed files so this is mostly only useable for local mirrors." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:92 + #: apt.conf.5.xml:524 msgid "" - "<literal>showmanual</literal> can be used in the same way as " - "<literal>showauto</literal> except that it will print a list of manually " - "installed packages instead." + "When downloading <literal>gzip</literal> compressed indexes (Packages, " + "Sources, or Translations), keep them gzip compressed locally instead of " + "unpacking them. This saves quite a lot of disk space at the expense of more " + "CPU requirements when building the local package caches. False by default." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:99 + #: apt.conf.5.xml:532 msgid "" - "<literal>showhold</literal> is used to print a list of packages on hold in " - "the same way as for the other show commands." + "The Languages subsection controls which <filename>Translation</filename> " + "files are downloaded and in which order APT tries to display the " + "description-translations. APT will try to display the first available " + "description in the language which is listed first. Languages can be defined " + "with their short or long language codes. Note that not all archives provide " + "<filename>Translation</filename> files for every language - the long " + "language codes are especially rare." + msgstr "" + + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><programlisting> + #: apt.conf.5.xml:549 + #, no-wrap + msgid "Acquire::Languages { \"environment\"; \"de\"; \"en\"; \"none\"; \"fr\"; };" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-mark.8.xml:115 + #: apt.conf.5.xml:537 msgid "" - "Read/Write package stats from the filename given with the parameter " - "&synopsis-param-filename; instead of from the default location, which is " - "<filename>extended_status</filename> in the directory defined by the " - "Configuration Item: <literal>Dir::State</literal>." + "The default list includes \"environment\" and " + "\"en\". \"<literal>environment</literal>\" has a special meaning here: it " + "will be replaced at runtime with the language codes extracted from the " + "<literal>LC_MESSAGES</literal> environment variable. It will also ensure " + "that these codes are not included twice in the list. If " + "<literal>LC_MESSAGES</literal> is set to \"C\" only the " + "<filename>Translation-en</filename> file (if available) will be used. To " + "force APT to use no Translation file use the setting " + "<literal>Acquire::Languages=none</literal>. \"<literal>none</literal>\" is " + "another special meaning code which will stop the search for a suitable " + "<filename>Translation</filename> file. This tells APT to download these " + "translations too, without actually using them unless the environment " + "specifies the languages. So the following example configuration will result " + "in the order \"en, de\" in an English locale or \"de, en\" in a German " + "one. Note that \"fr\" is downloaded, but not used unless APT is used in a " + "French locale (where the order would be \"fr, de, en\"). <placeholder " + "type=\"programlisting\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-mark.8.xml:136 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:550 msgid "" - "<command>apt-mark</command> returns zero on normal operation, non-zero on " - "error." + "Note: To prevent problems resulting from APT being executed in different " + "environments (e.g. by different users or by other programs) all Translation " + "files which are found in <filename>/var/lib/apt/lists/</filename> will be " + "added to the end of the list (after an implicit " + "\"<literal>none</literal>\")." msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-secure.8.xml:47 - msgid "Archive authentication support for APT" + #. type: Content of: <refentry><refsect1><title> + #: apt.conf.5.xml:560 + msgid "Directories" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:52 + #: apt.conf.5.xml:562 msgid "" - "Starting with version 0.6, <command>apt</command> contains code that does " - "signature checking of the Release file for all archives. This ensures that " - "packages in the archive can't be modified by people who have no access to " - "the Release file signing key." + "The <literal>Dir::State</literal> section has directories that pertain to " + "local state information. <literal>lists</literal> is the directory to place " + "downloaded package lists in and <literal>status</literal> is the name of the " + "&dpkg; status file. <literal>preferences</literal> is the name of the APT " + "<filename>preferences</filename> file. <literal>Dir::State</literal> " + "contains the default directory to prefix on all sub-items if they do not " + "start with <filename>/</filename> or <filename>./</filename>." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:60 + #: apt.conf.5.xml:569 msgid "" - "If a package comes from a archive without a signature or with a signature " - "that apt does not have a key for that package is considered untrusted and " - "installing it will result in a big warning. <command>apt-get</command> will " - "currently only warn for unsigned archives, future releases might force all " - "sources to be verified before downloading packages from them." - msgstr "" - - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:69 - msgid "" - "The package frontends &apt-get;, &aptitude; and &synaptic; support this new " - "authentication feature." + "<literal>Dir::Cache</literal> contains locations pertaining to local cache " + "information, such as the two package caches <literal>srcpkgcache</literal> " + "and <literal>pkgcache</literal> as well as the location to place downloaded " + "archives, <literal>Dir::Cache::archives</literal>. Generation of caches can " + "be turned off by setting their names to the empty string. This will slow " + "down startup but save disk space. It is probably preferable to turn off the " + "pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the " + "default directory is contained in <literal>Dir::Cache</literal>" msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-secure.8.xml:74 - msgid "Trusted archives" + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:578 + msgid "" + "<literal>Dir::Etc</literal> contains the location of configuration files, " + "<literal>sourcelist</literal> gives the location of the sourcelist and " + "<literal>main</literal> is the default configuration file (setting has no " + "effect, unless it is done from the config file specified by " + "<envar>APT_CONFIG</envar>)." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:77 + #: apt.conf.5.xml:584 msgid "" - "The chain of trust from an apt archive to the end user is made up of " - "different steps. <command>apt-secure</command> is the last step in this " - "chain, trusting an archive does not mean that the packages that you trust it " - "do not contain malicious code but means that you trust the archive " - "maintainer. It's the archive maintainer responsibility to ensure that the " - "archive integrity is correct." + "The <literal>Dir::Parts</literal> setting reads in all the config fragments " + "in lexical order from the directory specified. After this is done then the " + "main config file is loaded." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:85 + #: apt.conf.5.xml:588 msgid "" - "apt-secure does not review signatures at a package level. If you require " - "tools to do this you should look at <command>debsig-verify</command> and " - "<command>debsign</command> (provided in the debsig-verify and devscripts " - "packages respectively)." + "Binary programs are pointed to by " + "<literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies " + "the location of the method handlers and <literal>gzip</literal>, " + "<literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, " + "<literal>apt-get</literal> <literal>dpkg-source</literal> " + "<literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> " + "specify the location of the respective programs." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:92 + #: apt.conf.5.xml:596 msgid "" - "The chain of trust in Debian starts when a maintainer uploads a new package " - "or a new version of a package to the Debian archive. This upload in order to " - "become effective needs to be signed by a key of a maintainer within the " - "Debian maintainer's keyring (available in the debian-keyring " - "package). Maintainer's keys are signed by other maintainers following " - "pre-established procedures to ensure the identity of the key holder." + "The configuration item <literal>RootDir</literal> has a special meaning. If " + "set, all paths in <literal>Dir::</literal> will be relative to " + "<literal>RootDir</literal>, <emphasis>even paths that are specified " + "absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is " + "set to <filename>/tmp/staging</filename> and " + "<literal>Dir::State::status</literal> is set to " + "<filename>/var/lib/dpkg/status</filename>, then the status file will be " + "looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:102 + #: apt.conf.5.xml:609 msgid "" - "Once the uploaded package is verified and included in the archive, the " - "maintainer signature is stripped off, an MD5 sum of the package is computed " - "and put in the Packages file. The MD5 sum of all of the packages files are " - "then computed and put into the Release file. The Release file is then signed " - "by the archive key (which is created once a year) and distributed through " - "the FTP server. This key is also on the Debian keyring." + "The <literal>Ignore-Files-Silently</literal> list can be used to specify " + "which files APT should silently ignore while parsing the files in the " + "fragment directories. Per default a file which end with " + "<literal>.disabled</literal>, <literal>~</literal>, <literal>.bak</literal> " + "or <literal>.dpkg-[a-z]+</literal> is silently ignored. As seen in the last " + "default value these patterns can use regular expression syntax." + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt.conf.5.xml:618 + msgid "APT in DSelect" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:112 + #: apt.conf.5.xml:620 msgid "" - "Any end user can check the signature of the Release file, extract the MD5 " - "sum of a package from it and compare it with the MD5 sum of the package he " - "downloaded. Prior to version 0.6 only the MD5 sum of the downloaded Debian " - "package was checked. Now both the MD5 sum and the signature of the Release " - "file are checked." + "When APT is used as a &dselect; method several configuration directives " + "control the default behavior. These are in the <literal>DSelect</literal> " + "section." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:119 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:625 msgid "" - "Notice that this is distinct from checking signatures on a per package " - "basis. It is designed to prevent two possible attacks:" + "Cache Clean mode; this value may be one of <literal>always</literal>, " + "<literal>prompt</literal>, <literal>auto</literal>, " + "<literal>pre-auto</literal> and <literal>never</literal>. " + "<literal>always</literal> and <literal>prompt</literal> will remove all " + "packages from the cache after upgrading, <literal>prompt</literal> (the " + "default) does so conditionally. <literal>auto</literal> removes only those " + "packages which are no longer downloadable (replaced with a new version for " + "instance). <literal>pre-auto</literal> performs this action before " + "downloading new packages." msgstr "" - #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> - #: apt-secure.8.xml:124 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:639 msgid "" - "<literal>Network \"man in the middle\" attacks</literal>. Without signature " - "checking, a malicious agent can introduce himself in the package download " - "process and provide malicious software either by controlling a network " - "element (router, switch, etc.) or by redirecting traffic to a rogue server " - "(through arp or DNS spoofing attacks)." + "The contents of this variable are passed to &apt-get; as command line " + "options when it is run for the install phase." msgstr "" - #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> - #: apt-secure.8.xml:132 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:644 msgid "" - "<literal>Mirror network compromise</literal>. Without signature checking, a " - "malicious agent can compromise a mirror host and modify the files in it to " - "propagate malicious software to all users downloading packages from that " - "host." + "The contents of this variable are passed to &apt-get; as command line " + "options when it is run for the update phase." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:139 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:649 msgid "" - "However, it does not defend against a compromise of the Debian master server " - "itself (which signs the packages) or against a compromise of the key used to " - "sign the Release files. In any case, this mechanism can complement a " - "per-package signature." + "If true the [U]pdate operation in &dselect; will always prompt to continue. " + "The default is to prompt only on error." msgstr "" #. type: Content of: <refentry><refsect1><title> - #: apt-secure.8.xml:145 - msgid "User configuration" + #: apt.conf.5.xml:655 + msgid "How APT calls &dpkg;" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:147 + #: apt.conf.5.xml:656 msgid "" - "<command>apt-key</command> is the program that manages the list of keys used " - "by apt. It can be used to add or remove keys although an installation of " - "this release will automatically provide the default Debian archive signing " - "keys used in the Debian package repositories." + "Several configuration directives control how APT invokes &dpkg;. These are " + "in the <literal>DPkg</literal> section." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:154 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:661 msgid "" - "In order to add a new key you need to first download it (you should make " - "sure you are using a trusted communication channel when retrieving it), add " - "it with <command>apt-key</command> and then run <command>apt-get " - "update</command> so that apt can download and verify the " - "<filename>InRelease</filename> or <filename>Release.gpg</filename> files " - "from the archives you have configured." - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt-secure.8.xml:163 - msgid "Archive configuration" + "This is a list of options to pass to &dpkg;. The options must be specified " + "using the list notation and each list item is passed as a single argument to " + "&dpkg;." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:165 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:667 msgid "" - "If you want to provide archive signatures in an archive under your " - "maintenance you have to:" + "This is a list of shell commands to run before/after invoking &dpkg;. Like " + "<literal>options</literal> this must be specified in list notation. The " + "commands are invoked in order using <filename>/bin/sh</filename>; should any " + "fail APT will abort." msgstr "" - #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> - #: apt-secure.8.xml:170 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:674 msgid "" - "<emphasis>Create a toplevel Release file</emphasis>, if it does not exist " - "already. You can do this by running <command>apt-ftparchive " - "release</command> (provided in apt-utils)." + "This is a list of shell commands to run before invoking &dpkg;. Like " + "<literal>options</literal> this must be specified in list notation. The " + "commands are invoked in order using <filename>/bin/sh</filename>; should any " + "fail APT will abort. APT will pass the filenames of all .deb files it is " + "going to install to the commands, one per line on standard input." msgstr "" - #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> - #: apt-secure.8.xml:175 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:680 msgid "" - "<emphasis>Sign it</emphasis>. You can do this by running <command>gpg " - "--clearsign -o InRelease Release</command> and <command>gpg -abs -o " - "Release.gpg Release</command>." + "Version 2 of this protocol dumps more information, including the protocol " + "version, the APT configuration space and the packages, files and versions " + "being changed. Version 2 is enabled by setting " + "<literal>DPkg::Tools::options::cmd::Version</literal> to " + "2. <literal>cmd</literal> is a command given to " + "<literal>Pre-Install-Pkgs</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> - #: apt-secure.8.xml:179 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:688 msgid "" - "<emphasis>Publish the key fingerprint</emphasis>, that way your users will " - "know what key they need to import in order to authenticate the files in the " - "archive." + "APT chdirs to this directory before invoking &dpkg;, the default is " + "<filename>/</filename>." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:186 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:693 msgid "" - "Whenever the contents of the archive changes (new packages are added or " - "removed) the archive maintainer has to follow the first two steps previously " - "outlined." + "These options are passed to &dpkg-buildpackage; when compiling packages; the " + "default is to disable signing and produce all binaries." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:194 - msgid "" - "&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, " - "&debsign; &debsig-verify;, &gpg;" + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt.conf.5.xml:698 + msgid "dpkg trigger usage (and related options)" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:198 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt.conf.5.xml:699 msgid "" - "For more background information you might want to review the <ulink " - "url=\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian " - "Security Infrastructure</ulink> chapter of the Securing Debian Manual " - "(available also in the harden-doc package) and the <ulink " - "url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong " - "Distribution HOWTO</ulink> by V. Alex Brennen." + "APT can call &dpkg; in such a way as to let it make aggressive use of " + "triggers over multiple calls of &dpkg;. Without further options &dpkg; will " + "use triggers once each time it runs. Activating these options can therefore " + "decrease the time needed to perform the install or upgrade. Note that it is " + "intended to activate these options per default in the future, but as it " + "drastically changes the way APT calls &dpkg; it needs a lot more testing. " + "<emphasis>These options are therefore currently experimental and should not " + "be used in production environments.</emphasis> It also breaks progress " + "reporting such that all front-ends will currently stay around half (or more) " + "of the time in the 100% state while it actually configures all packages." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt-secure.8.xml:211 - msgid "Manpage Authors" + #. type: Content of: <refentry><refsect1><refsect2><para><literallayout> + #: apt.conf.5.xml:714 + #, no-wrap + msgid "" + "DPkg::NoTriggers \"true\";\n" + "PackageManager::Configure \"smart\";\n" + "DPkg::ConfigurePending \"true\";\n" + "DPkg::TriggersPending \"true\";" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-secure.8.xml:213 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt.conf.5.xml:708 msgid "" - "This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac " - "Jones, Colin Walters, Florian Weimer and Michael Vogt." + "Note that it is not guaranteed that APT will support these options or that " + "these options will not cause (big) trouble in the future. If you have " + "understand the current risks and problems with these options, but are brave " + "enough to help testing them, create a new configuration file and test a " + "combination of options. Please report any bugs, problems and improvements " + "you encounter and make sure to note which options you have used in your " + "reports. Asking &dpkg; for help could also be useful for debugging proposes, " + "see e.g. <command>dpkg --audit</command>. A defensive option combination " + "would be <placeholder type=\"literallayout\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt-sortpkgs.1.xml:33 - msgid "Utility to sort package index files" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:721 + msgid "" + "Add the no triggers flag to all &dpkg; calls (except the ConfigurePending " + "call). See &dpkg; if you are interested in what this actually means. In " + "short: &dpkg; will not run the triggers when this flag is present unless it " + "is explicitly called to do so in an extra call. Note that this option " + "exists (undocumented) also in older APT versions with a slightly different " + "meaning: Previously these option only append --no-triggers to the configure " + "calls to &dpkg; - now APT will also add this flag to the unpack and remove " + "calls." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-sortpkgs.1.xml:39 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:729 msgid "" - "<command>apt-sortpkgs</command> will take an index file (Source index or " - "Package index) and sort the records so that they are ordered by the package " - "name. It will also sort the internal fields of each record according to the " - "internal sorting rules." + "Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" " + "and \"<literal>no</literal>\". The default value is " + "\"<literal>all</literal>\", which causes APT to configure all packages. The " + "\"<literal>smart</literal>\" way is to configure only packages which need to " + "be configured before another package can be unpacked (Pre-Depends), and let " + "the rest be configured by &dpkg; with a call generated by the " + "ConfigurePending option (see below). On the other hand, " + "\"<literal>no</literal>\" will not configure anything, and totally relies on " + "&dpkg; for configuration (which at the moment will fail if a Pre-Depends is " + "encountered). Setting this option to any value other than " + "<literal>all</literal> will implicitly also activate the next option by " + "default, as otherwise the system could end in an unconfigured and " + "potentially unbootable state." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-sortpkgs.1.xml:45 - msgid "All output is sent to stdout, the input must be a seekable file." + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:744 + msgid "" + "If this option is set APT will call <command>dpkg --configure " + "--pending</command> to let &dpkg; handle all required configurations and " + "triggers. This option is activated automatically per default if the previous " + "option is not set to <literal>all</literal>, but deactivating it could be " + "useful if you want to run APT multiple times in a row - e.g. in an " + "installer. In these sceneries you could deactivate this option in all but " + "the last run." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt-sortpkgs.1.xml:54 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:751 msgid "" - "Use Source index field ordering. Configuration Item: " - "<literal>APT::SortPkgs::Source</literal>." + "Useful for the <literal>smart</literal> configuration as a package which has " + "pending triggers is not considered as <literal>installed</literal>, and " + "&dpkg; treats them as <literal>unpacked</literal> currently which is a " + "showstopper for Pre-Dependencies (see debbugs #526774). Note that this will " + "process all triggers, not only the triggers needed to configure this " + "package." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt-sortpkgs.1.xml:68 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout> + #: apt.conf.5.xml:764 + #, no-wrap msgid "" - "<command>apt-sortpkgs</command> returns zero on normal operation, decimal " - "100 on error." + "OrderList::Score {\n" + "\tDelete 500;\n" + "\tEssential 200;\n" + "\tImmediate 10;\n" + "\tPreDepends 50;\n" + "};" msgstr "" - #. type: Content of: <refentry><refentryinfo><author><contrib> - #: apt.conf.5.xml:20 - msgid "Initial documentation of Debug::*." + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:757 + msgid "" + "Essential packages (and their dependencies) should be configured immediately " + "after unpacking. It is a good idea to do this quite early in the upgrade " + "process as these configure calls also currently require " + "<literal>DPkg::TriggersPending</literal> which will run quite a few triggers " + "(which may not be needed). Essentials get per default a high score but the " + "immediate flag is relatively low (a package which has a Pre-Depends is rated " + "higher). These option and the others in the same group can be used to " + "change the scoring. The following example shows the settings with their " + "default values. <placeholder type=\"literallayout\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refentryinfo><author><email> - #: apt.conf.5.xml:21 - msgid "dburrows@debian.org" + #. type: Content of: <refentry><refsect1><title> + #: apt.conf.5.xml:777 + msgid "Periodic and Archives options" msgstr "" - #. type: Content of: <refentry><refmeta><manvolnum> - #: apt.conf.5.xml:31 apt_preferences.5.xml:25 sources.list.5.xml:26 - msgid "5" + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:778 + msgid "" + "<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups " + "of options configure behavior of apt periodic updates, which is done by the " + "<literal>/etc/cron.daily/apt</literal> script. See the top of this script " + "for the brief documentation of these options." msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt.conf.5.xml:38 - msgid "Configuration file for APT" + #. type: Content of: <refentry><refsect1><title> + #: apt.conf.5.xml:786 + msgid "Debug options" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:42 + #: apt.conf.5.xml:788 msgid "" - "<filename>apt.conf</filename> is the main configuration file for the APT " - "suite of tools, but by far not the only place changes to options can be " - "made. All tools therefore share the configuration files and also use a " - "common command line parser to provide a uniform environment." + "Enabling options in the <literal>Debug::</literal> section will cause " + "debugging information to be sent to the standard error stream of the program " + "utilizing the <literal>apt</literal> libraries, or enable special program " + "modes that are primarily useful for debugging the behavior of " + "<literal>apt</literal>. Most of these options are not interesting to a " + "normal user, but a few may be:" msgstr "" - #. type: Content of: <refentry><refsect1><orderedlist><para> - #: apt.conf.5.xml:47 + #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> + #: apt.conf.5.xml:799 msgid "" - "When an APT tool starts up it will read the configuration files in the " - "following order:" + "<literal>Debug::pkgProblemResolver</literal> enables output about the " + "decisions made by <literal>dist-upgrade, upgrade, install, remove, " + "purge</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> - #: apt.conf.5.xml:49 + #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> + #: apt.conf.5.xml:807 msgid "" - "the file specified by the <envar>APT_CONFIG</envar> environment variable (if " - "any)" + "<literal>Debug::NoLocking</literal> disables all file locking. This can be " + "used to run some operations (for instance, <literal>apt-get -s " + "install</literal>) as a non-root user." msgstr "" - #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> - #: apt.conf.5.xml:51 + #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> + #: apt.conf.5.xml:816 msgid "" - "all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending " - "order which have either no or \"<literal>conf</literal>\" as filename " - "extension and which only contain alphanumeric, hyphen (-), underscore (_) " - "and period (.) characters. Otherwise APT will print a notice that it has " - "ignored a file if the file doesn't match a pattern in the " - "<literal>Dir::Ignore-Files-Silently</literal> configuration list - in this " - "case it will be silently ignored." - msgstr "" - - #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> - #: apt.conf.5.xml:58 - msgid "the main configuration file specified by <literal>Dir::Etc::main</literal>" + "<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each " + "time that <literal>apt</literal> invokes &dpkg;." msgstr "" - #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> - #: apt.conf.5.xml:60 + #. TODO: provide a + #. motivating example, except I haven't a clue why you'd want + #. to do this. + #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> + #: apt.conf.5.xml:824 msgid "" - "the command line options are applied to override the configuration " - "directives or to load even more configuration files." - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:64 - msgid "Syntax" + "<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data " + "in CD-ROM IDs." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:65 - msgid "" - "The configuration file is organized in a tree with options organized into " - "functional groups. Option specification is given with a double colon " - "notation, for instance <literal>APT::Get::Assume-Yes</literal> is an option " - "within the APT tool group, for the Get tool. Options do not inherit from " - "their parent groups." + #: apt.conf.5.xml:834 + msgid "A full list of debugging options to apt follows." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:71 - msgid "" - "Syntactically the configuration language is modeled after what the ISC tools " - "such as bind and dhcp use. Lines starting with <literal>//</literal> are " - "treated as comments (ignored), as well as all text between " - "<literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments. " - "Each line is of the form <literal>APT::Get::Assume-Yes " - "\"true\";</literal>. The trailing semicolon and the quotes are required. The " - "value must be on one line, and there is no kind of string concatenation. It " - "must not include inside quotes. The behavior of the backslash \"\\\" and " - "escaped characters inside a value is undefined and it should not be used. An " - "option name may include alphanumerical characters and the \"/-:._+\" " - "characters. A new scope can be opened with curly braces, like:" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:843 + msgid "Print information related to accessing <literal>cdrom://</literal> sources." msgstr "" - #. type: Content of: <refentry><refsect1><informalexample><programlisting> - #: apt.conf.5.xml:85 - #, no-wrap - msgid "" - "APT {\n" - " Get {\n" - " Assume-Yes \"true\";\n" - " Fix-Broken \"true\";\n" - " };\n" - "};\n" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:854 + msgid "Print information related to downloading packages using FTP." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:93 - msgid "" - "with newlines placed to make it more readable. Lists can be created by " - "opening a scope and including a single string enclosed in quotes followed by " - "a semicolon. Multiple entries can be included, each separated by a " - "semicolon." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:865 + msgid "Print information related to downloading packages using HTTP." msgstr "" - #. type: Content of: <refentry><refsect1><informalexample><programlisting> - #: apt.conf.5.xml:98 - #, no-wrap - msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:876 + msgid "Print information related to downloading packages using HTTPS." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:101 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:887 msgid "" - "In general the sample configuration file in " - "<filename>&docdir;examples/apt.conf</filename> &configureindex; is a good " - "guide for how it should look." + "Print information related to verifying cryptographic signatures using " + "<literal>gpg</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:105 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:898 msgid "" - "The names of the configuration items are not case-sensitive. So in the " - "previous example you could use <literal>dpkg::pre-install-pkgs</literal>." + "Output information about the process of accessing collections of packages " + "stored on CD-ROMs." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:108 - msgid "" - "Names for the configuration items are optional if a list is defined as it " - "can be see in the <literal>DPkg::Pre-Install-Pkgs</literal> example " - "above. If you don't specify a name a new entry will simply add a new option " - "to the list. If you specify a name you can override the option as every " - "other option by reassigning a new value to the option." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:908 + msgid "Describes the process of resolving build-dependencies in &apt-get;." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:113 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:918 msgid "" - "Two specials are allowed, <literal>#include</literal> (which is deprecated " - "and not supported by alternative implementations) and " - "<literal>#clear</literal>: <literal>#include</literal> will include the " - "given file, unless the filename ends in a slash, then the whole directory is " - "included. <literal>#clear</literal> is used to erase a part of the " - "configuration tree. The specified element and all its descendants are " - "erased. (Note that these lines also need to end with a semicolon.)" + "Output each cryptographic hash that is generated by the " + "<literal>apt</literal> libraries." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:121 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:928 msgid "" - "The #clear command is the only way to delete a list or a complete scope. " - "Reopening a scope or the ::-style described below will " - "<emphasis>not</emphasis> override previously written entries. Only options " - "can be overridden by addressing a new value to it - lists and scopes can't " - "be overridden, only cleared." + "Do not include information from <literal>statfs</literal>, namely the number " + "of used and free blocks on the CD-ROM filesystem, when generating an ID for " + "a CD-ROM." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:126 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:939 msgid "" - "All of the APT tools take a -o option which allows an arbitrary " - "configuration directive to be specified on the command line. The syntax is a " - "full option name (<literal>APT::Get::Assume-Yes</literal> for instance) " - "followed by an equals sign then the new value of the option. To append a new " - "element to a list, add a trailing :: to the name of the list. (As you might " - "suspect: The scope syntax can't be used on the command line.)" + "Disable all file locking. For instance, this will allow two instances of " + "<quote><literal>apt-get update</literal></quote> to run at the same time." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:133 - msgid "" - "Note that you can use :: only for appending one item per line to a list and " - "that you should not use it in combination with the scope syntax. (The scope " - "syntax implicit insert ::) Using both syntaxes together will trigger a bug " - "which some users unfortunately depend on: An option with the unusual name " - "\"<literal>::</literal>\" which acts like every other option with a " - "name. These introduces many problems including that a user who writes " - "multiple lines in this <emphasis>wrong</emphasis> syntax in the hope to " - "append to a list will gain the opposite as only the last assignment for this " - "option \"<literal>::</literal>\" will be used. Upcoming APT versions will " - "raise errors and will stop working if they encounter this misuse, so please " - "correct such statements now as long as APT doesn't complain explicit about " - "them." + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:951 + msgid "Log when items are added to or removed from the global download queue." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:145 - msgid "The APT Group" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:961 + msgid "" + "Output status messages and errors related to verifying checksums and " + "cryptographic signatures of downloaded files." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:146 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:971 msgid "" - "This group of options controls general APT behavior as well as holding the " - "options for all of the tools." + "Output information about downloading and applying package index list diffs, " + "and errors relating to package index list diffs." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:151 + #: apt.conf.5.xml:983 msgid "" - "System Architecture; sets the architecture to use when fetching files and " - "parsing package lists. The internal default is the architecture apt was " - "compiled for." + "Output information related to patching apt package lists when downloading " + "index diffs instead of full indices." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:157 - msgid "" - "All Architectures the system supports. Processors implementing the " - "<literal>amd64</literal> (also called <literal>x86-64</literal>) instruction " - "set are e.g. also able to execute binaries compiled for the " - "<literal>i386</literal> (<literal>x86</literal>) instruction set; This list " - "is use when fetching files and parsing package lists. The internal default " - "is always the native architecture (<literal>APT::Architecture</literal>) " - "and all foreign architectures it can retrieve by calling <command>dpkg " - "--print-foreign-architectures</command>." + #: apt.conf.5.xml:994 + msgid "Log all interactions with the sub-processes that actually perform downloads." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:167 + #: apt.conf.5.xml:1005 msgid "" - "Default release to install packages from if more than one version " - "available. Contains release name, codename or release version. Examples: " - "'stable', 'testing', 'unstable', '&stable-codename;', '&testing-codename;', " - "'4.0', '5.0*'. See also &apt-preferences;." + "Log events related to the automatically-installed status of packages and to " + "the removal of unused packages." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:173 + #: apt.conf.5.xml:1015 msgid "" - "Ignore Held packages; This global option causes the problem resolver to " - "ignore held packages in its decision making." + "Generate debug messages describing which packages are being automatically " + "installed to resolve dependencies. This corresponds to the initial " + "auto-install pass performed in, e.g., <literal>apt-get install</literal>, " + "and not to the full <literal>apt</literal> dependency resolver; see " + "<literal>Debug::pkgProblemResolver</literal> for that." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:178 + #: apt.conf.5.xml:1029 msgid "" - "Defaults to on. When turned on the autoclean feature will remove any " - "packages which can no longer be downloaded from the cache. If turned off " - "then packages that are locally installed are also excluded from cleaning - " - "but note that APT provides no direct means to reinstall them." + "Generate debug messages describing which packages are marked as " + "keep/install/remove while the ProblemResolver does his work. Each addition " + "or deletion may trigger additional actions; they are shown indented two " + "additional spaces under the original entry. The format for each line is " + "<literal>MarkKeep</literal>, <literal>MarkDelete</literal> or " + "<literal>MarkInstall</literal> followed by <literal>package-name <a.b.c " + "-> d.e.f | x.y.z> (section)</literal> where <literal>a.b.c</literal> " + "is the current version of the package, <literal>d.e.f</literal> is the " + "version considered for installation and <literal>x.y.z</literal> is a newer " + "version, but not considered for installation (because of a low pin " + "score). The later two can be omitted if there is none or if it is the same " + "as the installed version. <literal>section</literal> is the name of the " + "section the package appears in." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:185 + #: apt.conf.5.xml:1050 msgid "" - "Defaults to on which will cause APT to install essential and important " - "packages as fast as possible in the install/upgrade operation. This is done " - "to limit the effect of a failing &dpkg; call: If this option is disabled APT " - "does treat an important package in the same way as an extra package: Between " - "the unpacking of the important package A and his configuration can then be " - "many other unpack or configuration calls, e.g. for package B which has no " - "relation to A, but causes the dpkg call to fail (e.g. because maintainer " - "script of package B generates an error) which results in a system state in " - "which package A is unpacked but unconfigured - each package depending on A " - "is now no longer guaranteed to work as their dependency on A is not longer " - "satisfied. The immediate configuration marker is also applied to all " - "dependencies which can generate a problem if the dependencies e.g. form a " - "circle as a dependency with the immediate flag is comparable with a " - "Pre-Dependency. So in theory it is possible that APT encounters a situation " - "in which it is unable to perform immediate configuration, errors out and " - "refers to this option so the user can deactivate the immediate configuration " - "temporarily to be able to perform an install/upgrade again. Note the use of " - "the word \"theory\" here as this problem was only encountered by now in real " - "world a few times in non-stable distribution versions and was caused by " - "wrong dependencies of the package in question or by a system in an already " - "broken state, so you should not blindly disable this option as the mentioned " - "scenario above is not the only problem immediate configuration can help to " - "prevent in the first place. Before a big operation like " - "<literal>dist-upgrade</literal> is run with this option disabled it should " - "be tried to explicitly <literal>install</literal> the package APT is unable " - "to configure immediately, but please make sure to report your problem also " - "to your distribution and to the APT team with the buglink below so they can " - "work on improving or correcting the upgrade process." + "When invoking &dpkg;, output the precise command line with which it is being " + "invoked, with arguments separated by a single space character." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:208 + #: apt.conf.5.xml:1061 msgid "" - "Never Enable this option unless you -really- know what you are doing. It " - "permits APT to temporarily remove an essential package to break a " - "Conflicts/Conflicts or Conflicts/Pre-Depend loop between two essential " - "packages. SUCH A LOOP SHOULD NEVER EXIST AND IS A GRAVE BUG. This option " - "will work if the essential packages are not tar, gzip, libc, dpkg, bash or " - "anything that those packages depend on." + "Output all the data received from &dpkg; on the status file descriptor and " + "any errors encountered while parsing it." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:217 + #: apt.conf.5.xml:1072 msgid "" - "APT uses since version 0.7.26 a resizable memory mapped cache file to store " - "the 'available' information. <literal>Cache-Start</literal> acts as a hint " - "to which size the Cache will grow and is therefore the amount of memory APT " - "will request at startup. The default value is 20971520 bytes (~20 MB). Note " - "that this amount of space needs to be available for APT otherwise it will " - "likely fail ungracefully, so for memory restricted devices this value should " - "be lowered while on systems with a lot of configured sources it should be " - "increased. <literal>Cache-Grow</literal> defines in bytes with the default " - "of 1048576 (~1 MB) how much the Cache size will be increased in the event " - "the space defined by <literal>Cache-Start</literal> is not enough. These " - "value will be applied again and again until either the cache is big enough " - "to store all information or the size of the cache reaches the " - "<literal>Cache-Limit</literal>. The default of " - "<literal>Cache-Limit</literal> is 0 which stands for no limit. If " - "<literal>Cache-Grow</literal> is set to 0 the automatic grow of the cache is " - "disabled." + "Generate a trace of the algorithm that decides the order in which " + "<literal>apt</literal> should pass packages to &dpkg;." + msgstr "" + + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt.conf.5.xml:1084 + msgid "Output status messages tracing the steps performed when invoking &dpkg;." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:233 - msgid "Defines which package(s) are considered essential build dependencies." + #: apt.conf.5.xml:1095 + msgid "Output the priority of each package list on startup." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:237 + #: apt.conf.5.xml:1105 msgid "" - "The Get subsection controls the &apt-get; tool, please see its documentation " - "for more information about the options here." + "Trace the execution of the dependency resolver (this applies only to what " + "happens when a complex dependency problem is encountered)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:242 + #: apt.conf.5.xml:1116 msgid "" - "The Cache subsection controls the &apt-cache; tool, please see its " - "documentation for more information about the options here." + "Display a list of all installed packages with their calculated score used by " + "the pkgProblemResolver. The description of the package is the same as " + "described in <literal>Debug::pkgDepCache::Marker</literal>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:247 + #: apt.conf.5.xml:1128 msgid "" - "The CDROM subsection controls the &apt-cdrom; tool, please see its " - "documentation for more information about the options here." + "Print information about the vendors read from " + "<filename>/etc/apt/vendors.list</filename>." msgstr "" #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:253 - msgid "The Acquire Group" + #: apt.conf.5.xml:1150 apt_preferences.5.xml:545 sources.list.5.xml:211 apt-ftparchive.1.xml:596 + msgid "Examples" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:254 + #: apt.conf.5.xml:1151 msgid "" - "The <literal>Acquire</literal> group of options controls the download of " - "packages and the URI handlers." + "&configureindex; is a configuration file showing example values for all " + "possible options." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:259 - msgid "" - "Security related option defaulting to true as an expiring validation for a " - "Release file prevents longtime replay attacks and can e.g. also help users " - "to identify no longer updated mirrors - but the feature depends on the " - "correctness of the time on the user system. Archive maintainers are " - "encouraged to create Release files with the <literal>Valid-Until</literal> " - "header, but if they don't or a stricter value is volitional the following " - "<literal>Max-ValidTime</literal> option can be used." + #. ? reading apt.conf + #. type: Content of: <refentry><refsect1><para> + #: apt.conf.5.xml:1163 + msgid "&apt-cache;, &apt-config;, &apt-preferences;." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:270 - msgid "" - "Seconds the Release file should be considered valid after it was created " - "(indicated by the <literal>Date</literal> header). If the Release file " - "itself includes a <literal>Valid-Until</literal> header the earlier date of " - "the two is used as the expiration date. The default value is " - "<literal>0</literal> which stands for \"for ever valid\". Archive specific " - "settings can be made by appending the label of the archive to the option " - "name." + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt_preferences.5.xml:32 + msgid "Preference control file for APT" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:281 + #. type: Content of: <refentry><refsect1><para> + #: apt_preferences.5.xml:37 msgid "" - "Minimum of seconds the Release file should be considered valid after it was " - "created (indicated by the <literal>Date</literal> header). Use this if you " - "need to use a seldomly updated (local) mirror of a more regular updated " - "archive with a <literal>Valid-Until</literal> header instead of completely " - "disabling the expiration date checking. Archive specific settings can and " - "should be used by appending the label of the archive to the option name." + "The APT preferences file <filename>/etc/apt/preferences</filename> and the " + "fragment files in the <filename>/etc/apt/preferences.d/</filename> folder " + "can be used to control which versions of packages will be selected for " + "installation." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:292 + #. type: Content of: <refentry><refsect1><para> + #: apt_preferences.5.xml:42 msgid "" - "Try to download deltas called <literal>PDiffs</literal> for Packages or " - "Sources files instead of downloading whole ones. True by default." + "Several versions of a package may be available for installation when the " + "&sources-list; file contains references to more than one distribution (for " + "example, <literal>stable</literal> and <literal>testing</literal>). APT " + "assigns a priority to each version that is available. Subject to dependency " + "constraints, <command>apt-get</command> selects the version with the highest " + "priority for installation. The APT preferences override the priorities that " + "APT assigns to package versions by default, thus giving the user control " + "over which one is selected for installation." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:295 + #. type: Content of: <refentry><refsect1><para> + #: apt_preferences.5.xml:52 msgid "" - "Two sub-options to limit the use of PDiffs are also available: With " - "<literal>FileLimit</literal> can be specified how many PDiff files are " - "downloaded at most to update a file. <literal>SizeLimit</literal> on the " - "other hand is the maximum percentage of the size of all patches compared to " - "the size of the targeted file. If one of these limits is exceeded the " - "complete file is downloaded instead of the patches." + "Several instances of the same version of a package may be available when the " + "&sources-list; file contains references to more than one source. In this " + "case <command>apt-get</command> downloads the instance listed earliest in " + "the &sources-list; file. The APT preferences do not affect the choice of " + "instance, only the choice of version." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:305 + #. type: Content of: <refentry><refsect1><para> + #: apt_preferences.5.xml:59 msgid "" - "Queuing mode; <literal>Queue-Mode</literal> can be one of " - "<literal>host</literal> or <literal>access</literal> which determines how " - "APT parallelizes outgoing connections. <literal>host</literal> means that " - "one connection per target host will be opened, <literal>access</literal> " - "means that one connection per URI type will be opened." + "Preferences are a strong power in the hands of a system administrator but " + "they can become also their biggest nightmare if used without care! APT will " + "not question the preferences, so wrong settings can lead to uninstallable " + "packages or wrong decisions while upgrading packages. Even more problems " + "will arise if multiple distribution releases are mixed without a good " + "understanding of the following paragraphs. Packages included in a specific " + "release aren't tested in (and therefore don't always work as expected in) " + "older or newer releases, or together with other packages from different " + "releases. You have been warned." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:313 + #. type: Content of: <refentry><refsect1><para> + #: apt_preferences.5.xml:70 msgid "" - "Number of retries to perform. If this is non-zero APT will retry failed " - "files the given number of times." + "Note that the files in the <filename>/etc/apt/preferences.d</filename> " + "directory are parsed in alphanumeric ascending order and need to obey the " + "following naming convention: The files have either no or " + "\"<literal>pref</literal>\" as filename extension and only contain " + "alphanumeric, hyphen (-), underscore (_) and period (.) characters. " + "Otherwise APT will print a notice that it has ignored a file, unless that " + "file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> " + "configuration list - in which case it will be silently ignored." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:318 - msgid "" - "Use symlinks for source archives. If set to true then source archives will " - "be symlinked when possible instead of copying. True is the default." + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:79 + msgid "APT's Default Priority Assignments" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:323 + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:94 + #, no-wrap msgid "" - "HTTP URIs; http::Proxy is the default http proxy to use. It is in the " - "standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per " - "host proxies can also be specified by using the form " - "<literal>http::Proxy::<host></literal> with the special keyword " - "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above " - "settings is specified, <envar>http_proxy</envar> environment variable will " - "be used." + "<command>apt-get install -t testing " + "<replaceable>some-package</replaceable></command>\n" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:331 - msgid "" - "Three settings are provided for cache control with HTTP/1.1 compliant proxy " - "caches. <literal>No-Cache</literal> tells the proxy to not use its cached " - "response under any circumstances, <literal>Max-Age</literal> is sent only " - "for index files and tells the cache to refresh its object if it is older " - "than the given number of seconds. Debian updates its index files daily so " - "the default is 1 day. <literal>No-Store</literal> specifies that the cache " - "should never store this request, it is only set for archive files. This may " - "be useful to prevent polluting a proxy cache with very large .deb " - "files. Note: Squid 2.0.2 does not support any of these options." - msgstr "" + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:97 + #, no-wrap + msgid "APT::Default-Release \"stable\";\n" + msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:341 apt.conf.5.xml:407 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:81 msgid "" - "The option <literal>timeout</literal> sets the timeout timer used by the " - "method, this applies to all things including connection timeout and data " - "timeout." + "If there is no preferences file or if there is no entry in the file that " + "applies to a particular version then the priority assigned to that version " + "is the priority of the distribution to which that version belongs. It is " + "possible to single out a distribution, \"the target release\", which " + "receives a higher priority than other distributions do by default. The " + "target release can be set on the <command>apt-get</command> command line or " + "in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note " + "that this has precedence over any general priority you set in the " + "<filename>/etc/apt/preferences</filename> file described later, but not over " + "specifically pinned packages. For example, <placeholder " + "type=\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" " + "id=\"1\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:344 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:101 msgid "" - "The setting <literal>Acquire::http::Pipeline-Depth</literal> can be used to " - "enabled HTTP pipeling (RFC 2616 section 8.1.2.2) which can be beneficial " - "e.g. on high-latency connections. It specifies how many requests are send in " - "a pipeline. Previous APT versions had a default of 10 for this setting, but " - "the default value is now 0 (= disabled) to avoid problems with the " - "ever-growing amount of webservers and proxies which choose to not conform to " - "the HTTP/1.1 specification." + "If the target release has been specified then APT uses the following " + "algorithm to set the priorities of the versions of a package. Assign:" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:351 - msgid "" - "<literal>Acquire::http::AllowRedirect</literal> controls if APT will follow " - "redirects, which is enabled by default." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:106 + msgid "priority 1" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:354 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:107 msgid "" - "The used bandwidth can be limited with " - "<literal>Acquire::http::Dl-Limit</literal> which accepts integer values in " - "kilobyte. The default value is 0 which deactivates the limit and tries uses " - "as much as possible of the bandwidth (Note that this option implicit " - "deactivates the download from multiple servers at the same time.)" + "to the versions coming from archives which in their " + "<filename>Release</filename> files are marked as \"NotAutomatic: yes\" but " + "<emphasis>not</emphasis> as \"ButAutomaticUpgrades: yes\" like the Debian " + "<literal>experimental</literal> archive." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:359 - msgid "" - "<literal>Acquire::http::User-Agent</literal> can be used to set a different " - "User-Agent for the http download method as some proxies allow access for " - "clients only if the client uses a known identifier." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:113 + msgid "priority 100" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:366 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:114 msgid "" - "HTTPS URIs. Cache-control, Timeout, AllowRedirect, Dl-Limit and proxy " - "options are the same as for <literal>http</literal> method and will also " - "default to the options from the <literal>http</literal> method if they are " - "not explicitly set for https. <literal>Pipeline-Depth</literal> option is " - "not supported yet." + "to the version that is already installed (if any) and to the versions coming " + "from archives which in their <filename>Release</filename> files are marked " + "as \"NotAutomatic: yes\" and \"ButAutomaticUpgrades: yes\" like the Debian " + "backports archive since <literal>squeeze-backports</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:372 - msgid "" - "<literal>CaInfo</literal> suboption specifies place of file that holds info " - "about trusted certificates. <literal><host>::CaInfo</literal> is " - "corresponding per-host option. <literal>Verify-Peer</literal> boolean " - "suboption determines whether verify server's host certificate against " - "trusted certificates or not. <literal><host>::Verify-Peer</literal> " - "is corresponding per-host option. <literal>Verify-Host</literal> boolean " - "suboption determines whether verify server's hostname or not. " - "<literal><host>::Verify-Host</literal> is corresponding per-host " - "option. <literal>SslCert</literal> determines what certificate to use for " - "client authentication. <literal><host>::SslCert</literal> is " - "corresponding per-host option. <literal>SslKey</literal> determines what " - "private key to use for client " - "authentication. <literal><host>::SslKey</literal> is corresponding " - "per-host option. <literal>SslForceVersion</literal> overrides default SSL " - "version to use. Can contain 'TLSv1' or 'SSLv3' string. " - "<literal><host>::SslForceVersion</literal> is corresponding per-host " - "option." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:121 + msgid "priority 500" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:391 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:122 msgid "" - "FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the standard " - "form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host " - "proxies can also be specified by using the form " - "<literal>ftp::Proxy::<host></literal> with the special keyword " - "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above " - "settings is specified, <envar>ftp_proxy</envar> environment variable will be " - "used. To use a ftp proxy you will have to set the " - "<literal>ftp::ProxyLogin</literal> script in the configuration file. This " - "entry specifies the commands to send to tell the proxy server what to " - "connect to. Please see &configureindex; for an example of how to do " - "this. The substitution variables available are " - "<literal>$(PROXY_USER)</literal> <literal>$(PROXY_PASS)</literal> " - "<literal>$(SITE_USER)</literal> <literal>$(SITE_PASS)</literal> " - "<literal>$(SITE)</literal> and <literal>$(SITE_PORT)</literal> Each is taken " - "from it's respective URI component." + "to the versions that are not installed and do not belong to the target " + "release." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:410 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:126 + msgid "priority 990" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:127 + msgid "to the versions that are not installed and belong to the target release." + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:132 msgid "" - "Several settings are provided to control passive mode. Generally it is safe " - "to leave passive mode on, it works in nearly every environment. However " - "some situations require that passive mode be disabled and port mode ftp used " - "instead. This can be done globally, for connections that go through a proxy " - "or for a specific host (See the sample config file for examples)." + "If the target release has not been specified then APT simply assigns " + "priority 100 to all installed package versions and priority 500 to all " + "uninstalled package versions, except versions coming from archives which in " + "their <filename>Release</filename> files are marked as \"NotAutomatic: yes\" " + "- these versions get the priority 1 or priority 100 if it is additionally " + "marked as \"ButAutomaticUpgrades: yes\"." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:417 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:139 msgid "" - "It is possible to proxy FTP over HTTP by setting the " - "<envar>ftp_proxy</envar> environment variable to a http url - see the " - "discussion of the http method above for syntax. You cannot set this in the " - "configuration file and it is not recommended to use FTP over HTTP due to its " - "low efficiency." + "APT then applies the following rules, listed in order of precedence, to " + "determine which version of a package to install." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:422 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:142 msgid "" - "The setting <literal>ForceExtended</literal> controls the use of RFC2428 " - "<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is " - "false, which means these commands are only used if the control connection is " - "IPv6. Setting this to true forces their use even on IPv4 connections. Note " - "that most FTP servers do not support RFC2428." + "Never downgrade unless the priority of an available version exceeds 1000. " + "(\"Downgrading\" is installing a less recent version of a package in place " + "of a more recent version. Note that none of APT's default priorities " + "exceeds 1000; such high priorities can only be set in the preferences file. " + "Note also that downgrading a package can be risky.)" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout> - #: apt.conf.5.xml:435 - #, no-wrap - msgid "/cdrom/::Mount \"foo\";" + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:148 + msgid "Install the highest priority version." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:430 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:149 msgid "" - "CDROM URIs; the only setting for CDROM URIs is the mount point, " - "<literal>cdrom::Mount</literal> which must be the mount point for the CDROM " - "drive as specified in <filename>/etc/fstab</filename>. It is possible to " - "provide alternate mount and unmount commands if your mount point cannot be " - "listed in the fstab (such as an SMB mount and old mount packages). The " - "syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the " - "cdrom block. It is important to have the trailing slash. Unmount commands " - "can be specified using UMount." + "If two or more versions have the same priority, install the most recent one " + "(that is, the one with the higher version number)." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:441 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:152 msgid "" - "GPGV URIs; the only option for GPGV URIs is the option to pass additional " - "parameters to gpgv. <literal>gpgv::Options</literal> Additional options " - "passed to gpgv." + "If two or more versions have the same priority and version number but either " + "the packages differ in some of their metadata or the " + "<literal>--reinstall</literal> option is given, install the uninstalled one." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis> - #: apt.conf.5.xml:452 - #, no-wrap + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:158 msgid "" - "Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> " - "\"<replaceable>Methodname</replaceable>\";" + "In a typical situation, the installed version of a package (priority 100) " + "is not as recent as one of the versions available from the sources listed in " + "the &sources-list; file (priority 500 or 990). Then the package will be " + "upgraded when <command>apt-get install " + "<replaceable>some-package</replaceable></command> or <command>apt-get " + "upgrade</command> is executed." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:447 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:165 msgid "" - "List of compression types which are understood by the acquire methods. " - "Files like <filename>Packages</filename> can be available in various " - "compression formats. Per default the acquire methods can decompress " - "<command>bzip2</command>, <command>lzma</command> and " - "<command>gzip</command> compressed files, with this setting more formats can " - "be added on the fly or the used method can be changed. The syntax for this " - "is: <placeholder type=\"synopsis\" id=\"0\"/>" + "More rarely, the installed version of a package is <emphasis>more</emphasis> " + "recent than any of the other available versions. The package will not be " + "downgraded when <command>apt-get install " + "<replaceable>some-package</replaceable></command> or <command>apt-get " + "upgrade</command> is executed." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis> - #: apt.conf.5.xml:457 - #, no-wrap - msgid "Acquire::CompressionTypes::Order:: \"gz\";" + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:170 + msgid "" + "Sometimes the installed version of a package is more recent than the version " + "belonging to the target release, but not as recent as a version belonging to " + "some other distribution. Such a package will indeed be upgraded when " + "<command>apt-get install <replaceable>some-package</replaceable></command> " + "or <command>apt-get upgrade</command> is executed, because at least " + "<emphasis>one</emphasis> of the available versions has a higher priority " + "than the installed version." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis> - #: apt.conf.5.xml:460 - #, no-wrap - msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };" + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:179 + msgid "The Effect of APT Preferences" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:453 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:181 msgid "" - "Also the <literal>Order</literal> subgroup can be used to define in which " - "order the acquire system will try to download the compressed files. The " - "acquire system will try the first and proceed with the next compression type " - "in this list on error, so to prefer one over the other type simple add the " - "preferred type at first - not already added default types will be added at " - "run time to the end of the list, so e.g. <placeholder type=\"synopsis\" " - "id=\"0\"/> can be used to prefer <command>gzip</command> compressed files " - "over <command>bzip2</command> and <command>lzma</command>. If " - "<command>lzma</command> should be preferred over <command>gzip</command> and " - "<command>bzip2</command> the configure setting should look like this " - "<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add " - "<literal>bz2</literal> explicit to the list as it will be added automatic." + "The APT preferences file allows the system administrator to control the " + "assignment of priorities. The file consists of one or more multi-line " + "records separated by blank lines. Records can have one of two forms, a " + "specific form and a general form." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout> - #: apt.conf.5.xml:464 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:187 + msgid "" + "The specific form assigns a priority (a \"Pin-Priority\") to one or more " + "specified packages with a specified version or version range. For example, " + "the following record assigns a high priority to all versions of the " + "<filename>perl</filename> package whose version number begins with " + "\"<literal>&good-perl;</literal>\". Multiple packages can be separated by " + "spaces." + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> + #: apt_preferences.5.xml:194 #, no-wrap - msgid "Dir::Bin::bzip2 \"/bin/bzip2\";" + msgid "" + "Package: perl\n" + "Pin: version &good-perl;*\n" + "Pin-Priority: 1001\n" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:462 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:200 msgid "" - "Note that at run time the " - "<literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be " - "checked: If this setting exists the method will only be used if this file " - "exists, e.g. for the bzip2 method (the inbuilt) setting is: <placeholder " - "type=\"literallayout\" id=\"0\"/> Note also that list entries specified on " - "the command line will be added at the end of the list specified in the " - "configuration files, but before the default entries. To prefer a type in " - "this case over the ones specified in the configuration files you can set the " - "option direct - not in list style. This will not override the defined list, " - "it will only prefix the list with this type." + "The general form assigns a priority to all of the package versions in a " + "given distribution (that is, to all the versions of packages that are listed " + "in a certain <filename>Release</filename> file) or to all of the package " + "versions coming from a particular Internet site, as identified by the site's " + "fully qualified domain name." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:469 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:206 msgid "" - "The special type <literal>uncompressed</literal> can be used to give " - "uncompressed files a preference, but note that most archives don't provide " - "uncompressed files so this is mostly only useable for local mirrors." + "This general-form entry in the APT preferences file applies only to groups " + "of packages. For example, the following record assigns a high priority to " + "all package versions available from the local site." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:476 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> + #: apt_preferences.5.xml:211 + #, no-wrap msgid "" - "When downloading <literal>gzip</literal> compressed indexes (Packages, " - "Sources, or Translations), keep them gzip compressed locally instead of " - "unpacking them. This saves quite a lot of disk space at the expense of more " - "CPU requirements when building the local package caches. False by default." + "Package: *\n" + "Pin: origin \"\"\n" + "Pin-Priority: 999\n" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:484 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:216 msgid "" - "The Languages subsection controls which <filename>Translation</filename> " - "files are downloaded and in which order APT tries to display the " - "Description-Translations. APT will try to display the first available " - "Description in the Language which is listed at first. Languages can be " - "defined with their short or long Languagecodes. Note that not all archives " - "provide <filename>Translation</filename> files for every Language - " - "especially the long Languagecodes are rare, so please inform you which ones " - "are available before you set here impossible values." + "A note of caution: the keyword used here is \"<literal>origin</literal>\" " + "which can be used to match a hostname. The following record will assign a " + "high priority to all versions available from the server identified by the " + "hostname \"ftp.de.debian.org\"" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><programlisting> - #: apt.conf.5.xml:500 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> + #: apt_preferences.5.xml:220 #, no-wrap - msgid "Acquire::Languages { \"environment\"; \"de\"; \"en\"; \"none\"; \"fr\"; };" + msgid "" + "Package: *\n" + "Pin: origin \"ftp.de.debian.org\"\n" + "Pin-Priority: 999\n" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:490 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:224 msgid "" - "The default list includes \"environment\" and " - "\"en\". \"<literal>environment</literal>\" has a special meaning here: It " - "will be replaced at runtime with the languagecodes extracted from the " - "<literal>LC_MESSAGES</literal> environment variable. It will also ensure " - "that these codes are not included twice in the list. If " - "<literal>LC_MESSAGES</literal> is set to \"C\" only the " - "<filename>Translation-en</filename> file (if available) will be used. To " - "force apt to use no Translation file use the setting " - "<literal>Acquire::Languages=none</literal>. \"<literal>none</literal>\" is " - "another special meaning code which will stop the search for a fitting " - "<filename>Translation</filename> file. This can be used by the system " - "administrator to let APT know that it should download also this files " - "without actually use them if the environment doesn't specify this " - "languages. So the following example configuration will result in the order " - "\"en, de\" in an english and in \"de, en\" in a german localization. Note " - "that \"fr\" is downloaded, but not used if APT is not used in a french " - "localization, in such an environment the order would be \"fr, de, en\". " - "<placeholder type=\"programlisting\" id=\"0\"/>" + "This should <emphasis>not</emphasis> be confused with the Origin of a " + "distribution as specified in a <filename>Release</filename> file. What " + "follows the \"Origin:\" tag in a <filename>Release</filename> file is not an " + "Internet address but an author or vendor name, such as \"Debian\" or " + "\"Ximian\"." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:501 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:229 msgid "" - "Note: To prevent problems resulting from APT being executed in different " - "environments (e.g. by different users or by other programs) all Translation " - "files which are found in <filename>/var/lib/apt/lists/</filename> will be " - "added to the end of the list (after an implicit " - "\"<literal>none</literal>\")." - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:512 - msgid "Directories" + "The following record assigns a low priority to all package versions " + "belonging to any distribution whose Archive name is " + "\"<literal>unstable</literal>\"." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:514 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> + #: apt_preferences.5.xml:233 + #, no-wrap msgid "" - "The <literal>Dir::State</literal> section has directories that pertain to " - "local state information. <literal>lists</literal> is the directory to place " - "downloaded package lists in and <literal>status</literal> is the name of the " - "dpkg status file. <literal>preferences</literal> is the name of the APT " - "<filename>preferences</filename> file. <literal>Dir::State</literal> " - "contains the default directory to prefix on all sub items if they do not " - "start with <filename>/</filename> or <filename>./</filename>." + "Package: *\n" + "Pin: release a=unstable\n" + "Pin-Priority: 50\n" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:521 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:238 msgid "" - "<literal>Dir::Cache</literal> contains locations pertaining to local cache " - "information, such as the two package caches <literal>srcpkgcache</literal> " - "and <literal>pkgcache</literal> as well as the location to place downloaded " - "archives, <literal>Dir::Cache::archives</literal>. Generation of caches can " - "be turned off by setting their names to be blank. This will slow down " - "startup but save disk space. It is probably preferred to turn off the " - "pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the " - "default directory is contained in <literal>Dir::Cache</literal>" + "The following record assigns a high priority to all package versions " + "belonging to any distribution whose Codename is " + "\"<literal>&testing-codename;</literal>\"." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:530 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> + #: apt_preferences.5.xml:242 + #, no-wrap msgid "" - "<literal>Dir::Etc</literal> contains the location of configuration files, " - "<literal>sourcelist</literal> gives the location of the sourcelist and " - "<literal>main</literal> is the default configuration file (setting has no " - "effect, unless it is done from the config file specified by " - "<envar>APT_CONFIG</envar>)." + "Package: *\n" + "Pin: release n=&testing-codename;\n" + "Pin-Priority: 900\n" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:536 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:247 msgid "" - "The <literal>Dir::Parts</literal> setting reads in all the config fragments " - "in lexical order from the directory specified. After this is done then the " - "main config file is loaded." + "The following record assigns a high priority to all package versions " + "belonging to any release whose Archive name is \"<literal>stable</literal>\" " + "and whose release Version number is \"<literal>&stable-version;</literal>\"." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:540 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> + #: apt_preferences.5.xml:252 + #, no-wrap msgid "" - "Binary programs are pointed to by " - "<literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies " - "the location of the method handlers and <literal>gzip</literal>, " - "<literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, " - "<literal>apt-get</literal> <literal>dpkg-source</literal> " - "<literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> " - "specify the location of the respective programs." + "Package: *\n" + "Pin: release a=stable, v=&stable-version;\n" + "Pin-Priority: 500\n" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:548 - msgid "" - "The configuration item <literal>RootDir</literal> has a special meaning. If " - "set, all paths in <literal>Dir::</literal> will be relative to " - "<literal>RootDir</literal>, <emphasis>even paths that are specified " - "absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is " - "set to <filename>/tmp/staging</filename> and " - "<literal>Dir::State::status</literal> is set to " - "<filename>/var/lib/dpkg/status</filename>, then the status file will be " - "looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>." + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:262 + msgid "Regular expressions and &glob; syntax" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:561 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:264 msgid "" - "The <literal>Ignore-Files-Silently</literal> list can be used to specify " - "which files APT should silently ignore while parsing the files in the " - "fragment directories. Per default a file which end with " - "<literal>.disabled</literal>, <literal>~</literal>, <literal>.bak</literal> " - "or <literal>.dpkg-[a-z]+</literal> is silently ignored. As seen in the last " - "default value these patterns can use regular expression syntax." + "APT also supports pinning by &glob; expressions, and regular expressions " + "surrounded by slashes. For example, the following example assigns the " + "priority 500 to all packages from experimental where the name starts with " + "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX " + "extended regular expression surrounded by slashes)." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:570 - msgid "APT in DSelect" + #. type: Content of: <refentry><refsect1><refsect2><programlisting> + #: apt_preferences.5.xml:273 + #, no-wrap + msgid "" + "Package: gnome* /kde/\n" + "Pin: release n=experimental\n" + "Pin-Priority: 500\n" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:572 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:279 msgid "" - "When APT is used as a &dselect; method several configuration directives " - "control the default behaviour. These are in the <literal>DSelect</literal> " - "section." + "The rule for those expressions is that they can occur anywhere where a " + "string can occur. Thus, the following pin assigns the priority 990 to all " + "packages from a release starting with &ubuntu-codename;." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:577 + #. type: Content of: <refentry><refsect1><refsect2><programlisting> + #: apt_preferences.5.xml:285 + #, no-wrap msgid "" - "Cache Clean mode; this value may be one of always, prompt, auto, pre-auto " - "and never. always and prompt will remove all packages from the cache after " - "upgrading, prompt (the default) does so conditionally. auto removes only " - "those packages which are no longer downloadable (replaced with a new version " - "for instance). pre-auto performs this action before downloading new " - "packages." + "Package: *\n" + "Pin: release n=&ubuntu-codename;*\n" + "Pin-Priority: 990\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:586 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:291 msgid "" - "The contents of this variable is passed to &apt-get; as command line options " - "when it is run for the install phase." + "If a regular expression occurs in a <literal>Package</literal> field, the " + "behavior is the same as if this regular expression were replaced with a list " + "of all package names it matches. It is undecided whether this will change in " + "the future; thus you should always list wild-card pins first, so later " + "specific pins override it. The pattern \"<literal>*</literal>\" in a " + "Package field is not considered a &glob; expression in itself." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:591 - msgid "" - "The contents of this variable is passed to &apt-get; as command line options " - "when it is run for the update phase." + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:307 + msgid "How APT Interprets Priorities" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:596 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:310 msgid "" - "If true the [U]pdate operation in &dselect; will always prompt to continue. " - "The default is to prompt only on error." + "Priorities (P) assigned in the APT preferences file must be positive or " + "negative integers. They are interpreted as follows (roughly speaking):" msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:602 - msgid "How APT calls dpkg" + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:315 + msgid "P > 1000" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:603 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:316 msgid "" - "Several configuration directives control how APT invokes &dpkg;. These are " - "in the <literal>DPkg</literal> section." + "causes a version to be installed even if this constitutes a downgrade of the " + "package" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:608 - msgid "" - "This is a list of options to pass to dpkg. The options must be specified " - "using the list notation and each list item is passed as a single argument to " - "&dpkg;." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:320 + msgid "990 < P <=1000" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:614 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:321 msgid "" - "This is a list of shell commands to run before/after invoking &dpkg;. Like " - "<literal>options</literal> this must be specified in list notation. The " - "commands are invoked in order using <filename>/bin/sh</filename>, should any " - "fail APT will abort." + "causes a version to be installed even if it does not come from the target " + "release, unless the installed version is more recent" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:621 - msgid "" - "This is a list of shell commands to run before invoking dpkg. Like " - "<literal>options</literal> this must be specified in list notation. The " - "commands are invoked in order using <filename>/bin/sh</filename>, should any " - "fail APT will abort. APT will pass to the commands on standard input the " - "filenames of all .deb files it is going to install, one per line." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:326 + msgid "500 < P <=990" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:627 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:327 msgid "" - "Version 2 of this protocol dumps more information, including the protocol " - "version, the APT configuration space and the packages, files and versions " - "being changed. Version 2 is enabled by setting " - "<literal>DPkg::Tools::options::cmd::Version</literal> to " - "2. <literal>cmd</literal> is a command given to " - "<literal>Pre-Install-Pkgs</literal>." + "causes a version to be installed unless there is a version available " + "belonging to the target release or the installed version is more recent" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:635 - msgid "" - "APT chdirs to this directory before invoking dpkg, the default is " - "<filename>/</filename>." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:332 + msgid "100 < P <=500" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:640 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:333 msgid "" - "These options are passed to &dpkg-buildpackage; when compiling packages, the " - "default is to disable signing and produce all binaries." + "causes a version to be installed unless there is a version available " + "belonging to some other distribution or the installed version is more recent" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt.conf.5.xml:645 - msgid "dpkg trigger usage (and related options)" + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:338 + msgid "0 < P <=100" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt.conf.5.xml:646 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:339 msgid "" - "APT can call dpkg in a way so it can make aggressive use of triggers over " - "multiple calls of dpkg. Without further options dpkg will use triggers only " - "in between his own run. Activating these options can therefore decrease the " - "time needed to perform the install / upgrade. Note that it is intended to " - "activate these options per default in the future, but as it changes the way " - "APT calling dpkg drastically it needs a lot more testing. <emphasis>These " - "options are therefore currently experimental and should not be used in " - "productive environments.</emphasis> Also it breaks the progress reporting so " - "all frontends will currently stay around half (or more) of the time in the " - "100% state while it actually configures all packages." + "causes a version to be installed only if there is no installed version of " + "the package" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><literallayout> - #: apt.conf.5.xml:661 - #, no-wrap - msgid "" - "DPkg::NoTriggers \"true\";\n" - "PackageManager::Configure \"smart\";\n" - "DPkg::ConfigurePending \"true\";\n" - "DPkg::TriggersPending \"true\";" + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:343 + msgid "P < 0" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt.conf.5.xml:655 - msgid "" - "Note that it is not guaranteed that APT will support these options or that " - "these options will not cause (big) trouble in the future. If you have " - "understand the current risks and problems with these options, but are brave " - "enough to help testing them create a new configuration file and test a " - "combination of options. Please report any bugs, problems and improvements " - "you encounter and make sure to note which options you have used in your " - "reports. Asking dpkg for help could also be useful for debugging proposes, " - "see e.g. <command>dpkg --audit</command>. A defensive option combination " - "would be <placeholder type=\"literallayout\" id=\"0\"/>" + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:344 + msgid "prevents the version from being installed" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:668 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:349 msgid "" - "Add the no triggers flag to all dpkg calls (except the ConfigurePending " - "call). See &dpkg; if you are interested in what this actually means. In " - "short: dpkg will not run the triggers when this flag is present unless it is " - "explicitly called to do so in an extra call. Note that this option exists " - "(undocumented) also in older apt versions with a slightly different meaning: " - "Previously these option only append --no-triggers to the configure calls to " - "dpkg - now apt will add these flag also to the unpack and remove calls." + "If any specific-form records match an available package version then the " + "first such record determines the priority of the package version. Failing " + "that, if any general-form records match an available package version then " + "the first such record determines the priority of the package version." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:676 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:355 msgid "" - "Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" " - "and \"<literal>no</literal>\". \"<literal>all</literal>\" is the default " - "value and causes APT to configure all packages explicit. The " - "\"<literal>smart</literal>\" way is it to configure only packages which need " - "to be configured before another package can be unpacked (Pre-Depends) and " - "let the rest configure by dpkg with a call generated by the next " - "option. \"<literal>no</literal>\" on the other hand will not configure " - "anything and totally rely on dpkg for configuration (which will at the " - "moment fail if a Pre-Depends is encountered). Setting this option to " - "another than the all value will implicitly activate also the next option per " - "default as otherwise the system could end in an unconfigured status which " - "could be unbootable!" + "For example, suppose the APT preferences file contains the three records " + "presented earlier:" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:687 - msgid "" - "If this option is set apt will call <command>dpkg --configure " - "--pending</command> to let dpkg handle all required configurations and " - "triggers. This option is activated automatic per default if the previous " - "option is not set to <literal>all</literal>, but deactivating could be " - "useful if you want to run APT multiple times in a row - e.g. in an " - "installer. In these sceneries you could deactivate this option in all but " - "the last run." - msgstr "" - - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:694 + #. type: Content of: <refentry><refsect1><refsect2><programlisting> + #: apt_preferences.5.xml:359 + #, no-wrap msgid "" - "Useful for <literal>smart</literal> configuration as a package which has " - "pending triggers is not considered as <literal>installed</literal> and dpkg " - "treats them as <literal>unpacked</literal> currently which is a dealbreaker " - "for Pre-Dependencies (see debbugs #526774). Note that this will process all " - "triggers, not only the triggers needed to configure this package." + "Package: perl\n" + "Pin: version &good-perl;*\n" + "Pin-Priority: 1001\n" + "\n" + "Package: *\n" + "Pin: origin \"\"\n" + "Pin-Priority: 999\n" + "\n" + "Package: *\n" + "Pin: release unstable\n" + "Pin-Priority: 50\n" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:700 - msgid "" - "As the configuration can be deferred to be done at the end by dpkg it can be " - "tried to order the unpack series only by critical needs, e.g. by " - "Pre-Depends. Default is true and therefore the \"old\" method of ordering in " - "various steps by everything. While both method were present in earlier APT " - "versions the <literal>OrderCritical</literal> method was unused, so this " - "method is very experimental and needs further improvements before becoming " - "really useful." + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:372 + msgid "Then:" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout> - #: apt.conf.5.xml:715 - #, no-wrap + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:374 msgid "" - "OrderList::Score {\n" - "\tDelete 500;\n" - "\tEssential 200;\n" - "\tImmediate 10;\n" - "\tPreDepends 50;\n" - "};" + "The most recent available version of the <literal>perl</literal> package " + "will be installed, so long as that version's version number begins with " + "\"<literal>&good-perl;</literal>\". If <emphasis>any</emphasis> " + "&good-perl;* version of <literal>perl</literal> is available and the " + "installed version is &bad-perl;*, then <literal>perl</literal> will be " + "downgraded." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:708 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:379 msgid "" - "Essential packages (and there dependencies) should be configured immediately " - "after unpacking. It will be a good idea to do this quite early in the " - "upgrade process as these these configure calls require currently also " - "<literal>DPkg::TriggersPending</literal> which will run quite a few triggers " - "(which maybe not needed). Essentials get per default a high score but the " - "immediate flag is relatively low (a package which has a Pre-Depends is " - "higher rated). These option and the others in the same group can be used to " - "change the scoring. The following example shows the settings with there " - "default values. <placeholder type=\"literallayout\" id=\"0\"/>" - msgstr "" - - #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:728 - msgid "Periodic and Archives options" + "A version of any package other than <literal>perl</literal> that is " + "available from the local system has priority over other versions, even " + "versions belonging to the target release." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:729 + #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> + #: apt_preferences.5.xml:383 msgid "" - "<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups " - "of options configure behavior of apt periodic updates, which is done by " - "<literal>/etc/cron.daily/apt</literal> script. See header of this script for " - "the brief documentation of these options." + "A version of a package whose origin is not the local system but some other " + "site listed in &sources-list; and which belongs to an " + "<literal>unstable</literal> distribution is only installed if it is selected " + "for installation and no version of the package is already installed." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: apt.conf.5.xml:737 - msgid "Debug options" + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:393 + msgid "Determination of Package Version and Distribution Properties" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:739 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:395 msgid "" - "Enabling options in the <literal>Debug::</literal> section will cause " - "debugging information to be sent to the standard error stream of the program " - "utilizing the <literal>apt</literal> libraries, or enable special program " - "modes that are primarily useful for debugging the behavior of " - "<literal>apt</literal>. Most of these options are not interesting to a " - "normal user, but a few may be:" + "The locations listed in the &sources-list; file should provide " + "<filename>Packages</filename> and <filename>Release</filename> files to " + "describe the packages available at that location." msgstr "" - #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> - #: apt.conf.5.xml:750 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:399 msgid "" - "<literal>Debug::pkgProblemResolver</literal> enables output about the " - "decisions made by <literal>dist-upgrade, upgrade, install, remove, " - "purge</literal>." + "The <filename>Packages</filename> file is normally found in the directory " + "<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: " + "for example, " + "<filename>.../dists/stable/main/binary-i386/Packages</filename>. It " + "consists of a series of multi-line records, one for each package available " + "in that directory. Only two lines in each record are relevant for setting " + "APT priorities:" msgstr "" - #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> - #: apt.conf.5.xml:758 - msgid "" - "<literal>Debug::NoLocking</literal> disables all file locking. This can be " - "used to run some operations (for instance, <literal>apt-get -s " - "install</literal>) as a non-root user." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:407 + msgid "the <literal>Package:</literal> line" msgstr "" - #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> - #: apt.conf.5.xml:767 - msgid "" - "<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each " - "time that <literal>apt</literal> invokes &dpkg;." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:408 + msgid "gives the package name" msgstr "" - #. TODO: provide a - #. motivating example, except I haven't a clue why you'd want - #. to do this. - #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> - #: apt.conf.5.xml:775 - msgid "" - "<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data " - "in CDROM IDs." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:411 apt_preferences.5.xml:461 + msgid "the <literal>Version:</literal> line" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:785 - msgid "A full list of debugging options to apt follows." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:412 + msgid "gives the version number for the named package" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:794 - msgid "Print information related to accessing <literal>cdrom://</literal> sources." + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:417 + msgid "" + "The <filename>Release</filename> file is normally found in the directory " + "<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for " + "example, <filename>.../dists/stable/Release</filename>, or " + "<filename>.../dists/&stable-codename;/Release</filename>. It consists of a " + "single multi-line record which applies to <emphasis>all</emphasis> of the " + "packages in the directory tree below its parent. Unlike the " + "<filename>Packages</filename> file, nearly all of the lines in a " + "<filename>Release</filename> file are relevant for setting APT priorities:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:805 - msgid "Print information related to downloading packages using FTP." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:428 + msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:816 - msgid "Print information related to downloading packages using HTTP." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:429 + msgid "" + "names the archive to which all the packages in the directory tree belong. " + "For example, the line \"Archive: stable\" or \"Suite: stable\" specifies " + "that all of the packages in the directory tree below the parent of the " + "<filename>Release</filename> file are in a <literal>stable</literal> " + "archive. Specifying this value in the APT preferences file would require " + "the line:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:827 - msgid "Print information related to downloading packages using HTTPS." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> + #: apt_preferences.5.xml:439 + #, no-wrap + msgid "Pin: release a=stable\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:838 - msgid "" - "Print information related to verifying cryptographic signatures using " - "<literal>gpg</literal>." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:445 + msgid "the <literal>Codename:</literal> line" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:849 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:446 msgid "" - "Output information about the process of accessing collections of packages " - "stored on CD-ROMs." + "names the codename to which all the packages in the directory tree belong. " + "For example, the line \"Codename: &testing-codename;\" specifies that all of " + "the packages in the directory tree below the parent of the " + "<filename>Release</filename> file belong to a version named " + "<literal>&testing-codename;</literal>. Specifying this value in the APT " + "preferences file would require the line:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:859 - msgid "Describes the process of resolving build-dependencies in &apt-get;." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> + #: apt_preferences.5.xml:455 + #, no-wrap + msgid "Pin: release n=&testing-codename;\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:869 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:462 msgid "" - "Output each cryptographic hash that is generated by the " - "<literal>apt</literal> libraries." + "names the release version. For example, the packages in the tree might " + "belong to Debian release version &stable-version;. Note that there is " + "normally no version number for the <literal>testing</literal> and " + "<literal>unstable</literal> distributions because they have not been " + "released yet. Specifying this in the APT preferences file would require one " + "of the following lines." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:879 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> + #: apt_preferences.5.xml:471 + #, no-wrap msgid "" - "Do not include information from <literal>statfs</literal>, namely the number " - "of used and free blocks on the CD-ROM filesystem, when generating an ID for " - "a CD-ROM." + "Pin: release v=&stable-version;\n" + "Pin: release a=stable, v=&stable-version;\n" + "Pin: release &stable-version;\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:890 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:480 + msgid "the <literal>Component:</literal> line" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:481 msgid "" - "Disable all file locking. For instance, this will allow two instances of " - "<quote><literal>apt-get update</literal></quote> to run at the same time." + "names the licensing component associated with the packages in the directory " + "tree of the <filename>Release</filename> file. For example, the line " + "\"Component: main\" specifies that all the packages in the directory tree " + "are from the <literal>main</literal> component, which entails that they are " + "licensed under terms listed in the Debian Free Software Guidelines. " + "Specifying this component in the APT preferences file would require the " + "line:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:902 - msgid "Log when items are added to or removed from the global download queue." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> + #: apt_preferences.5.xml:490 + #, no-wrap + msgid "Pin: release c=main\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:912 - msgid "" - "Output status messages and errors related to verifying checksums and " - "cryptographic signatures of downloaded files." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:496 + msgid "the <literal>Origin:</literal> line" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:922 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:497 msgid "" - "Output information about downloading and applying package index list diffs, " - "and errors relating to package index list diffs." + "names the originator of the packages in the directory tree of the " + "<filename>Release</filename> file. Most commonly, this is " + "<literal>Debian</literal>. Specifying this origin in the APT preferences " + "file would require the line:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:934 - msgid "" - "Output information related to patching apt package lists when downloading " - "index diffs instead of full indices." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> + #: apt_preferences.5.xml:503 + #, no-wrap + msgid "Pin: release o=Debian\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:945 - msgid "Log all interactions with the sub-processes that actually perform downloads." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> + #: apt_preferences.5.xml:509 + msgid "the <literal>Label:</literal> line" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:956 + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> + #: apt_preferences.5.xml:510 msgid "" - "Log events related to the automatically-installed status of packages and to " - "the removal of unused packages." + "names the label of the packages in the directory tree of the " + "<filename>Release</filename> file. Most commonly, this is " + "<literal>Debian</literal>. Specifying this label in the APT preferences " + "file would require the line:" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:966 - msgid "" - "Generate debug messages describing which packages are being automatically " - "installed to resolve dependencies. This corresponds to the initial " - "auto-install pass performed in, e.g., <literal>apt-get install</literal>, " - "and not to the full <literal>apt</literal> dependency resolver; see " - "<literal>Debug::pkgProblemResolver</literal> for that." + #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> + #: apt_preferences.5.xml:516 + #, no-wrap + msgid "Pin: release l=Debian\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:980 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:523 msgid "" - "Generate debug messages describing which package is marked as " - "keep/install/remove while the ProblemResolver does his work. Each addition " - "or deletion may trigger additional actions; they are shown indented two " - "additional space under the original entry. The format for each line is " - "<literal>MarkKeep</literal>, <literal>MarkDelete</literal> or " - "<literal>MarkInstall</literal> followed by <literal>package-name <a.b.c " - "-> d.e.f | x.y.z> (section)</literal> where <literal>a.b.c</literal> " - "is the current version of the package, <literal>d.e.f</literal> is the " - "version considered for installation and <literal>x.y.z</literal> is a newer " - "version, but not considered for installation (because of a low pin " - "score). The later two can be omitted if there is none or if it is the same " - "version as the installed. <literal>section</literal> is the name of the " - "section the package appears in." + "All of the <filename>Packages</filename> and <filename>Release</filename> " + "files retrieved from locations listed in the &sources-list; file are stored " + "in the directory <filename>/var/lib/apt/lists</filename>, or in the file " + "named by the variable <literal>Dir::State::Lists</literal> in the " + "<filename>apt.conf</filename> file. For example, the file " + "<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> " + "contains the <filename>Release</filename> file retrieved from the site " + "<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> " + "architecture files from the <literal>contrib</literal> component of the " + "<literal>unstable</literal> distribution." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1002 - msgid "Dump the default configuration to standard error on startup." + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:536 + msgid "Optional Lines in an APT Preferences Record" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1012 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:538 msgid "" - "When invoking &dpkg;, output the precise command line with which it is being " - "invoked, with arguments separated by a single space character." + "Each record in the APT preferences file can optionally begin with one or " + "more lines beginning with the word <literal>Explanation:</literal>. This " + "provides a place for comments." msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1023 + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:547 + msgid "Tracking Stable" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:555 + #, no-wrap msgid "" - "Output all the data received from &dpkg; on the status file descriptor and " - "any errors encountered while parsing it." + "Explanation: Uninstall or do not install any Debian-originated\n" + "Explanation: package versions other than those in the stable distro\n" + "Package: *\n" + "Pin: release a=stable\n" + "Pin-Priority: 900\n" + "\n" + "Package: *\n" + "Pin: release o=Debian\n" + "Pin-Priority: -10\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1034 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:549 msgid "" - "Generate a trace of the algorithm that decides the order in which " - "<literal>apt</literal> should pass packages to &dpkg;." + "The following APT preferences file will cause APT to assign a priority " + "higher than the default (500) to all package versions belonging to a " + "<literal>stable</literal> distribution and a prohibitively low priority to " + "package versions belonging to other <literal>Debian</literal> " + "distributions. <placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1046 - msgid "Output status messages tracing the steps performed when invoking &dpkg;." + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:572 apt_preferences.5.xml:618 apt_preferences.5.xml:676 + #, no-wrap + msgid "" + "apt-get install <replaceable>package-name</replaceable>\n" + "apt-get upgrade\n" + "apt-get dist-upgrade\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1057 - msgid "Output the priority of each package list on startup." + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:567 + msgid "" + "With a suitable &sources-list; file and the above preferences file, any of " + "the following commands will cause APT to upgrade to the latest " + "<literal>stable</literal> version(s). <placeholder type=\"programlisting\" " + "id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1067 + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:584 + #, no-wrap + msgid "apt-get install <replaceable>package</replaceable>/testing\n" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:578 msgid "" - "Trace the execution of the dependency resolver (this applies only to what " - "happens when a complex dependency problem is encountered)." + "The following command will cause APT to upgrade the specified package to the " + "latest version from the <literal>testing</literal> distribution; the package " + "will not be upgraded again unless this command is given again. <placeholder " + "type=\"programlisting\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1078 + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:590 + msgid "Tracking Testing or Unstable" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:599 + #, no-wrap msgid "" - "Display a list of all installed packages with their calculated score used by " - "the pkgProblemResolver. The description of the package is the same as " - "described in <literal>Debug::pkgDepCache::Marker</literal>" + "Package: *\n" + "Pin: release a=testing\n" + "Pin-Priority: 900\n" + "\n" + "Package: *\n" + "Pin: release a=unstable\n" + "Pin-Priority: 800\n" + "\n" + "Package: *\n" + "Pin: release o=Debian\n" + "Pin-Priority: -10\n" msgstr "" - #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> - #: apt.conf.5.xml:1090 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:592 msgid "" - "Print information about the vendors read from " - "<filename>/etc/apt/vendors.list</filename>." + "The following APT preferences file will cause APT to assign a high priority " + "to package versions from the <literal>testing</literal> distribution, a " + "lower priority to package versions from the <literal>unstable</literal> " + "distribution, and a prohibitively low priority to package versions from " + "other <literal>Debian</literal> distributions. <placeholder " + "type=\"programlisting\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:1113 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:613 msgid "" - "&configureindex; is a configuration file showing example values for all " - "possible options." + "With a suitable &sources-list; file and the above preferences file, any of " + "the following commands will cause APT to upgrade to the latest " + "<literal>testing</literal> version(s). <placeholder type=\"programlisting\" " + "id=\"0\"/>" msgstr "" - #. ? reading apt.conf - #. type: Content of: <refentry><refsect1><para> - #: apt.conf.5.xml:1125 - msgid "&apt-cache;, &apt-config;, &apt-preferences;." + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:633 + #, no-wrap + msgid "apt-get install <replaceable>package</replaceable>/unstable\n" msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: apt_preferences.5.xml:32 - msgid "Preference control file for APT" + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:624 + msgid "" + "The following command will cause APT to upgrade the specified package to the " + "latest version from the <literal>unstable</literal> distribution. " + "Thereafter, <command>apt-get upgrade</command> will upgrade the package to " + "the most recent <literal>testing</literal> version if that is more recent " + "than the installed version, otherwise, to the most recent " + "<literal>unstable</literal> version if that is more recent than the " + "installed version. <placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt_preferences.5.xml:37 + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt_preferences.5.xml:640 + msgid "Tracking the evolution of a codename release" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:654 + #, no-wrap msgid "" - "The APT preferences file <filename>/etc/apt/preferences</filename> and the " - "fragment files in the <filename>/etc/apt/preferences.d/</filename> folder " - "can be used to control which versions of packages will be selected for " - "installation." + "Explanation: Uninstall or do not install any Debian-originated package " + "versions\n" + "Explanation: other than those in the distribution codenamed with " + "&testing-codename; or sid\n" + "Package: *\n" + "Pin: release n=&testing-codename;\n" + "Pin-Priority: 900\n" + "\n" + "Explanation: Debian unstable is always codenamed with sid\n" + "Package: *\n" + "Pin: release n=sid\n" + "Pin-Priority: 800\n" + "\n" + "Package: *\n" + "Pin: release o=Debian\n" + "Pin-Priority: -10\n" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt_preferences.5.xml:42 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:642 msgid "" - "Several versions of a package may be available for installation when the " - "&sources-list; file contains references to more than one distribution (for " - "example, <literal>stable</literal> and <literal>testing</literal>). APT " - "assigns a priority to each version that is available. Subject to dependency " - "constraints, <command>apt-get</command> selects the version with the highest " - "priority for installation. The APT preferences file overrides the " - "priorities that APT assigns to package versions by default, thus giving the " - "user control over which one is selected for installation." + "The following APT preferences file will cause APT to assign a priority " + "higher than the default (500) to all package versions belonging to a " + "specified codename of a distribution and a prohibitively low priority to " + "package versions belonging to other <literal>Debian</literal> distributions, " + "codenames and archives. Note that with this APT preference APT will follow " + "the migration of a release from the archive <literal>testing</literal> to " + "<literal>stable</literal> and later <literal>oldstable</literal>. If you " + "want to follow for example the progress in <literal>testing</literal> " + "notwithstanding the codename changes you should use the example " + "configurations above. <placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt_preferences.5.xml:52 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:671 msgid "" - "Several instances of the same version of a package may be available when the " - "&sources-list; file contains references to more than one source. In this " - "case <command>apt-get</command> downloads the instance listed earliest in " - "the &sources-list; file. The APT preferences file does not affect the " - "choice of instance, only the choice of version." + "With a suitable &sources-list; file and the above preferences file, any of " + "the following commands will cause APT to upgrade to the latest version(s) in " + "the release codenamed with <literal>&testing-codename;</literal>. " + "<placeholder type=\"programlisting\" id=\"0\"/>" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> + #: apt_preferences.5.xml:691 + #, no-wrap + msgid "apt-get install <replaceable>package</replaceable>/sid\n" + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt_preferences.5.xml:682 + msgid "" + "The following command will cause APT to upgrade the specified package to the " + "latest version from the <literal>sid</literal> distribution. Thereafter, " + "<command>apt-get upgrade</command> will upgrade the package to the most " + "recent <literal>&testing-codename;</literal> version if that is more recent " + "than the installed version, otherwise, to the most recent " + "<literal>sid</literal> version if that is more recent than the installed " + "version. <placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt_preferences.5.xml:59 + #: apt_preferences.5.xml:706 + msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;" + msgstr "" + + #. type: Content of: <refentry><refnamediv><refpurpose> + #: sources.list.5.xml:33 + msgid "List of configured APT data sources" + msgstr "" + + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:38 msgid "" - "Preferences are a strong power in the hands of a system administrator but " - "they can become also their biggest nightmare if used without care! APT will " - "not questioning the preferences so wrong settings will therefore lead to " - "uninstallable packages or wrong decisions while upgrading packages. Even " - "more problems will arise if multiply distribution releases are mixed without " - "a good understanding of the following paragraphs. Packages included in a " - "specific release aren't tested in and therefore doesn't always work as " - "expected in older or newer releases or together with other packages from " - "different releases. You have been warned." + "The source list <filename>/etc/apt/sources.list</filename> is designed to " + "support any number of active sources and a variety of source media. The file " + "lists one source per line, with the most preferred source listed first. The " + "information available from the configured sources is acquired by " + "<command>apt-get update</command> (or by an equivalent command from another " + "APT front-end)." msgstr "" #. type: Content of: <refentry><refsect1><para> - #: apt_preferences.5.xml:70 + #: sources.list.5.xml:45 msgid "" - "Note that the files in the <filename>/etc/apt/preferences.d</filename> " - "directory are parsed in alphanumeric ascending order and need to obey the " - "following naming convention: The files have either no or " - "\"<literal>pref</literal>\" as filename extension and only contain " - "alphanumeric, hyphen (-), underscore (_) and period (.) characters. " - "Otherwise APT will print a notice that it has ignored a file if the file " - "doesn't match a pattern in the <literal>Dir::Ignore-Files-Silently</literal> " - "configuration list - in this case it will be silently ignored." + "Each line specifying a source starts with type " + "(e.g. <literal>deb-src</literal>) followed by options and arguments for " + "this type. Individual entries cannot be continued onto a following " + "line. Empty lines are ignored, and a <literal>#</literal> character anywhere " + "on a line marks the remainder of that line as a comment." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:79 - msgid "APT's Default Priority Assignments" + #. type: Content of: <refentry><refsect1><title> + #: sources.list.5.xml:53 + msgid "sources.list.d" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:94 - #, no-wrap + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:54 msgid "" - "<command>apt-get install -t testing " - "<replaceable>some-package</replaceable></command>\n" + "The <filename>/etc/apt/sources.list.d</filename> directory provides a way to " + "add sources.list entries in separate files. The format is the same as for " + "the regular <filename>sources.list</filename> file. File names need to end " + "with <filename>.list</filename> and may only contain letters (a-z and A-Z), " + "digits (0-9), underscore (_), hyphen (-) and period (.) characters. " + "Otherwise APT will print a notice that it has ignored a file, unless that " + "file matches a pattern in the <literal>Dir::Ignore-Files-Silently</literal> " + "configuration list - in which case it will be silently ignored." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:97 - #, no-wrap - msgid "APT::Default-Release \"stable\";\n" + #. type: Content of: <refentry><refsect1><title> + #: sources.list.5.xml:65 + msgid "The deb and deb-src types" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:81 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:66 msgid "" - "If there is no preferences file or if there is no entry in the file that " - "applies to a particular version then the priority assigned to that version " - "is the priority of the distribution to which that version belongs. It is " - "possible to single out a distribution, \"the target release\", which " - "receives a higher priority than other distributions do by default. The " - "target release can be set on the <command>apt-get</command> command line or " - "in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note " - "that this has precedence over any general priority you set in the " - "<filename>/etc/apt/preferences</filename> file described later, but not over " - "specifically pinned packages. For example, <placeholder " - "type=\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" " - "id=\"1\"/>" + "The <literal>deb</literal> type references a typical two-level Debian " + "archive, <filename>distribution/component</filename>. The " + "<literal>distribution</literal> is generally an archive name like " + "<literal>stable</literal> or <literal>testing</literal> or a codename like " + "<literal>&stable-codename;</literal> or " + "<literal>&testing-codename;</literal> while component is one of " + "<literal>main</literal>, <literal>contrib</literal> or " + "<literal>non-free</literal>. The <literal>deb-src</literal> type references " + "a Debian distribution's source code in the same form as the " + "<literal>deb</literal> type. A <literal>deb-src</literal> line is required " + "to fetch source indexes." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:101 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:78 msgid "" - "If the target release has been specified then APT uses the following " - "algorithm to set the priorities of the versions of a package. Assign:" + "The format for a <filename>sources.list</filename> entry using the " + "<literal>deb</literal> and <literal>deb-src</literal> types is:" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:106 - msgid "priority 1" + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:81 + #, no-wrap + msgid "deb [ options ] uri distribution [component1] [component2] [...]" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:107 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:83 msgid "" - "to the versions coming from archives which in their " - "<filename>Release</filename> files are marked as \"NotAutomatic: yes\" but " - "<emphasis>not</emphasis> as \"ButAutomaticUpgrades: yes\" like the debian " - "<literal>experimental</literal> archive." + "The URI for the <literal>deb</literal> type must specify the base of the " + "Debian distribution, from which APT will find the information it needs. " + "<literal>distribution</literal> can specify an exact path, in which case the " + "components must be omitted and <literal>distribution</literal> must end with " + "a slash (<literal>/</literal>). This is useful for the case when only a " + "particular sub-section of the archive denoted by the URI is of interest. If " + "<literal>distribution</literal> does not specify an exact path, at least one " + "<literal>component</literal> must be present." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:113 - msgid "priority 100" + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:92 + msgid "" + "<literal>distribution</literal> may also contain a variable, " + "<literal>$(ARCH)</literal> which expands to the Debian architecture (such as " + "<literal>amd64</literal> or <literal>armel</literal>) used on the " + "system. This permits architecture-independent " + "<filename>sources.list</filename> files to be used. In general this is only " + "of interest when specifying an exact path, <literal>APT</literal> will " + "automatically generate a URI with the current architecture otherwise." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:114 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:100 msgid "" - "to the version that is already installed (if any) and to the versions coming " - "from archives which in their <filename>Release</filename> files are marked " - "as \"NotAutomatic: yes\" and \"ButAutomaticUpgrades: yes\" like the debian " - "backports archive since <literal>squeeze-backports</literal>." + "Since only one distribution can be specified per line it may be necessary to " + "have multiple lines for the same URI, if a subset of all available " + "distributions or components at that location is desired. APT will sort the " + "URI list after it has generated a complete set internally, and will collapse " + "multiple references to the same Internet host, for instance, into a single " + "connection, so that it does not inefficiently establish an FTP connection, " + "close it, do something else, and then re-establish a connection to that same " + "host. This feature is useful for accessing busy FTP sites with limits on the " + "number of simultaneous anonymous users. APT also parallelizes connections to " + "different hosts to more effectively deal with sites with low bandwidth." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:121 - msgid "priority 500" + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:112 + msgid "" + "<literal>options</literal> is always optional and needs to be surrounded by " + "square brackets. It can consist of multiple settings in the form " + "<literal><replaceable>setting</replaceable>=<replaceable>value</replaceable></literal>. " + "Multiple settings are separated by spaces. The following settings are " + "supported by APT (note however that unsupported settings will be ignored " + "silently):" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:122 + #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> + #: sources.list.5.xml:117 msgid "" - "to the versions that are not installed and do not belong to the target " - "release." + "<literal>arch=<replaceable>arch1</replaceable>,<replaceable>arch2</replaceable>,…</literal> " + "can be used to specify for which architectures information should be " + "downloaded. If this option is not set all architectures defined by the " + "<literal>APT::Architectures</literal> option will be downloaded." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:126 - msgid "priority 990" + #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> + #: sources.list.5.xml:121 + msgid "" + "<literal>trusted=yes</literal> can be set to indicate that packages from " + "this source are always authenticated even if the " + "<filename>Release</filename> file is not signed or the signature can't be " + "checked. This disables parts of &apt-secure; and should therefore only be " + "used in a local and trusted context. <literal>trusted=no</literal> is the " + "opposite which handles even correctly authenticated sources as not " + "authenticated." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:127 - msgid "to the versions that are not installed and belong to the target release." + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:128 + msgid "" + "It is important to list sources in order of preference, with the most " + "preferred source listed first. Typically this will result in sorting by " + "speed from fastest to slowest (CD-ROM followed by hosts on a local network, " + "followed by distant Internet hosts, for example)." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:132 - msgid "" - "If the target release has not been specified then APT simply assigns " - "priority 100 to all installed package versions and priority 500 to all " - "uninstalled package versions, except versions coming from archives which in " - "their <filename>Release</filename> files are marked as \"NotAutomatic: yes\" " - "- these versions get the priority 1 or priority 100 if it is additionally " - "marked as \"ButAutomaticUpgrades: yes\"." + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:133 + msgid "Some examples:" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:139 + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:135 + #, no-wrap msgid "" - "APT then applies the following rules, listed in order of precedence, to " - "determine which version of a package to install." + "deb http://ftp.debian.org/debian &stable-codename; main contrib non-free\n" + "deb http://security.debian.org/ &stable-codename;/updates main contrib " + "non-free\n" + " " msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:142 - msgid "" - "Never downgrade unless the priority of an available version exceeds 1000. " - "(\"Downgrading\" is installing a less recent version of a package in place " - "of a more recent version. Note that none of APT's default priorities " - "exceeds 1000; such high priorities can only be set in the preferences file. " - "Note also that downgrading a package can be risky.)" + #. type: Content of: <refentry><refsect1><title> + #: sources.list.5.xml:141 + msgid "URI specification" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:148 - msgid "Install the highest priority version." + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:143 + msgid "The currently recognized URI types are:" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:149 + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> + #: sources.list.5.xml:147 msgid "" - "If two or more versions have the same priority, install the most recent one " - "(that is, the one with the higher version number)." + "The file scheme allows an arbitrary directory in the file system to be " + "considered an archive. This is useful for NFS mounts and local mirrors or " + "archives." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:152 + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> + #: sources.list.5.xml:154 msgid "" - "If two or more versions have the same priority and version number but either " - "the packages differ in some of their metadata or the " - "<literal>--reinstall</literal> option is given, install the uninstalled one." + "The cdrom scheme allows APT to use a local CD-ROM drive with media " + "swapping. Use the &apt-cdrom; program to create cdrom entries in the source " + "list." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:158 + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> + #: sources.list.5.xml:161 msgid "" - "In a typical situation, the installed version of a package (priority 100) " - "is not as recent as one of the versions available from the sources listed in " - "the &sources-list; file (priority 500 or 990). Then the package will be " - "upgraded when <command>apt-get install " - "<replaceable>some-package</replaceable></command> or <command>apt-get " - "upgrade</command> is executed." + "The http scheme specifies an HTTP server for the archive. If an environment " + "variable <envar>http_proxy</envar> is set with the format " + "http://server:port/, the proxy server specified in <envar>http_proxy</envar> " + "will be used. Users of authenticated HTTP/1.1 proxies may use a string of " + "the format http://user:pass@server:port/. Note that this is an insecure " + "method of authentication." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:165 + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> + #: sources.list.5.xml:172 msgid "" - "More rarely, the installed version of a package is <emphasis>more</emphasis> " - "recent than any of the other available versions. The package will not be " - "downgraded when <command>apt-get install " - "<replaceable>some-package</replaceable></command> or <command>apt-get " - "upgrade</command> is executed." + "The ftp scheme specifies an FTP server for the archive. APT's FTP behavior " + "is highly configurable; for more information see the &apt-conf; manual " + "page. Please note that an FTP proxy can be specified by using the " + "<envar>ftp_proxy</envar> environment variable. It is possible to specify an " + "HTTP proxy (HTTP proxy servers often understand FTP URLs) using this " + "environment variable and <emphasis>only</emphasis> this environment " + "variable. Proxies using HTTP specified in the configuration file will be " + "ignored." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:170 + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> + #: sources.list.5.xml:184 msgid "" - "Sometimes the installed version of a package is more recent than the version " - "belonging to the target release, but not as recent as a version belonging to " - "some other distribution. Such a package will indeed be upgraded when " - "<command>apt-get install <replaceable>some-package</replaceable></command> " - "or <command>apt-get upgrade</command> is executed, because at least " - "<emphasis>one</emphasis> of the available versions has a higher priority " - "than the installed version." + "The copy scheme is identical to the file scheme except that packages are " + "copied into the cache directory instead of used directly at their location. " + "This is useful for people using removable media to copy files around with " + "APT." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:179 - msgid "The Effect of APT Preferences" + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> + #: sources.list.5.xml:191 + msgid "" + "The rsh/ssh method invokes RSH/SSH to connect to a remote host and access " + "the files as a given user. Prior configuration of rhosts or RSA keys is " + "recommended. The standard <command>find</command> and <command>dd</command> " + "commands are used to perform the file transfers from the remote host." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:181 - msgid "" - "The APT preferences file allows the system administrator to control the " - "assignment of priorities. The file consists of one or more multi-line " - "records separated by blank lines. Records can have one of two forms, a " - "specific form and a general form." + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term> + #: sources.list.5.xml:198 + msgid "adding more recognizable URI types" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:187 + #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> + #: sources.list.5.xml:200 msgid "" - "The specific form assigns a priority (a \"Pin-Priority\") to one or more " - "specified packages and specified version or version range. For example, the " - "following record assigns a high priority to all versions of the " - "<filename>perl</filename> package whose version number begins with " - "\"<literal>5.8</literal>\". Multiple packages can be separated by spaces." + "APT can be extended with more methods shipped in other optional packages, " + "which should follow the naming scheme " + "<package>apt-transport-<replaceable>method</replaceable></package>. For " + "instance, the APT team also maintains the package " + "<package>apt-transport-https</package>, which provides access methods for " + "HTTPS URIs with features similar to the http method. Methods for using " + "e.g. debtorrent are also available - see &apt-transport-debtorrent;." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> - #: apt_preferences.5.xml:194 - #, no-wrap + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:212 msgid "" - "Package: perl\n" - "Pin: version 5.8*\n" - "Pin-Priority: 1001\n" + "Uses the archive stored locally (or NFS mounted) at /home/jason/debian for " + "stable/main, stable/contrib, and stable/non-free." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:200 - msgid "" - "The general form assigns a priority to all of the package versions in a " - "given distribution (that is, to all the versions of packages that are listed " - "in a certain <filename>Release</filename> file) or to all of the package " - "versions coming from a particular Internet site, as identified by the site's " - "fully qualified domain name." + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:214 + #, no-wrap + msgid "deb file:/home/jason/debian stable main contrib non-free" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:206 - msgid "" - "This general-form entry in the APT preferences file applies only to groups " - "of packages. For example, the following record assigns a high priority to " - "all package versions available from the local site." + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:216 + msgid "As above, except this uses the unstable (development) distribution." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> - #: apt_preferences.5.xml:211 + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:217 #, no-wrap - msgid "" - "Package: *\n" - "Pin: origin \"\"\n" - "Pin-Priority: 999\n" + msgid "deb file:/home/jason/debian unstable main contrib non-free" + msgstr "" + + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:219 + msgid "Source line for the above" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:216 - msgid "" - "A note of caution: the keyword used here is \"<literal>origin</literal>\" " - "which can be used to match a hostname. The following record will assign a " - "high priority to all versions available from the server identified by the " - "hostname \"ftp.de.debian.org\"" + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:220 + #, no-wrap + msgid "deb-src file:/home/jason/debian unstable main contrib non-free" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> - #: apt_preferences.5.xml:220 - #, no-wrap + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:222 msgid "" - "Package: *\n" - "Pin: origin \"ftp.de.debian.org\"\n" - "Pin-Priority: 999\n" + "The first line gets package information for the architectures in " + "<literal>APT::Architectures</literal> while the second always retrieves " + "<literal>amd64</literal> and <literal>armel</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:224 + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:224 + #, no-wrap msgid "" - "This should <emphasis>not</emphasis> be confused with the Origin of a " - "distribution as specified in a <filename>Release</filename> file. What " - "follows the \"Origin:\" tag in a <filename>Release</filename> file is not an " - "Internet address but an author or vendor name, such as \"Debian\" or " - "\"Ximian\"." + "deb http://ftp.debian.org/debian &stable-codename; main\n" + "deb [ arch=amd64,armel ] http://ftp.debian.org/debian &stable-codename; main" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:229 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:227 msgid "" - "The following record assigns a low priority to all package versions " - "belonging to any distribution whose Archive name is " - "\"<literal>unstable</literal>\"." + "Uses HTTP to access the archive at archive.debian.org, and uses only the " + "hamm/main area." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> - #: apt_preferences.5.xml:233 + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:229 #, no-wrap - msgid "" - "Package: *\n" - "Pin: release a=unstable\n" - "Pin-Priority: 50\n" + msgid "deb http://archive.debian.org/debian-archive hamm main" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:238 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:231 msgid "" - "The following record assigns a high priority to all package versions " - "belonging to any distribution whose Codename is " - "\"<literal>&testing-codename;</literal>\"." + "Uses FTP to access the archive at ftp.debian.org, under the debian " + "directory, and uses only the &stable-codename;/contrib area." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> - #: apt_preferences.5.xml:242 + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:233 #, no-wrap - msgid "" - "Package: *\n" - "Pin: release n=&testing-codename;\n" - "Pin-Priority: 900\n" + msgid "deb ftp://ftp.debian.org/debian &stable-codename; contrib" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:247 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:235 msgid "" - "The following record assigns a high priority to all package versions " - "belonging to any release whose Archive name is \"<literal>stable</literal>\" " - "and whose release Version number is \"<literal>3.0</literal>\"." + "Uses FTP to access the archive at ftp.debian.org, under the debian " + "directory, and uses only the unstable/contrib area. If this line appears as " + "well as the one in the previous example in <filename>sources.list</filename> " + "a single FTP session will be used for both resource lines." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting> - #: apt_preferences.5.xml:252 + #. type: Content of: <refentry><refsect1><literallayout> + #: sources.list.5.xml:239 #, no-wrap - msgid "" - "Package: *\n" - "Pin: release a=stable, v=3.0\n" - "Pin-Priority: 500\n" + msgid "deb ftp://ftp.debian.org/debian unstable contrib" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:262 - msgid "Regular expressions and glob() syntax" + #. type: Content of: <refentry><refsect1><para><literallayout> + #: sources.list.5.xml:248 + #, no-wrap + msgid "deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:264 + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:241 msgid "" - "APT also supports pinning by glob() expressions and regular expressions " - "surrounded by /. For example, the following example assigns the priority 500 " - "to all packages from experimental where the name starts with gnome (as a " - "glob()-like expression) or contains the word kde (as a POSIX extended " - "regular expression surrounded by slashes)." + "Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe " + "directory, and uses only files found under " + "<filename>unstable/binary-i386</filename> on i386 machines, " + "<filename>unstable/binary-amd64</filename> on amd64, and so forth for other " + "supported architectures. [Note this example only illustrates how to use the " + "substitution variable; official debian archives are not structured like " + "this] <placeholder type=\"literallayout\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><programlisting> - #: apt_preferences.5.xml:273 - #, no-wrap - msgid "" - "Package: gnome* /kde/\n" - "Pin: release n=experimental\n" - "Pin-Priority: 500\n" + #. type: Content of: <refentry><refsect1><para> + #: sources.list.5.xml:253 + msgid "&apt-cache; &apt-conf;" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:279 - msgid "" - "The rule for those expressions is that they can occur anywhere where a " - "string can occur. Thus, the following pin assigns the priority 990 to all " - "packages from a release starting with karmic." + #. type: Content of: <refentry><refmeta><manvolnum> + #: apt-extracttemplates.1.xml:26 apt-sortpkgs.1.xml:26 apt-ftparchive.1.xml:26 + msgid "1" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><programlisting> - #: apt_preferences.5.xml:285 - #, no-wrap + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt-extracttemplates.1.xml:33 msgid "" - "Package: *\n" - "Pin: release n=karmic*\n" - "Pin-Priority: 990\n" + "Utility to extract <command>debconf</command> config and templates from " + "Debian packages" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:291 + #. type: Content of: <refentry><refsect1><para> + #: apt-extracttemplates.1.xml:39 msgid "" - "If a regular expression occurs in a <literal>Package</literal> field, the " - "behavior is the same as if this regular expression were replaced with a list " - "of all package names it matches. It is undecided whether this will change in " - "the future, thus you should always list wild-card pins first, so later " - "specific pins override it. The pattern \"<literal>*</literal>\" in a " - "Package field is not considered a glob() expression in itself." + "<command>apt-extracttemplates</command> will take one or more Debian package " + "files as input and write out (to a temporary directory) all associated " + "config scripts and template files. For each passed in package that contains " + "config scripts and templates, one line of output will be generated in the " + "format:" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:307 - msgid "How APT Interprets Priorities" + #. type: Content of: <refentry><refsect1><para> + #: apt-extracttemplates.1.xml:44 + msgid "package version template-file config-script" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:310 + #. type: Content of: <refentry><refsect1><para> + #: apt-extracttemplates.1.xml:45 msgid "" - "Priorities (P) assigned in the APT preferences file must be positive or " - "negative integers. They are interpreted as follows (roughly speaking):" + "template-file and config-script are written to the temporary directory " + "specified by the <option>-t</option> or <option>--tempdir</option> " + "(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with " + "filenames of the form <filename>package.template.XXXX</filename> and " + "<filename>package.config.XXXX</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:315 - msgid "P > 1000" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-extracttemplates.1.xml:58 + msgid "" + "Temporary directory in which to write extracted <command>debconf</command> " + "template files and config scripts. Configuration Item: " + "<literal>APT::ExtractTemplates::TempDir</literal>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:316 + #. type: Content of: <refentry><refsect1><para> + #: apt-extracttemplates.1.xml:75 msgid "" - "causes a version to be installed even if this constitutes a downgrade of the " - "package" + "<command>apt-extracttemplates</command> returns zero on normal operation, " + "decimal 100 on error." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:320 - msgid "990 < P <=1000" + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt-sortpkgs.1.xml:33 + msgid "Utility to sort package index files" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:321 + #. type: Content of: <refentry><refsect1><para> + #: apt-sortpkgs.1.xml:39 msgid "" - "causes a version to be installed even if it does not come from the target " - "release, unless the installed version is more recent" + "<command>apt-sortpkgs</command> will take an index file (source index or " + "package index) and sort the records so that they are ordered by the package " + "name. It will also sort the internal fields of each record according to the " + "internal sorting rules." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:326 - msgid "500 < P <=990" + #. type: Content of: <refentry><refsect1><para> + #: apt-sortpkgs.1.xml:45 + msgid "All output is sent to standard output; the input must be a seekable file." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:327 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-sortpkgs.1.xml:54 msgid "" - "causes a version to be installed unless there is a version available " - "belonging to the target release or the installed version is more recent" - msgstr "" - - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:332 - msgid "100 < P <=500" + "Use source index field ordering. Configuration Item: " + "<literal>APT::SortPkgs::Source</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:333 + #. type: Content of: <refentry><refsect1><para> + #: apt-sortpkgs.1.xml:68 msgid "" - "causes a version to be installed unless there is a version available " - "belonging to some other distribution or the installed version is more recent" + "<command>apt-sortpkgs</command> returns zero on normal operation, decimal " + "100 on error." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:338 - msgid "0 < P <=100" + #. type: Content of: <refentry><refnamediv><refpurpose> + #: apt-ftparchive.1.xml:33 + msgid "Utility to generate index files" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:339 + #. type: Content of: <refentry><refsect1><para> + #: apt-ftparchive.1.xml:39 msgid "" - "causes a version to be installed only if there is no installed version of " - "the package" - msgstr "" - - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:343 - msgid "P < 0" + "<command>apt-ftparchive</command> is the command line tool that generates " + "the index files that APT uses to access a distribution source. The index " + "files should be generated on the origin site based on the content of that " + "site." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:344 - msgid "prevents the version from being installed" + #. type: Content of: <refentry><refsect1><para> + #: apt-ftparchive.1.xml:43 + msgid "" + "<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; " + "program, incorporating its entire functionality via the " + "<literal>packages</literal> command. It also contains a contents file " + "generator, <literal>contents</literal>, and an elaborate means to 'script' " + "the generation process for a complete archive." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:349 + #. type: Content of: <refentry><refsect1><para> + #: apt-ftparchive.1.xml:49 msgid "" - "If any specific-form records match an available package version then the " - "first such record determines the priority of the package version. Failing " - "that, if any general-form records match an available package version then " - "the first such record determines the priority of the package version." + "Internally <command>apt-ftparchive</command> can make use of binary " + "databases to cache the contents of a .deb file and it does not rely on any " + "external programs aside from &gzip;. When doing a full generate it " + "automatically performs file-change checks and builds the desired compressed " + "output files." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:355 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:60 msgid "" - "For example, suppose the APT preferences file contains the three records " - "presented earlier:" + "The packages command generates a package file from a directory tree. It " + "takes the given directory and recursively searches it for .deb files, " + "emitting a package record to stdout for each. This command is approximately " + "equivalent to &dpkg-scanpackages;." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><programlisting> - #: apt_preferences.5.xml:359 - #, no-wrap - msgid "" - "Package: perl\n" - "Pin: version 5.8*\n" - "Pin-Priority: 1001\n" - "\n" - "Package: *\n" - "Pin: origin \"\"\n" - "Pin-Priority: 999\n" - "\n" - "Package: *\n" - "Pin: release unstable\n" - "Pin-Priority: 50\n" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:65 apt-ftparchive.1.xml:89 + msgid "The option <option>--db</option> can be used to specify a binary caching DB." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:372 - msgid "Then:" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:70 + msgid "" + "The <literal>sources</literal> command generates a source index file from a " + "directory tree. It takes the given directory and recursively searches it " + "for .dsc files, emitting a source record to stdout for each. This command is " + "approximately equivalent to &dpkg-scansources;." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:374 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:75 msgid "" - "The most recent available version of the <literal>perl</literal> package " - "will be installed, so long as that version's version number begins with " - "\"<literal>5.8</literal>\". If <emphasis>any</emphasis> 5.8* version of " - "<literal>perl</literal> is available and the installed version is 5.9*, then " - "<literal>perl</literal> will be downgraded." + "If an override file is specified then a source override file will be looked " + "for with an extension of .src. The --source-override option can be used to " + "change the source override file that will be used." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:379 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:82 msgid "" - "A version of any package other than <literal>perl</literal> that is " - "available from the local system has priority over other versions, even " - "versions belonging to the target release." + "The <literal>contents</literal> command generates a contents file from a " + "directory tree. It takes the given directory and recursively searches it for " + ".deb files, and reads the file list from each file. It then sorts and writes " + "to stdout the list of files matched to packages. Directories are not written " + "to the output. If multiple packages own the same file then each package is " + "separated by a comma in the output." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara> - #: apt_preferences.5.xml:383 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:94 msgid "" - "A version of a package whose origin is not the local system but some other " - "site listed in &sources-list; and which belongs to an " - "<literal>unstable</literal> distribution is only installed if it is selected " - "for installation and no version of the package is already installed." + "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 " + "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 <filename>Release</filename> file containing an MD5, SHA1 and " + "SHA256 digest for each file." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:393 - msgid "Determination of Package Version and Distribution Properties" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:104 + msgid "" + "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>, <literal>Version</literal>, " + "<literal>Codename</literal>, <literal>Date</literal>, " + "<literal>Valid-Until</literal>, <literal>Architectures</literal>, " + "<literal>Components</literal>, <literal>Description</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:395 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:117 msgid "" - "The locations listed in the &sources-list; file should provide " - "<filename>Packages</filename> and <filename>Release</filename> files to " - "describe the packages available at that location." + "The <literal>generate</literal> command is designed to be runnable from a " + "cron script and builds indexes according to the given config file. The " + "config language provides a flexible means of specifying which index files " + "are built from which directories, as well as providing a simple means of " + "maintaining the required settings." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:399 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:126 msgid "" - "The <filename>Packages</filename> file is normally found in the directory " - "<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: " - "for example, " - "<filename>.../dists/stable/main/binary-i386/Packages</filename>. It " - "consists of a series of multi-line records, one for each package available " - "in that directory. Only two lines in each record are relevant for setting " - "APT priorities:" + "The <literal>clean</literal> command tidies the databases used by the given " + "configuration file by removing any records that are no longer necessary." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:407 - msgid "the <literal>Package:</literal> line" + #. type: Content of: <refentry><refsect1><title> + #: apt-ftparchive.1.xml:132 + msgid "The Generate Configuration" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:408 - msgid "gives the package name" + #. type: Content of: <refentry><refsect1><para> + #: apt-ftparchive.1.xml:134 + msgid "" + "The <literal>generate</literal> command uses a configuration file to " + "describe the archives that are going to be generated. It follows the typical " + "ISC configuration format as seen in ISC tools like bind 8 and dhcpd. " + "&apt-conf; contains a description of the syntax. Note that the generate " + "configuration is parsed in sectional manner, but &apt-conf; is parsed in a " + "tree manner. This only effects how the scope tag is handled." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:411 apt_preferences.5.xml:461 - msgid "the <literal>Version:</literal> line" + #. type: Content of: <refentry><refsect1><para> + #: apt-ftparchive.1.xml:142 + msgid "The generate configuration has four separate sections, each described below." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:412 - msgid "gives the version number for the named package" + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt-ftparchive.1.xml:144 + msgid "<literal>Dir</literal> Section" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:417 + #: apt-ftparchive.1.xml:146 msgid "" - "The <filename>Release</filename> file is normally found in the directory " - "<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for " - "example, <filename>.../dists/stable/Release</filename>, or " - "<filename>.../dists/&stable-codename;/Release</filename>. It consists of a " - "single multi-line record which applies to <emphasis>all</emphasis> of the " - "packages in the directory tree below its parent. Unlike the " - "<filename>Packages</filename> file, nearly all of the lines in a " - "<filename>Release</filename> file are relevant for setting APT priorities:" - msgstr "" - - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:428 - msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line" + "The <literal>Dir</literal> section defines the standard directories needed " + "to locate the files required during the generation process. These " + "directories are prepended certain relative paths defined in later sections " + "to produce a complete an absolute path." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:429 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:153 msgid "" - "names the archive to which all the packages in the directory tree belong. " - "For example, the line \"Archive: stable\" or \"Suite: stable\" specifies " - "that all of the packages in the directory tree below the parent of the " - "<filename>Release</filename> file are in a <literal>stable</literal> " - "archive. Specifying this value in the APT preferences file would require " - "the line:" + "Specifies the root of the FTP archive, in a standard Debian configuration " + "this is the directory that contains the <filename>ls-LR</filename> and dist " + "nodes." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> - #: apt_preferences.5.xml:439 - #, no-wrap - msgid "Pin: release a=stable\n" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:160 + msgid "Specifies the location of the override files." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:445 - msgid "the <literal>Codename:</literal> line" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:165 + msgid "Specifies the location of the cache files." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:446 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:170 msgid "" - "names the codename to which all the packages in the directory tree belong. " - "For example, the line \"Codename: &testing-codename;\" specifies that all of " - "the packages in the directory tree below the parent of the " - "<filename>Release</filename> file belong to a version named " - "<literal>&testing-codename;</literal>. Specifying this value in the APT " - "preferences file would require the line:" + "Specifies the location of the file list files, if the " + "<literal>FileList</literal> setting is used below." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> - #: apt_preferences.5.xml:455 - #, no-wrap - msgid "Pin: release n=&testing-codename;\n" + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt-ftparchive.1.xml:176 + msgid "<literal>Default</literal> Section" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:462 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt-ftparchive.1.xml:178 msgid "" - "names the release version. For example, the packages in the tree might " - "belong to Debian release version 3.0. Note that there is normally no " - "version number for the <literal>testing</literal> and " - "<literal>unstable</literal> distributions because they have not been " - "released yet. Specifying this in the APT preferences file would require one " - "of the following lines." + "The <literal>Default</literal> section specifies default values, and " + "settings that control the operation of the generator. Other sections may " + "override these defaults with a per-section setting." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> - #: apt_preferences.5.xml:471 - #, no-wrap + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:184 msgid "" - "Pin: release v=3.0\n" - "Pin: release a=stable, v=3.0\n" - "Pin: release 3.0\n" - msgstr "" - - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:480 - msgid "the <literal>Component:</literal> line" + "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'." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:481 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:192 msgid "" - "names the licensing component associated with the packages in the directory " - "tree of the <filename>Release</filename> file. For example, the line " - "\"Component: main\" specifies that all the packages in the directory tree " - "are from the <literal>main</literal> component, which entails that they are " - "licensed under terms listed in the Debian Free Software Guidelines. " - "Specifying this component in the APT preferences file would require the " - "line:" - msgstr "" - - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> - #: apt_preferences.5.xml:490 - #, no-wrap - msgid "Pin: release c=main\n" + "Sets the default list of file extensions that are package files. This " + "defaults to '.deb'." msgstr "" - - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:496 - msgid "the <literal>Origin:</literal> line" + + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:198 + msgid "" + "This is similar to <literal>Packages::Compress</literal> except that it " + "controls the compression for the Sources files." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:497 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:204 msgid "" - "names the originator of the packages in the directory tree of the " - "<filename>Release</filename> file. Most commonly, this is " - "<literal>Debian</literal>. Specifying this origin in the APT preferences " - "file would require the line:" + "Sets the default list of file extensions that are source files. This " + "defaults to '.dsc'." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> - #: apt_preferences.5.xml:503 - #, no-wrap - msgid "Pin: release o=Debian\n" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:210 + msgid "" + "This is similar to <literal>Packages::Compress</literal> except that it " + "controls the compression for the Contents files." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term> - #: apt_preferences.5.xml:509 - msgid "the <literal>Label:</literal> line" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:216 + msgid "" + "This is similar to <literal>Packages::Compress</literal> except that it " + "controls the compression for the Translation-en master file." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> - #: apt_preferences.5.xml:510 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:222 msgid "" - "names the label of the packages in the directory tree of the " - "<filename>Release</filename> file. Most commonly, this is " - "<literal>Debian</literal>. Specifying this label in the APT preferences " - "file would require the line:" + "Specifies the number of kilobytes to delink (and replace with hard links) " + "per run. This is used in conjunction with the per-section " + "<literal>External-Links</literal> setting." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting> - #: apt_preferences.5.xml:516 - #, no-wrap - msgid "Pin: release l=Debian\n" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:229 + msgid "" + "Specifies the mode of all created index files. It defaults to 0644. All " + "index files are set to this mode with no regard to the umask." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:523 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:236 apt-ftparchive.1.xml:382 msgid "" - "All of the <filename>Packages</filename> and <filename>Release</filename> " - "files retrieved from locations listed in the &sources-list; file are stored " - "in the directory <filename>/var/lib/apt/lists</filename>, or in the file " - "named by the variable <literal>Dir::State::Lists</literal> in the " - "<filename>apt.conf</filename> file. For example, the file " - "<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> " - "contains the <filename>Release</filename> file retrieved from the site " - "<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> " - "architecture files from the <literal>contrib</literal> component of the " - "<literal>unstable</literal> distribution." + "Specifies whether long descriptions should be included in the " + "<filename>Packages</filename> file or split out into a master " + "<filename>Translation-en</filename> file." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:536 - msgid "Optional Lines in an APT Preferences Record" + #: apt-ftparchive.1.xml:242 + msgid "<literal>TreeDefault</literal> Section" msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:538 + #: apt-ftparchive.1.xml:244 msgid "" - "Each record in the APT preferences file can optionally begin with one or " - "more lines beginning with the word <literal>Explanation:</literal>. This " - "provides a place for comments." + "Sets defaults specific to <literal>Tree</literal> sections. All of these " + "variables are substitution variables and have the strings $(DIST), " + "$(SECTION) and $(ARCH) replaced with their respective values." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:547 - msgid "Tracking Stable" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:251 + msgid "" + "Sets the number of kilobytes of contents files that are generated each " + "day. The contents files are round-robined so that over several days they " + "will all be rebuilt." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:555 - #, no-wrap + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:258 msgid "" - "Explanation: Uninstall or do not install any Debian-originated\n" - "Explanation: package versions other than those in the stable distro\n" - "Package: *\n" - "Pin: release a=stable\n" - "Pin-Priority: 900\n" - "\n" - "Package: *\n" - "Pin: release o=Debian\n" - "Pin-Priority: -10\n" + "Controls the number of days a contents file is allowed to be checked without " + "changing. If this limit is passed the mtime of the contents file is " + "updated. This case can occur if the package file is changed in such a way " + "that does not result in a new contents file [override edit for instance]. A " + "hold off is allowed in hopes that new .debs will be installed, requiring a " + "new file anyhow. The default is 10, the units are in days." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:549 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:269 msgid "" - "The following APT preferences file will cause APT to assign a priority " - "higher than the default (500) to all package versions belonging to a " - "<literal>stable</literal> distribution and a prohibitively low priority to " - "package versions belonging to other <literal>Debian</literal> " - "distributions. <placeholder type=\"programlisting\" id=\"0\"/>" + "Sets the top of the .deb directory tree. Defaults to " + "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:572 apt_preferences.5.xml:618 apt_preferences.5.xml:676 - #, no-wrap + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:275 msgid "" - "apt-get install <replaceable>package-name</replaceable>\n" - "apt-get upgrade\n" - "apt-get dist-upgrade\n" + "Sets the top of the source package directory tree. Defaults to " + "<filename>$(DIST)/$(SECTION)/source/</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:567 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:281 msgid "" - "With a suitable &sources-list; file and the above preferences file, any of " - "the following commands will cause APT to upgrade to the latest " - "<literal>stable</literal> version(s). <placeholder type=\"programlisting\" " - "id=\"0\"/>" + "Sets the output Packages file. Defaults to " + "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:584 - #, no-wrap - msgid "apt-get install <replaceable>package</replaceable>/testing\n" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:287 + msgid "" + "Sets the output Sources file. Defaults to " + "<filename>$(DIST)/$(SECTION)/source/Sources</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:578 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:293 msgid "" - "The following command will cause APT to upgrade the specified package to the " - "latest version from the <literal>testing</literal> distribution; the package " - "will not be upgraded again unless this command is given again. <placeholder " - "type=\"programlisting\" id=\"0\"/>" + "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>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:590 - msgid "Tracking Testing or Unstable" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:300 + msgid "" + "Sets the path prefix that causes a symlink to be considered an internal link " + "instead of an external link. Defaults to " + "<filename>$(DIST)/$(SECTION)/</filename>" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:599 - #, no-wrap + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:307 msgid "" - "Package: *\n" - "Pin: release a=testing\n" - "Pin-Priority: 900\n" - "\n" - "Package: *\n" - "Pin: release a=unstable\n" - "Pin-Priority: 800\n" - "\n" - "Package: *\n" - "Pin: release o=Debian\n" - "Pin-Priority: -10\n" + "Sets the output Contents file. Defaults to " + "<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." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:592 - msgid "" - "The following APT preferences file will cause APT to assign a high priority " - "to package versions from the <literal>testing</literal> distribution, a " - "lower priority to package versions from the <literal>unstable</literal> " - "distribution, and a prohibitively low priority to package versions from " - "other <literal>Debian</literal> distributions. <placeholder " - "type=\"programlisting\" id=\"0\"/>" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:316 + msgid "Sets header file to prepend to the contents output." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:613 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:321 msgid "" - "With a suitable &sources-list; file and the above preferences file, any of " - "the following commands will cause APT to upgrade to the latest " - "<literal>testing</literal> version(s). <placeholder type=\"programlisting\" " - "id=\"0\"/>" + "Sets the binary cache database to use for this section. Multiple sections " + "can share the same database." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:633 - #, no-wrap - msgid "apt-get install <replaceable>package</replaceable>/unstable\n" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:327 + msgid "" + "Specifies that instead of walking the directory tree, " + "<command>apt-ftparchive</command> should read the list of files from the " + "given file. Relative files names are prefixed with the archive directory." msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:624 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:334 msgid "" - "The following command will cause APT to upgrade the specified package to the " - "latest version from the <literal>unstable</literal> distribution. " - "Thereafter, <command>apt-get upgrade</command> will upgrade the package to " - "the most recent <literal>testing</literal> version if that is more recent " - "than the installed version, otherwise, to the most recent " - "<literal>unstable</literal> version if that is more recent than the " - "installed version. <placeholder type=\"programlisting\" id=\"0\"/>" + "Specifies that instead of walking the directory tree, " + "<command>apt-ftparchive</command> should read the list of files from the " + "given file. Relative files names are prefixed with the archive directory. " + "This is used when processing source indexes." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> - #: apt_preferences.5.xml:640 - msgid "Tracking the evolution of a codename release" + #: apt-ftparchive.1.xml:342 + msgid "<literal>Tree</literal> Section" msgstr "" - #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:654 - #, no-wrap - msgid "" - "Explanation: Uninstall or do not install any Debian-originated package " - "versions\n" - "Explanation: other than those in the distribution codenamed with " - "&testing-codename; or sid\n" - "Package: *\n" - "Pin: release n=&testing-codename;\n" - "Pin-Priority: 900\n" - "\n" - "Explanation: Debian unstable is always codenamed with sid\n" - "Package: *\n" - "Pin: release n=sid\n" - "Pin-Priority: 800\n" - "\n" - "Package: *\n" - "Pin: release o=Debian\n" - "Pin-Priority: -10\n" + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt-ftparchive.1.xml:344 + msgid "" + "The <literal>Tree</literal> section defines a standard Debian file tree " + "which consists of a base directory, then multiple sections in that base " + "directory and finally multiple Architectures in each section. The exact " + "pathing used is defined by the <literal>Directory</literal> substitution " + "variable." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:642 + #: apt-ftparchive.1.xml:349 msgid "" - "The following APT preferences file will cause APT to assign a priority " - "higher than the default (500) to all package versions belonging to a " - "specified codename of a distribution and a prohibitively low priority to " - "package versions belonging to other <literal>Debian</literal> distributions, " - "codenames and archives. Note that with this APT preference APT will follow " - "the migration of a release from the archive <literal>testing</literal> to " - "<literal>stable</literal> and later <literal>oldstable</literal>. If you " - "want to follow for example the progress in <literal>testing</literal> " - "notwithstanding the codename changes you should use the example " - "configurations above. <placeholder type=\"programlisting\" id=\"0\"/>" + "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>." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:671 + #: apt-ftparchive.1.xml:354 msgid "" - "With a suitable &sources-list; file and the above preferences file, any of " - "the following commands will cause APT to upgrade to the latest version(s) in " - "the release codenamed with <literal>&testing-codename;</literal>. " - "<placeholder type=\"programlisting\" id=\"0\"/>" + "All of the settings defined in the <literal>TreeDefault</literal> section " + "can be used in a <literal>Tree</literal> section as well as three new " + "variables." msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para><programlisting> - #: apt_preferences.5.xml:691 + #: apt-ftparchive.1.xml:360 #, no-wrap - msgid "apt-get install <replaceable>package</replaceable>/sid\n" + msgid "" + "for i in Sections do \n" + " for j in Architectures do\n" + " Generate for DIST=scope SECTION=i ARCH=j\n" + " " msgstr "" #. type: Content of: <refentry><refsect1><refsect2><para> - #: apt_preferences.5.xml:682 + #: apt-ftparchive.1.xml:357 msgid "" - "The following command will cause APT to upgrade the specified package to the " - "latest version from the <literal>sid</literal> distribution. Thereafter, " - "<command>apt-get upgrade</command> will upgrade the package to the most " - "recent <literal>&testing-codename;</literal> version if that is more recent " - "than the installed version, otherwise, to the most recent " - "<literal>sid</literal> version if that is more recent than the installed " - "version. <placeholder type=\"programlisting\" id=\"0\"/>" + "When processing a <literal>Tree</literal> section " + "<command>apt-ftparchive</command> performs an operation similar to: " + "<placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: apt_preferences.5.xml:706 - msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:368 + msgid "" + "This is a space separated list of sections which appear under the " + "distribution; typically this is something like <literal>main contrib " + "non-free</literal>" msgstr "" - #. type: Content of: <refentry><refnamediv><refpurpose> - #: sources.list.5.xml:33 - msgid "Package resource list for APT" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:375 + msgid "" + "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." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:37 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:388 msgid "" - "The package resource list is used to locate archives of the package " - "distribution system in use on the system. At this time, this manual page " - "documents only the packaging system used by the Debian system. This control " - "file is <filename>/etc/apt/sources.list</filename>." + "Sets the binary override file. The override file contains section, priority " + "and maintainer address information." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:42 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:394 msgid "" - "The source list is designed to support any number of active sources and a " - "variety of source media. The file lists one source per line, with the most " - "preferred source listed first. The format of each line is: <literal>type uri " - "args</literal> The first item, <literal>type</literal> determines the format " - "for <literal>args</literal>. <literal>uri</literal> is a Universal Resource " - "Identifier (URI), which is a superset of the more specific and well-known " - "Universal Resource Locator, or URL. The rest of the line can be marked as a " - "comment by using a #." + "Sets the source override file. The override file contains section " + "information." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: sources.list.5.xml:53 - msgid "sources.list.d" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:400 apt-ftparchive.1.xml:446 + msgid "Sets the binary extra override file." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:54 - msgid "" - "The <filename>/etc/apt/sources.list.d</filename> directory provides a way to " - "add sources.list entries in separate files. The format is the same as for " - "the regular <filename>sources.list</filename> file. File names need to end " - "with <filename>.list</filename> and may only contain letters (a-z and A-Z), " - "digits (0-9), underscore (_), hyphen (-) and period (.) characters. " - "Otherwise APT will print a notice that it has ignored a file if the file " - "doesn't match a pattern in the <literal>Dir::Ignore-Files-Silently</literal> " - "configuration list - in this case it will be silently ignored." + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:405 apt-ftparchive.1.xml:451 + msgid "Sets the source extra override file." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: sources.list.5.xml:65 - msgid "The deb and deb-src types" + #. type: Content of: <refentry><refsect1><refsect2><title> + #: apt-ftparchive.1.xml:410 + msgid "<literal>BinDirectory</literal> Section" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:66 + #. type: Content of: <refentry><refsect1><refsect2><para> + #: apt-ftparchive.1.xml:412 msgid "" - "The <literal>deb</literal> type describes a typical two-level Debian " - "archive, <filename>distribution/component</filename>. Typically, " - "<literal>distribution</literal> is generally an archivename like " - "<literal>stable</literal> or <literal>testing</literal> or a codename like " - "<literal>&stable-codename;</literal> or " - "<literal>&testing-codename;</literal> while component is one of " - "<literal>main</literal> <literal>contrib</literal> or " - "<literal>non-free</literal>. The <literal>deb-src</literal> type describes a " - "debian distribution's source code in the same form as the " - "<literal>deb</literal> type. A <literal>deb-src</literal> line is required " - "to fetch source indexes." + "The <literal>bindirectory</literal> section defines a binary directory tree " + "with no special structure. The scope tag specifies the location of the " + "binary directory and the settings are similar to the <literal>Tree</literal> " + "section with no substitution variables or " + "<literal>Section</literal><literal>Architecture</literal> settings." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:78 + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:420 + msgid "Sets the Packages file output." + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:425 msgid "" - "The format for a <filename>sources.list</filename> entry using the " - "<literal>deb</literal> and <literal>deb-src</literal> types is:" + "Sets the Sources file output. At least one of <literal>Packages</literal> or " + "<literal>Sources</literal> is required." msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:81 - #, no-wrap - msgid "deb [ options ] uri distribution [component1] [component2] [...]" + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:431 + msgid "Sets the Contents file output (optional)." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:83 - msgid "" - "The URI for the <literal>deb</literal> type must specify the base of the " - "Debian distribution, from which APT will find the information it needs. " - "<literal>distribution</literal> can specify an exact path, in which case the " - "components must be omitted and <literal>distribution</literal> must end with " - "a slash (/). This is useful for when the case only a particular sub-section " - "of the archive denoted by the URI is of interest. If " - "<literal>distribution</literal> does not specify an exact path, at least one " - "<literal>component</literal> must be present." + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:436 + msgid "Sets the binary override file." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:92 - msgid "" - "<literal>distribution</literal> may also contain a variable, " - "<literal>$(ARCH)</literal> which expands to the Debian architecture (i386, " - "m68k, powerpc, ...) used on the system. This permits " - "architecture-independent <filename>sources.list</filename> files to be " - "used. In general this is only of interest when specifying an exact path, " - "<literal>APT</literal> will automatically generate a URI with the current " - "architecture otherwise." + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:441 + msgid "Sets the source override file." + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:456 + msgid "Sets the cache DB." + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:461 + msgid "Appends a path to all the output paths." + msgstr "" + + #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:466 + msgid "Specifies the file list file." + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt-ftparchive.1.xml:473 + msgid "The Binary Override File" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:100 + #: apt-ftparchive.1.xml:474 msgid "" - "Since only one distribution can be specified per line it may be necessary to " - "have multiple lines for the same URI, if a subset of all available " - "distributions or components at that location is desired. APT will sort the " - "URI list after it has generated a complete set internally, and will collapse " - "multiple references to the same Internet host, for instance, into a single " - "connection, so that it does not inefficiently establish an FTP connection, " - "close it, do something else, and then re-establish a connection to that same " - "host. This feature is useful for accessing busy FTP sites with limits on the " - "number of simultaneous anonymous users. APT also parallelizes connections to " - "different hosts to more effectively deal with sites with low bandwidth." + "The binary override file is fully compatible with &dpkg-scanpackages;. It " + "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." + msgstr "" + + #. type: Content of: <refentry><refsect1><para><literallayout> + #: apt-ftparchive.1.xml:480 + #, no-wrap + msgid "old [// oldn]* => new" + msgstr "" + + #. type: Content of: <refentry><refsect1><para><literallayout> + #: apt-ftparchive.1.xml:482 + #, no-wrap + msgid "new" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:112 + #: apt-ftparchive.1.xml:479 msgid "" - "<literal>options</literal> is always optional and needs to be surounded by " - "square brackets. It can consist of multiple settings in the form " - "<literal><replaceable>setting</replaceable>=<replaceable>value</replaceable></literal>. " - "Multiple settings are separated by spaces. The following settings are " - "supported by APT, note though that unsupported settings will be ignored " - "silently:" + "The general form of the maintainer field is: <placeholder " + "type=\"literallayout\" id=\"0\"/> or simply, <placeholder " + "type=\"literallayout\" id=\"1\"/> The first form allows a double-slash " + "separated list of old email addresses to be specified. If any of those are " + "found then new is substituted for the maintainer field. The second form " + "unconditionally substitutes the maintainer field." msgstr "" - #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> - #: sources.list.5.xml:117 - msgid "" - "<literal>arch=<replaceable>arch1</replaceable>,<replaceable>arch2</replaceable>,…</literal> " - "can be used to specify for which architectures packages information should " - "be downloaded. If this option is not set all architectures defined by the " - "<literal>APT::Architectures</literal> option will be downloaded." + #. type: Content of: <refentry><refsect1><title> + #: apt-ftparchive.1.xml:490 + msgid "The Source Override File" msgstr "" - #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> - #: sources.list.5.xml:121 + #. type: Content of: <refentry><refsect1><para> + #: apt-ftparchive.1.xml:492 msgid "" - "<literal>trusted=yes</literal> can be set to indicate that packages from " - "this source are always authenticated even if the " - "<filename>Release</filename> file is not signed or the signature can't be " - "checked. This disables parts of &apt-secure; and should therefore only be " - "used in a local and trusted context. <literal>trusted=no</literal> is the " - "opposite which handles even correctly authenticated sources as not " - "authenticated." + "The source override file is fully compatible with &dpkg-scansources;. It " + "contains two fields separated by spaces. The first field is the source " + "package name, the second is the section to assign it." + msgstr "" + + #. type: Content of: <refentry><refsect1><title> + #: apt-ftparchive.1.xml:497 + msgid "The Extra Override File" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:128 + #: apt-ftparchive.1.xml:499 msgid "" - "It is important to list sources in order of preference, with the most " - "preferred source listed first. Typically this will result in sorting by " - "speed from fastest to slowest (CD-ROM followed by hosts on a local network, " - "followed by distant Internet hosts, for example)." + "The extra override file allows any arbitrary tag to be added or replaced 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." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:133 - msgid "Some examples:" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:510 + msgid "" + "Generate the given checksum. These options default to on, when turned off " + "the generated index files will not have the checksum fields where possible. " + "Configuration Items: " + "<literal>APT::FTPArchive::<replaceable>Checksum</replaceable></literal> and " + "<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>." msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:135 - #, no-wrap + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:521 msgid "" - "deb http://ftp.debian.org/debian &stable-codename; main contrib non-free\n" - "deb http://security.debian.org/ &stable-codename;/updates main contrib " - "non-free\n" - " " + "Use a binary caching DB. This has no effect on the generate command. " + "Configuration Item: <literal>APT::FTPArchive::DB</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><title> - #: sources.list.5.xml:141 - msgid "URI specification" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:527 + msgid "" + "Quiet; produces output suitable for logging, omitting progress indicators. " + "More q's will produce more quiet up to a maximum of 2. You can also use " + "<option>-q=#</option> to set the quiet level, overriding the configuration " + "file. Configuration Item: <literal>quiet</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:143 - msgid "The currently recognized URI types are:" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:535 + msgid "" + "Perform Delinking. If the <literal>External-Links</literal> setting is used " + "then this option actually enables delinking of the files. It defaults to on " + "and can be turned off with <option>--no-delink</option>. Configuration " + "Item: <literal>APT::FTPArchive::DeLinkAct</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: sources.list.5.xml:147 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:543 msgid "" - "The file scheme allows an arbitrary directory in the file system to be " - "considered an archive. This is useful for NFS mounts and local mirrors or " - "archives." + "Perform contents generation. When this option is set and package indexes are " + "being generated with a cache DB then the file listing will also be extracted " + "and stored in the DB for later use. When using the generate command this " + "option also allows the creation of any Contents files. The default is on. " + "Configuration Item: <literal>APT::FTPArchive::Contents</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: sources.list.5.xml:154 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:553 msgid "" - "The cdrom scheme allows APT to use a local CDROM drive with media " - "swapping. Use the &apt-cdrom; program to create cdrom entries in the source " - "list." + "Select the source override file to use with the <literal>sources</literal> " + "command. Configuration Item: " + "<literal>APT::FTPArchive::SourceOverride</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: sources.list.5.xml:161 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:559 msgid "" - "The http scheme specifies an HTTP server for the archive. If an environment " - "variable <envar>http_proxy</envar> is set with the format " - "http://server:port/, the proxy server specified in <envar>http_proxy</envar> " - "will be used. Users of authenticated HTTP/1.1 proxies may use a string of " - "the format http://user:pass@server:port/. Note that this is an insecure " - "method of authentication." + "Make the caching databases read only. Configuration Item: " + "<literal>APT::FTPArchive::ReadOnlyDB</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: sources.list.5.xml:172 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:564 msgid "" - "The ftp scheme specifies an FTP server for the archive. APT's FTP behavior " - "is highly configurable; for more information see the &apt-conf; manual " - "page. Please note that a ftp proxy can be specified by using the " - "<envar>ftp_proxy</envar> environment variable. It is possible to specify a " - "http proxy (http proxy servers often understand ftp urls) using this method " - "and ONLY this method. ftp proxies using http specified in the configuration " - "file will be ignored." + "Accept in the <literal>packages</literal> and <literal>contents</literal> " + "commands only package files matching <literal>*_arch.deb</literal> or " + "<literal>*_all.deb</literal> instead of all package files in the given " + "path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: sources.list.5.xml:183 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:572 msgid "" - "The copy scheme is identical to the file scheme except that packages are " - "copied into the cache directory instead of used directly at their location. " - "This is useful for people using a zip disk to copy files around with APT." + "&apt-ftparchive; caches as much as possible of metadata in a cachedb. If " + "packages are recompiled and/or republished with the same version again, this " + "will lead to problems as the now outdated cached metadata like size and " + "checksums will be used. With this option enabled this will no longer happen " + "as it will be checked if the file was changed. Note that this option is set " + "to \"<literal>false</literal>\" by default as it is not recommend to upload " + "multiply versions/builds of a package with the same versionnumber, so in " + "theory nobody will have these problems and therefore all these extra checks " + "are useless." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: sources.list.5.xml:190 + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> + #: apt-ftparchive.1.xml:584 msgid "" - "The rsh/ssh method invokes rsh/ssh to connect to a remote host as a given " - "user and access the files. It is a good idea to do prior arrangements with " - "RSA keys or rhosts. Access to files on the remote uses standard " - "<command>find</command> and <command>dd</command> commands to perform the " - "file transfers from the remote." + "This configuration option defaults to \"<literal>true</literal>\" and should " + "only be set to <literal>\"false\"</literal> if the Archive generated with " + "&apt-ftparchive; also provides <filename>Translation</filename> files. Note " + "that the <filename>Translation-en</filename> master file can only be created " + "in the generate command." msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term> - #: sources.list.5.xml:198 - msgid "adding more recognizable URI types" + #. type: Content of: <refentry><refsect1><para><programlisting> + #: apt-ftparchive.1.xml:602 + #, no-wrap + msgid "" + "<command>apt-ftparchive</command> packages " + "<replaceable>directory</replaceable> | <command>gzip</command> > " + "<filename>Packages.gz</filename>\n" msgstr "" - #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para> - #: sources.list.5.xml:200 + #. type: Content of: <refentry><refsect1><para> + #: apt-ftparchive.1.xml:598 msgid "" - "APT can be extended with more methods shipped in other optional packages " - "which should follow the nameing scheme " - "<package>apt-transport-<replaceable>method</replaceable></package>. The APT " - "team e.g. maintains also the <package>apt-transport-https</package> package " - "which provides access methods for https-URIs with features similar to the " - "http method, but other methods for using e.g. debtorrent are also available, " - "see &apt-transport-debtorrent;." + "To create a compressed Packages file for a directory containing binary " + "packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:212 + #: apt-ftparchive.1.xml:612 msgid "" - "Uses the archive stored locally (or NFS mounted) at /home/jason/debian for " - "stable/main, stable/contrib, and stable/non-free." + "<command>apt-ftparchive</command> returns zero on normal operation, decimal " + "100 on error." msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:214 + #. type: TH + #: apt.8:17 #, no-wrap - msgid "deb file:/home/jason/debian stable main contrib non-free" + msgid "apt" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:216 - msgid "As above, except this uses the unstable (development) distribution." + #. type: TH + #: apt.8:17 + #, no-wrap + msgid "16 June 1998" msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:217 + #. type: TH + #: apt.8:17 #, no-wrap - msgid "deb file:/home/jason/debian unstable main contrib non-free" + msgid "Debian" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:219 - msgid "Source line for the above" + #. type: SH + #: apt.8:18 + #, no-wrap + msgid "NAME" msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:220 + #. type: Plain text + #: apt.8:20 + msgid "apt - Advanced Package Tool" + msgstr "" + + #. type: SH + #: apt.8:20 #, no-wrap - msgid "deb-src file:/home/jason/debian unstable main contrib non-free" + msgid "SYNOPSIS" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:222 - msgid "" - "The first line gets package information for the architectures in " - "<literal>APT::Architectures</literal> while the second always retrieves " - "<literal>amd64</literal> and <literal>armel</literal>." + #. type: Plain text + #: apt.8:22 + msgid "B<apt>" msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:224 + #. type: SH + #: apt.8:22 #, no-wrap - msgid "" - "deb http://ftp.debian.org/debian &stable-codename; main\n" - "deb [ arch=amd64,armel ] http://ftp.debian.org/debian &stable-codename; main" + msgid "DESCRIPTION" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:227 + #. type: Plain text + #: apt.8:31 msgid "" - "Uses HTTP to access the archive at archive.debian.org, and uses only the " - "hamm/main area." + "APT is a management system for software packages. For normal day to day " + "package management there are several frontends available, such as " + "B<aptitude>(8) for the command line or B<synaptic>(8) for the X Window " + "System. Some options are only implemented in B<apt-get>(8) though." msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:229 + #. type: SH + #: apt.8:31 #, no-wrap - msgid "deb http://archive.debian.org/debian-archive hamm main" + msgid "SEE ALSO" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:231 + #. type: Plain text + #: apt.8:38 msgid "" - "Uses FTP to access the archive at ftp.debian.org, under the debian " - "directory, and uses only the &stable-codename;/contrib area." + "B<apt-cache>(8), B<apt-get>(8), B<apt.conf>(5), B<sources.list>(5), " + "B<apt_preferences>(5), B<apt-secure>(8)" msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:233 + #. type: SH + #: apt.8:38 #, no-wrap - msgid "deb ftp://ftp.debian.org/debian &stable-codename; contrib" + msgid "DIAGNOSTICS" msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:235 - msgid "" - "Uses FTP to access the archive at ftp.debian.org, under the debian " - "directory, and uses only the unstable/contrib area. If this line appears as " - "well as the one in the previous example in <filename>sources.list</filename> " - "a single FTP session will be used for both resource lines." + #. type: Plain text + #: apt.8:40 + msgid "apt returns zero on normal operation, decimal 100 on error." msgstr "" - #. type: Content of: <refentry><refsect1><literallayout> - #: sources.list.5.xml:239 + #. type: SH + #: apt.8:40 #, no-wrap - msgid "deb ftp://ftp.debian.org/debian unstable contrib" + msgid "BUGS" msgstr "" - #. type: Content of: <refentry><refsect1><para><literallayout> - #: sources.list.5.xml:248 - #, no-wrap - msgid "deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/" + #. type: Plain text + #: apt.8:42 + msgid "This manpage isn't even started." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:241 + #. type: Plain text + #: apt.8:51 msgid "" - "Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe " - "directory, and uses only files found under " - "<filename>unstable/binary-i386</filename> on i386 machines, " - "<filename>unstable/binary-amd64</filename> on amd64, and so forth for other " - "supported architectures. [Note this example only illustrates how to use the " - "substitution variable; official debian archives are not structured like " - "this] <placeholder type=\"literallayout\" id=\"0\"/>" + "See E<lt>http://bugs.debian.org/aptE<gt>. If you wish to report a bug in " + "B<apt>, please see I</usr/share/doc/debian/bug-reporting.txt> or the " + "B<reportbug>(1) command." msgstr "" - #. type: Content of: <refentry><refsect1><para> - #: sources.list.5.xml:253 - msgid "&apt-cache; &apt-conf;" + #. type: SH + #: apt.8:51 + #, no-wrap + msgid "AUTHOR" + msgstr "" + + #. type: Plain text + #: apt.8:52 + msgid "apt was written by the APT team E<lt>apt@packages.debian.orgE<gt>." msgstr "" #. type: <title> @@@ -6086,12 -6100,12 +6100,12 @@@ msgid " "To enable the APT method you need to select [A]ccess in dselect " "and then choose the APT method. You will be prompted for a set of " "Sources which are places to fetch archives from. These can be " - "remote Internet sites, local Debian mirrors or CDROMs. Each source can " + "remote Internet sites, local Debian mirrors or CD-ROMs. Each source can " "provide a fragment of the total Debian archive, APT will automatically " - "combine them to form a complete set of packages. If you have a CDROM then it " - "is a good idea to specify it first and then specify a mirror so that you " + "combine them to form a complete set of packages. If you have a CD-ROM then " + "it is a good idea to specify it first and then specify a mirror so that you " "have access to the latest bug fixes. APT will automatically use packages on " - "your CDROM before downloading from the Internet." + "your CD-ROM before downloading from the Internet." msgstr "" #. type: