You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

8748 lines
340 KiB

# Translation of apt manpages and documentation to LANGUAGE
# This file is distributed under the same license as the apt-doc package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: apt-doc 1.7.0\n"
"Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
"POT-Creation-Date: 2018-10-07 07:56+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY apt-author.team \"\n"
" <author>\n"
" <othername>APT team</othername>\n"
" <contrib></contrib>\n"
" </author>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY apt-qapage \"\n"
"\t<para>\n"
"\t\t<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>\n"
"\t</para>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!-- Boiler plate Bug reporting section -->\n"
"<!ENTITY manbugs \"\n"
" <refsect1><title>Bugs</title>\n"
" <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.\n"
" If you wish to report a bug in APT, please see\n"
" <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the\n"
" &reportbug; command.\n"
" </para>\n"
" </refsect1>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!-- Boiler plate Author section -->\n"
"<!ENTITY manauthor \"\n"
" <refsect1><title>Author</title>\n"
" <para>APT was written by the APT team "
"<email>apt@packages.debian.org</email>.\n"
" </para>\n"
" </refsect1>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!-- Should be used within the option section of the text to\n"
" put in the blurb about -h, -v, -c and -o -->\n"
"<!ENTITY apt-commonoptions \"\n"
" <varlistentry><term><option>-h</option></term>\n"
" <term><option>--help</option></term>\n"
" <listitem><para>Show a short usage summary.\n"
" </para>\n"
" </listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" <varlistentry>\n"
" <term><option>-v</option></term>\n"
" <term><option>--version</option></term>\n"
" <listitem><para>Show the program version.\n"
" </para>\n"
" </listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" <varlistentry>\n"
" <term><option>-c</option></term>\n"
" <term><option>--config-file</option></term>\n"
" <listitem><para>Configuration File; Specify a configuration file to "
"use. \n"
" The program will read the default configuration file and then this \n"
" configuration file. If configuration settings need to be set before "
"the\n"
" default configuration files are parsed specify a file with the "
"<envar>APT_CONFIG</envar>\n"
" environment variable. See &apt-conf; for syntax information.\n"
" </para>\n"
" </listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" <varlistentry>\n"
" <term><option>-o</option></term>\n"
" <term><option>--option</option></term>\n"
" <listitem><para>Set a Configuration Option; This will set an "
"arbitrary\n"
" configuration option. The syntax is <option>-o "
"Foo::Bar=bar</option>.\n"
" <option>-o</option> and <option>--option</option> can be used "
"multiple\n"
" times to set different options.\n"
" </para>\n"
" </listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!-- Should be used within the option section of the text to\n"
" put in the blurb about -h, -v, -c and -o -->\n"
"<!ENTITY apt-cmdblurb \"\n"
" <para>All command line options may be set using the configuration file, "
"the\n"
" descriptions indicate the configuration option to set. For boolean\n"
" options you can override the config file by using something like \n"
" <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>\n"
" or several other variations.\n"
" </para>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY file-aptconf \"\n"
" <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>\n"
" <listitem><para>APT configuration file.\n"
" Configuration Item: "
"<literal>Dir::Etc::Main</literal>.</para></listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>\n"
" <listitem><para>APT configuration file fragments.\n"
" Configuration Item: "
"<literal>Dir::Etc::Parts</literal>.</para></listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY file-cachearchives \"\n"
" <varlistentry><term><filename>&cachedir;/archives/</filename></term>\n"
" <listitem><para>Storage area for retrieved package files.\n"
" Configuration Item: "
"<literal>Dir::Cache::Archives</literal>.</para></listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" "
"<varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>\n"
" <listitem><para>Storage area for package files in transit.\n"
" Configuration Item: <literal>Dir::Cache::Archives</literal> "
"(<filename>partial</filename> will be implicitly "
"appended)</para></listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY file-preferences \"\n"
" <varlistentry><term><filename>/etc/apt/preferences</filename></term>\n"
" <listitem><para>Version preferences file.\n"
" This is where you would specify &quot;pinning&quot;,\n"
" i.e. a preference to get certain packages\n"
" from a separate source\n"
" or from a different version of a distribution.\n"
" Configuration Item: "
"<literal>Dir::Etc::Preferences</literal>.</para></listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" "
"<varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>\n"
" <listitem><para>File fragments for the version preferences.\n"
" Configuration Item: "
"<literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY file-sourceslist \"\n"
" <varlistentry><term><filename>/etc/apt/sources.list</filename></term>\n"
" <listitem><para>Locations to fetch packages from.\n"
" Configuration Item: "
"<literal>Dir::Etc::SourceList</literal>.</para></listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" "
"<varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>\n"
" <listitem><para>File fragments for locations to fetch packages from.\n"
" Configuration Item: "
"<literal>Dir::Etc::SourceParts</literal>.</para></listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY file-statelists \"\n"
" <varlistentry><term><filename>&statedir;/lists/</filename></term>\n"
" <listitem><para>Storage area for state information for each package "
"resource specified in\n"
" &sources-list;\n"
" Configuration Item: "
"<literal>Dir::State::Lists</literal>.</para></listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" "
"<varlistentry><term><filename>&statedir;/lists/partial/</filename></term>\n"
" <listitem><para>Storage area for state information in transit.\n"
" Configuration Item: <literal>Dir::State::Lists</literal> "
"(<filename>partial</filename> will be implicitly "
"appended)</para></listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY file-trustedgpg \"\n"
" <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>\n"
" <listitem><para>Keyring of local trusted keys, new keys will be added "
"here.\n"
" Configuration Item: "
"<literal>Dir::Etc::Trusted</literal>.</para></listitem>\n"
" </varlistentry>\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
" "
"<varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term>\n"
" <listitem><para>File fragments for the trusted keys, additional "
"keyrings can\n"
" be stored here (by other packages or the administrator).\n"
" Configuration Item "
"<literal>Dir::Etc::TrustedParts</literal>.</para></listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!ENTITY file-extended_states \"\n"
" "
"<varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>\n"
" <listitem><para>Status list of auto-installed packages.\n"
" Configuration Item: <literal>Dir::State::extended_states</literal>.\n"
" </para></listitem>\n"
" </varlistentry>\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!-- TRANSLATOR: This is the section header for the following paragraphs - "
"comparable\n"
" to the other headers like NAME and DESCRIPTION and should therefore be "
"uppercase. -->\n"
"<!ENTITY translation-title \"TRANSLATION\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!-- TRANSLATOR: This is a placeholder. You should write here who has "
"contributed\n"
" to the translation in the past, who is responsible now and maybe "
"further information\n"
" specially related to your translation. -->\n"
"<!ENTITY translation-holder \"\n"
" The english translation was done by John Doe "
"<email>john@doe.org</email> in 2009,\n"
" 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together "
"with the\n"
" Debian Dummy l10n Team "
"<email>debian-l10n-dummy@lists.debian.org</email>.\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
#, no-wrap
msgid ""
"<!-- TRANSLATOR: As a translation is allowed to have 20% of "
"untranslated/fuzzy strings\n"
" in a shipped manpage newer/modified paragraphs will maybe appear in "
"english in\n"
" the generated manpage. This sentence is therefore here to tell the "
"reader that this\n"
" is not a mistake by the translator - obviously the target is that at "
"least for stable\n"
" releases this sentence is not needed. :) -->\n"
"<!ENTITY translation-english \"\n"
" Note that this translated document may contain untranslated parts.\n"
" This is done on purpose, to avoid losing content when the\n"
" translation is lagging behind the original content.\n"
"\">\n"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in -o=config_string "
"e.g. -o=Debug::pkgProblemResolver=1 --> <!ENTITY synopsis-config-string "
"\"config_string\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> <!ENTITY "
"synopsis-config-file \"config_file\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in -t=target_release or pkg/target_release "
"e.g. -t=squeeze apt/experimental --> <!ENTITY synopsis-target-release "
"\"target_release\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY "
"synopsis-architecture \"architecture\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome "
"--> <!ENTITY synopsis-pkg \"pkg\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> "
"<!ENTITY synopsis-pkg-ver-number \"pkg_version_number\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache "
"pkgnames apt --> <!ENTITY synopsis-prefix \"prefix\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search "
"awesome --> <!ENTITY synopsis-regex \"regex\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom "
"-d=/media/cdrom --> <!ENTITY synopsis-cdrom-mount \"cdrom_mount_point\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory "
"e.g. apt-extracttemplates -t=/tmp --> <!ENTITY synopsis-tmp-directory "
"\"temporary_directory\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY "
"synopsis-filename \"filename\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
"packages path override-file pathprefix --> <!ENTITY synopsis-path \"path\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
"packages path override-file pathprefix --> <!ENTITY synopsis-override "
"\"override-file\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
"packages path override-file pathprefix --> <!ENTITY synopsis-pathprefix "
"\"pathprefix\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
"generate section --> <!ENTITY synopsis-section \"section\">"
msgstr ""
#. type: Plain text
#: apt.ent
msgid ""
"<!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export "
"473041FA --> <!ENTITY synopsis-keyid \"keyid\">"
msgstr ""
#. type: Content of: <refentry><refmeta><manvolnum>
#: apt.8.xml apt-get.8.xml apt-cache.8.xml apt-key.8.xml apt-mark.8.xml
#: apt-secure.8.xml apt-cdrom.8.xml apt-config.8.xml
msgid "8"
msgstr ""
#. type: Content of: <refentry><refmeta><refmiscinfo>
#: apt.8.xml apt-get.8.xml apt-cache.8.xml apt-key.8.xml apt-mark.8.xml
#: apt-secure.8.xml apt-cdrom.8.xml apt-config.8.xml apt.conf.5.xml
#: apt_preferences.5.xml sources.list.5.xml apt-extracttemplates.1.xml
#: apt-sortpkgs.1.xml apt-ftparchive.1.xml apt_auth.conf.5.xml
#: apt-transport-http.1.xml apt-transport-https.1.xml
#: apt-transport-mirror.1.xml
msgid "APT"
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt.8.xml
msgid "command-line interface"
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml apt-get.8.xml apt-cache.8.xml apt-key.8.xml apt-mark.8.xml
#: apt-secure.8.xml apt-cdrom.8.xml apt-config.8.xml apt.conf.5.xml
#: apt_preferences.5.xml sources.list.5.xml apt-extracttemplates.1.xml
#: apt-sortpkgs.1.xml apt-ftparchive.1.xml apt_auth.conf.5.xml
#: apt-transport-http.1.xml apt-transport-https.1.xml
#: apt-transport-mirror.1.xml
msgid "Description"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml
msgid ""
"<command>apt</command> provides a high-level commandline interface for the "
"package management system. It is intended as an end user interface and "
"enables some options better suited for interactive usage by default compared "
"to more specialized APT tools like &apt-get; and &apt-cache;."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml
msgid ""
"Much like <command>apt</command> itself, its manpage is intended as an end "
"user interface and as such only mentions the most used commands and options "
"partly to not duplicate information in multiple places and partly to avoid "
"overwhelming readers with a cornucopia of options and details."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt.8.xml
msgid "(&apt-get;)"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"<option>update</option> is used to download package information from all "
"configured sources. Other commands operate on this data to e.g. perform "
"package upgrades or search in and display details about all packages "
"available for installation."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"<option>upgrade</option> is used to install available upgrades of all "
"packages currently installed on the system from the sources configured via "
"&sources-list;. New packages will be installed if required to satisfy "
"dependencies, but existing packages will never be removed. If an upgrade for "
"a package requires the remove of an installed package the upgrade for this "
"package isn't performed."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"<literal>full-upgrade</literal> performs the function of upgrade but will "
"remove currently installed packages if this is needed to upgrade the system "
"as a whole."
msgstr ""
#. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
#: apt.8.xml apt-key.8.xml sources.list.5.xml
msgid ","
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"Performs the requested action on one or more packages specified via &regex;, "
"&glob; or exact match. The requested action can be overridden for specific "
"packages by append a plus (+) to the package name to install this package or "
"a minus (-) to remove it."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
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. Alternatively the version from a specific release can be selected "
"by following the package name with a forward slash (/) and codename "
"(&debian-stable-codename;, &debian-testing-codename;, sid …) or suite name "
"(stable, testing, unstable). This will also select versions from this "
"release for dependencies of this package if needed to satisfy the request."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"Removing a package removes all packaged data, but leaves usually small "
"(modified) user configuration files behind, in case the remove was an "
"accident. Just issuing an installation request for the accidentally removed "
"package will restore its function as before in that case. On the other hand "
"you can get rid of these leftovers by calling <command>purge</command> even "
"on already removed packages. Note that this does not affect any data or "
"configuration stored in your home directory."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
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 as dependencies changed or the package(s) needing them "
"were removed in the meantime."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"You should check that the list does not include applications you have grown "
"to like even though they were once installed just as a dependency of another "
"package. You can mark such a package as manually installed by using "
"&apt-mark;. Packages which you have installed explicitly via "
"<command>install</command> are also never proposed for automatic removal."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt.8.xml
msgid "(&apt-cache;)"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"<option>search</option> can be used to search for the given &regex; term(s) "
"in the list of available packages and display matches. This can e.g. be "
"useful if you are looking for packages having a specific feature. If you "
"are looking for a package including a specific file try &apt-file;."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"Show information about the given package(s) including its dependencies, "
"installation and download size, sources the package is available from, the "
"description of the packages content and much more. It can e.g. be helpful to "
"look at this information before allowing &apt; to remove a package or while "
"searching for new packages to install."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt.8.xml
msgid "(work-in-progress)"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"<option>list</option> is somewhat similar to <command>dpkg-query "
"--list</command> in that it can display a list of packages satisfying "
"certain criteria. It supports &glob; patterns for matching package names as "
"well as options to list installed (<option>--installed</option>), "
"upgradeable (<option>--upgradeable</option>) or all available "
"(<option>--all-versions</option>) versions."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml
msgid ""
"<literal>edit-sources</literal> lets you edit your &sources-list; files in "
"your preferred texteditor while also providing basic sanity checks."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml
msgid "Script Usage and Differences from Other APT Tools"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml
msgid ""
"The &apt; commandline is designed as an end-user tool and it may change "
"behavior between versions. While it tries not to break backward "
"compatibility this is not guaranteed either if a change seems beneficial for "
"interactive use."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml
msgid ""
"All features of &apt; are available in dedicated APT tools like &apt-get; "
"and &apt-cache; as well. &apt; just changes the default value of some "
"options (see &apt-conf; and specifically the Binary scope). So you should "
"prefer using these commands (potentially with some additional options "
"enabled) in your scripts as they keep backward compatibility as much as "
"possible."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml apt-get.8.xml apt-cache.8.xml apt-key.8.xml apt-mark.8.xml
#: apt-secure.8.xml apt-cdrom.8.xml apt-config.8.xml apt.conf.5.xml
#: apt_preferences.5.xml sources.list.5.xml apt-extracttemplates.1.xml
#: apt-sortpkgs.1.xml apt-ftparchive.1.xml apt_auth.conf.5.xml
#: apt-transport-http.1.xml apt-transport-https.1.xml
msgid "See Also"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml
msgid ""
"&apt-get;, &apt-cache;, &sources-list;, &apt-conf;, &apt-config;, The APT "
"User's guide in &guidesdir;, &apt-preferences;, the APT Howto."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml apt-get.8.xml apt-cache.8.xml apt-mark.8.xml apt-cdrom.8.xml
#: apt-config.8.xml apt-extracttemplates.1.xml apt-sortpkgs.1.xml
#: apt-ftparchive.1.xml
msgid "Diagnostics"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml
msgid ""
"<command>apt</command> returns zero on normal operation, decimal 100 on "
"error."
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-get.8.xml
msgid "APT package handling utility -- command-line interface"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-get.8.xml
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 &aptitude;, "
"&synaptic; and &wajig;."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-get.8.xml apt-cache.8.xml apt-cdrom.8.xml apt-config.8.xml
#: apt-ftparchive.1.xml
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-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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. 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-get.8.xml
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)."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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, "
"<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>
#: apt-get.8.xml
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)."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"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>
#: apt-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"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>
#: apt-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"<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>
#: apt-get.8.xml
msgid ""
"<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-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"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-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"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-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"<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-get.8.xml
msgid ""
"<literal>download</literal> will download the given binary package into the "
"current directory."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt-get.8.xml
msgid "(and the"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt-get.8.xml
msgid "alias since 1.1)"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"<literal>changelog</literal> tries to download the changelog of a package "
"and displays it through <command>sensible-pager</command>. 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-get.8.xml
msgid ""
"Displays by default a deb822 formatted listing of information about all data "
"files (aka index targets) <command>apt-get update</command> would "
"download. Supports a <option>--format</option> option to modify the output "
"format as well as accepts lines of the default output to filter the records "
"by. The command is mainly used as an interface for external tools working "
"with APT to get information as well as filenames for downloaded files so "
"they can use them as well instead of downloading them again on their "
"own. Detailed documentation is omitted here and can instead be found in the "
"file &apt-acquire-additional-files; shipped by the "
"<package>apt-doc</package> package."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-get.8.xml apt-cache.8.xml apt-config.8.xml apt-extracttemplates.1.xml
#: apt-sortpkgs.1.xml apt-ftparchive.1.xml
msgid "options"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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-get.8.xml
msgid ""
"Consider suggested packages as a dependency for installing. Configuration "
"Item: <literal>APT::Install-Suggests</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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-get.8.xml
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 <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-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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-get.8.xml
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 decide to do something you did not expect. Configuration Item: "
"<literal>quiet</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"No action; perform a simulation of events that would occur based on the "
"current system state but do not actually change the system. Locking will be "
"disabled (<option>Debug::NoLocking</option>) so the system state could "
"change while <command>apt-get</command> is running. Simulations can also be "
"executed by non-root users which might not have read access to all apt "
"configuration distorting the simulation. A notice expressing this warning "
"is also shown by default for non-root users "
"(<option>APT::Get::Show-User-Simulation-Note</option>). Configuration Item: "
"<literal>APT::Get::Simulate</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"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-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Automatic \"no\" to all prompts. Configuration Item: "
"<literal>APT::Get::Assume-No</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Do not show 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-get.8.xml
msgid ""
"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-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"This option controls the activated build profiles for which a source package "
"is built by <command>apt-get source --compile</command> and how build "
"dependencies are satisfied. By default no build profile is active. More "
"than one build profile can be activated at a time by concatenating them with "
"a comma. Configuration Item: <literal>APT::Build-Profiles</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Compile source packages after downloading them. Configuration Item: "
"<literal>APT::Get::Compile</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Allow installing new packages when used in conjunction with "
"<literal>upgrade</literal>. This is useful if the update of a installed "
"package requires new dependencies to be installed. Instead of holding the "
"package back <literal>upgrade</literal> will upgrade the package and install "
"the new dependencies. Note that <literal>upgrade</literal> with this option "
"will never remove packages, only allow adding new ones. Configuration Item: "
"<literal>APT::Get::Upgrade-Allow-New</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"This is a dangerous option that will cause apt to continue without prompting "
"if it is doing downgrades. It should not be used except in very special "
"situations. Using it can potentially destroy your system! Configuration "
"Item: <literal>APT::Get::allow-downgrades</literal>. Introduced in APT 1.1."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Force yes; this is a dangerous option that will cause apt to continue "
"without prompting if it is removing essentials. It should not be used except "
"in very special situations. Using it can potentially destroy your system! "
"Configuration Item: "
"<literal>APT::Get::allow-remove-essential</literal>. Introduced in APT 1.1."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Force yes; this is a dangerous option that will cause apt to continue "
"without prompting if it is changing held packages. It should not be used "
"except in very special situations. Using it can potentially destroy your "
"system! Configuration Item: "
"<literal>APT::Get::allow-change-held-packages</literal>. Introduced in APT "
"1.1."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>. This is "
"deprecated and replaced by <option>--allow-unauthenticated</option> , "
"<option>--allow-downgrades</option> , "
"<option>--allow-remove-essential</option> , "
"<option>--allow-change-held-packages</option> in 1.1."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"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-get.8.xml
msgid ""
"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-get.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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-get.8.xml
msgid ""
"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-get.8.xml
msgid ""
"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-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"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-get.8.xml
msgid ""
"Only process architecture-independent build-dependencies. Configuration "
"Item: <literal>APT::Get::Indep-Only</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Ignore if packages can't be authenticated and don't prompt about it. This "
"can be useful while working with local repositories, but is a huge security "
"risk if data authenticity isn't ensured in another way by the user itself. "
"The usage of the <option>Trusted</option> option for &sources-list; entries "
"should usually be preferred over this global override. Configuration Item: "
"<literal>APT::Get::AllowUnauthenticated</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Forbid the update command to acquire unverifiable data from configured "
"sources. APT will fail at the update command for repositories without valid "
"cryptographically signatures. See also &apt-secure; for details on the "
"concept and the implications. Configuration Item: "
"<literal>Acquire::AllowInsecureRepositories</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Allow the update command to continue downloading data from a repository "
"which changed its information of the release contained in the repository "
"indicating e.g a new major release. APT will fail at the update command for "
"such repositories until the change is confirmed to ensure the user is "
"prepared for the change. See also &apt-secure; for details on the concept "
"and configuration."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Specialist options "
"(<literal>--allow-releaseinfo-change-</literal><replaceable>field</replaceable>) "
"exist to allow changes only for certain fields like "
"<literal>origin</literal>, <literal>label</literal>, "
"<literal>codename</literal>, <literal>suite</literal>, "
"<literal>version</literal> and <literal>defaultpin</literal>. See also "
"&apt-preferences;. Configuration Item: "
"<literal>Acquire::AllowReleaseInfoChange</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Show user friendly progress information in the terminal window when packages "
"are installed, upgraded or removed. For a machine parsable version of this "
"data see README.progress-reporting in the apt doc directory. Configuration "
"Items: <literal>Dpkg::Progress</literal> and "
"<literal>Dpkg::Progress-Fancy</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml
msgid ""
"Adds the given file as a source for metadata. Can be repeated to add "
"multiple files. See <option>--with-source</option> description in "
"&apt-cache; for further details."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-get.8.xml apt-cache.8.xml apt-key.8.xml apt-mark.8.xml apt.conf.5.xml
#: apt_preferences.5.xml apt_auth.conf.5.xml
msgid "Files"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-get.8.xml
msgid ""
"&apt-cache;, &apt-cdrom;, &dpkg;, &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><para>
#: apt-get.8.xml
msgid ""
"<command>apt-get</command> returns zero on normal operation, decimal 100 on "
"error."
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-cache.8.xml
msgid "query the APT cache"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cache.8.xml
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. The metadata is acquired and updated via "
"the 'update' command of e.g. <command>apt-get</command>, so that it can be "
"outdated if the last update is too long ago, but in exchange "
"<command>apt-cache</command> works independently of the availability of the "
"configured sources (e.g. offline)."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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
msgid "&synopsis-pkg;"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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:"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
#: apt-cache.8.xml
#, no-wrap
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"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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-cache.8.xml
msgid ""
"<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><itemizedlist><listitem><para>
#: apt-cache.8.xml
msgid ""
"<literal>Total package names</literal> is the number of package names found "
"in the cache."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
#: apt-cache.8.xml
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><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
#: apt-cache.8.xml
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\"."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
#: apt-cache.8.xml
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><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
#: apt-cache.8.xml
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
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
#: apt-cache.8.xml
msgid ""
"<literal>Total distinct</literal> versions is the number of package versions "
"found in the cache. 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><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
#: apt-cache.8.xml
msgid ""
"<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-cache.8.xml
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. Use "
"<option>--only-source</option> to display only source package names."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"<literal>dump</literal> shows a short listing of every package in the "
"cache. It is primarily for debugging."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"<literal>unmet</literal> displays a summary of all unmet dependencies in the "
"package cache."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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
msgid "&synopsis-regex;"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"<literal>search</literal> performs a full text search on all available "
"package lists for the POSIX regex pattern given, see &regex;. 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 and provided packages "
"are."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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-cache.8.xml
msgid ""
"<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-cache.8.xml
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
msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid "Caution, dotty cannot graph larger sets of packages."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt-cache.8.xml
msgid "<optional><replaceable>&synopsis-pkg;</replaceable>…</optional>"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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>)."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"Per default the <command>depends</command> and <command>rdepends</command> "
"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><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"Per default <command>depends</command> and <command>rdepends</command> print "
"only dependencies explicitly expressed in the metadata. With this flag it "
"will also show dependencies implicitly added based on the encountered data. "
"A <literal>Conflicts: foo</literal> e.g. expresses implicitly that this "
"package also conflicts with the package foo from any other architecture. "
"Configuration Item: <literal>APT::Cache::ShowImplicit</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"Print full package records when searching. Configuration Item: "
"<literal>APT::Cache::ShowFull</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"Only search on the package and provided package names, not the long "
"descriptions. Configuration Item: <literal>APT::Cache::NamesOnly</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"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><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
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><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"Adds the given file as a source for metadata. Can be repeated to add "
"multiple files. Supported are currently <literal>*.deb</literal>, "
"<literal>*.dsc</literal>, <literal>*.changes</literal>, "
"<literal>Sources</literal> and <literal>Packages</literal> files as well as "
"source package directories. Files are matched based on their name only, not "
"their content!"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"<literal>Sources</literal> and <literal>Packages</literal> can be compressed "
"in any format apt supports as long as they have the correct extension. If "
"you need to store multiple of these files in one directory you can prefix a "
"name of your choice with the last character being an underscore "
"(\"<literal>_</literal>\"). Example: my.example_Packages.xz"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml
msgid ""
"Note that these sources are treated as trusted (see &apt-secure;). "
"Configuration Item: <literal>APT::Sources::With</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cache.8.xml
msgid "&apt-conf;, &sources-list;, &apt-get;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cache.8.xml
msgid ""
"<command>apt-cache</command> returns zero on normal operation, decimal 100 "
"on error."
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-key.8.xml
msgid "APT key management utility"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml
msgid ""
"Note that if usage of <command>apt-key</command> is desired the additional "
"installation of the GNU Privacy Guard suite (packaged in "
"<package>gnupg</package>) is required. For this reason alone the "
"programmatic usage (especially in package maintainerscripts!) is strongly "
"discouraged. Further more the output format of all commands is undefined "
"and can and does change whenever the underlying commands "
"change. <command>apt-key</command> will try to detect such usage and "
"generates warnings on stderr in these cases."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-key.8.xml
msgid "Supported keyring files"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml
msgid ""
"apt-key supports only the binary OpenPGP format (also known as \"GPG key "
"public ring\") in files with the \"<literal>gpg</literal>\" extension, not "
"the keybox database format introduced in newer &gpg; versions as default for "
"keyring files. Binary keyring files intended to be used with any apt version "
"should therefore always be created with <command>gpg --export</command>."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml
msgid ""
"Alternatively, if all systems which should be using the created keyring have "
"at least apt version >= 1.4 installed, you can use the ASCII armored format "
"with the \"<literal>asc</literal>\" extension instead which can be created "
"with <command>gpg --armor --export</command>."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-key.8.xml
msgid "Commands"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid ""
"It is critical that keys added manually via <command>apt-key</command> are "
"verified to belong to the owner of the repositories they claim to be for "
"otherwise the &apt-secure; infrastructure is completely undermined."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid ""
"<emphasis>Note</emphasis>: Instead of using this command a keyring should be "
"placed directly in the <filename>/etc/apt/trusted.gpg.d/</filename> "
"directory with a descriptive name and either \"<literal>gpg</literal>\" or "
"\"<literal>asc</literal>\" as file extension."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid "Remove a key from the list of trusted keys."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid "Output the key &synopsis-param-keyid; to standard output."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid "Output all trusted keys to standard output."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid "List trusted keys with fingerprints."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid ""
"Pass advanced options to gpg. With <command>adv --recv-key</command> you can "
"e.g. download key from keyservers directly into the trusted set of "
"keys. Note that there are <emphasis>no</emphasis> checks performed, so it is "
"easy to completely undermine the &apt-secure; infrastructure if used without "
"care."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt-key.8.xml
msgid "(deprecated)"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
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 &keyring-package; package in &keyring-distro;."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid ""
"Note that a distribution does not need to and in fact should not use this "
"command any longer and instead ship keyring files in the "
"<filename>/etc/apt/trusted.gpg.d/</filename> directory directly as this "
"avoids a dependency on <package>gnupg</package> and it is easier to manage "
"keys by simply adding and removing files for maintainers and users alike."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid ""
"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><title>
#: apt-key.8.xml apt-mark.8.xml apt-cdrom.8.xml apt-transport-http.1.xml
#: apt-transport-https.1.xml apt-transport-mirror.1.xml
msgid "Options"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml
msgid ""
"Note that options need to be defined before the commands described in the "
"previous section."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml
msgid ""
"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><para>
#: apt-key.8.xml
msgid "&apt-get;, &apt-secure;"
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-mark.8.xml
msgid "show, set and unset various settings for a package"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-mark.8.xml
msgid ""
"<command>apt-mark</command> can be used as a unified front-end to set "
"various settings for a package, such as marking a package as being "
"automatically/manually installed or changing <command>dpkg</command> "
"selections such as hold, install, deinstall and purge which are respected "
"e.g. by <command>apt-get dselect-upgrade</command> or "
"<command>aptitude</command>."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-mark.8.xml
msgid "Automatically and Manually Installed Packages"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-mark.8.xml
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, while the package you installed explicitly is "
"marked as manually installed. Once an automatically installed package is no "
"longer depended on by any manually installed package it is considered no "
"longer needed and e.g. <command>apt-get</command> or "
"<command>aptitude</command> will at least suggest removing them."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml
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><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml
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-mark.8.xml
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><title>
#: apt-mark.8.xml
msgid "Prevent Changes for a Package"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml
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><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml
msgid ""
"<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><title>
#: apt-mark.8.xml
msgid "Schedule Packages for Install, Remove and Purge"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-mark.8.xml
msgid ""
"Some front-ends like <command>apt-get dselect-upgrade</command> can be used "
"to apply previously scheduled changes to the install state of packages. Such "
"changes can be scheduled with the <option>install</option>, "
"<option>remove</option> (also known as <option>deinstall</option>) and "
"<option>purge</option> commands. Packages with a specific selection can be "
"displayed with <option>showinstall</option>, <option>showremove</option> and "
"<option>showpurge</option> respectively. More information about these so "
"called dpkg selections can be found in &dpkg;."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-mark.8.xml
msgid ""
"<command>apt-mark</command> returns zero on normal operation, non-zero on "
"error."
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-secure.8.xml
msgid "Archive authentication support for APT"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"Starting with version 0.6, <command>APT</command> contains code that does "
"signature checking of the Release file for all repositories. This ensures "
"that data like packages in the archive can't be modified by people who have "
"no access to the Release file signing key. Starting with version 1.1 "
"<command>APT</command> requires repositories to provide recent "
"authentication information for unimpeded usage of the repository. Since "
"version 1.5 changes in the information contained in the Release file about "
"the repository need to be confirmed before APT continues to apply updates "
"from this repository."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"Note: All APT-based package management front-ends like &apt-get;, &aptitude; "
"and &synaptic; support this authentication feature, so this manpage uses "
"<literal>APT</literal> to refer to them all for simplicity only."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-secure.8.xml
msgid "Unsigned Repositories"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"If an archive has an unsigned Release file or no Release file at all current "
"APT versions will refuse to download data from them by default in "
"<command>update</command> operations and even if forced to download "
"front-ends like &apt-get; will require explicit confirmation if an "
"installation request includes a package from such an unauthenticated "
"archive."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"You can force all APT clients to raise only warnings by setting the "
"configuration option <option>Acquire::AllowInsecureRepositories</option> to "
"<literal>true</literal>. Individual repositories can also be allowed to be "
"insecure via the &sources-list; option "
"<literal>allow-insecure=yes</literal>. Note that insecure repositories are "
"strongly discouraged and all options to force apt to continue supporting "
"them will eventually be removed. Users also have the "
"<option>Trusted</option> option available to disable even the warnings, but "
"be sure to understand the implications as detailed in &sources-list;."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"A repository which previously was authenticated but would loose this state "
"in an <command>update</command> operation raises an error in all APT clients "
"irrespective of the option to allow or forbid usage of insecure "
"repositories. The error can be overcome by additionally setting "
"<option>Acquire::AllowDowngradeToInsecureRepositories</option> to "
"<literal>true</literal> or for Individual repositories with the "
"&sources-list; option <literal>allow-downgrade-to-insecure=yes</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-secure.8.xml
msgid "Signed Repositories"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"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-secure.8.xml
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)."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"The chain of trust in Debian starts (e.g.) 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 one "
"of the Debian package maintainer keyrings (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. Similar "
"procedures exist in all Debian-based distributions."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"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 &keyring-distro; release, and "
"distributed alongside the packages and the Packages files on "
"&keyring-distro; mirrors. The keys are in the &keyring-distro; archive "
"keyring available in the &keyring-package; package."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
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-secure.8.xml
msgid ""
"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><itemizedlist><listitem><para>
#: apt-secure.8.xml
msgid ""
"<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><itemizedlist><listitem><para>
#: apt-secure.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"However, it does not defend against a compromise of the 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><title>
#: apt-secure.8.xml
msgid "Information changes"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"A Release file contains beside the checksums for the files in the repository "
"also general information about the repository like the origin, codename or "
"version number of the release."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"This information is shown in various places so a repository owner should "
"always ensure correctness. Further more user configuration like "
"&apt-preferences; can depend and make use of this information. Since version "
"1.5 the user must therefore explicitly confirm changes to signal that the "
"user is sufficiently prepared e.g. for the new major release of the "
"distribution shipped in the repository (as e.g. indicated by the codename)."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-secure.8.xml
msgid "User Configuration"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"<command>apt-key</command> is the program that manages the list of keys used "
"by APT to trust repositories. It can be used to add or remove keys as well "
"as list the trusted keys. Limiting which key(s) are able to sign which "
"archive is possible via the <option>Signed-By</option> in &sources-list;."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"Note that a default installation already contains all keys to securely "
"acquire packages from the default repositories, so fiddling with "
"<command>apt-key</command> is only needed if third-party repositories are "
"added."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
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
msgid "Repository Configuration"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"If you want to provide archive signatures in an archive under your "
"maintenance you have to:"
msgstr ""
#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
#: apt-secure.8.xml
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)."
msgstr ""
#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
#: apt-secure.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
#: apt-secure.8.xml
msgid ""
"<emphasis>Publish the key fingerprint</emphasis>, so that your users will "
"know what key they need to import in order to authenticate the files in the "
"archive. It is best to ship your key in its own keyring package like "
"&keyring-distro; does with &keyring-package; to be able to distribute "
"updates and key transitions automatically later."
msgstr ""
#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
#: apt-secure.8.xml
msgid ""
"<emphasis>Provide instructions on how to add your archive and "
"key</emphasis>. If your users can't acquire your key securely the chain of "
"trust described above is broken. How you can help users add your key "
"depends on your archive and target audience ranging from having your keyring "
"package included in another archive users already have configured (like the "
"default repositories of their distribution) to leveraging the web of trust."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
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>
#: apt-secure.8.xml
msgid ""
"&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, "
"&debsign;, &debsig-verify;, &gpg;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
msgid ""
"For more background information you might want to review the <ulink "
"url=\"https://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian "
"Security Infrastructure</ulink> chapter of the Securing Debian Manual (also "
"available 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
msgid "Manpage Authors"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-cdrom.8.xml
msgid "APT CD-ROM management utility"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cdrom.8.xml
msgid ""
"<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><para>
#: apt-cdrom.8.xml
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 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-cdrom.8.xml
msgid ""
"<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-cdrom.8.xml
msgid ""
"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-cdrom.8.xml
msgid ""
"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-cdrom.8.xml
msgid ""
"Do not try to auto-detect the CD-ROM path. Usually combined with the "
"<option>--cdrom</option> option. Configuration Item: "
"<literal>Acquire::cdrom::AutoDetect</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cdrom.8.xml
msgid ""
"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-cdrom.8.xml
msgid ""
"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-cdrom.8.xml
msgid ""
"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-cdrom.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cdrom.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cdrom.8.xml
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>."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cdrom.8.xml
msgid "&apt-conf;, &apt-get;, &sources-list;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cdrom.8.xml
msgid ""
"<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
"on error."
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-config.8.xml
msgid "APT Configuration Query program"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-config.8.xml
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 for scripted applications."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-config.8.xml
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 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><informalexample><programlisting>
#: apt-config.8.xml
#, no-wrap
msgid ""
"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-config.8.xml
msgid ""
"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-config.8.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-config.8.xml
msgid "Just show the contents of the configuration space."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-config.8.xml
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
msgid "&percnt;f &#x0022;&percnt;v&#x0022;;&percnt;n"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-config.8.xml
msgid ""
"Defines the output of each config option. &percnt;t will be replaced with "
"its individual name, &percnt;f with its full hierarchical name and &percnt;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 &percnt;n will be replaced by a newline, "
"and &percnt;N by a tab. A &percnt; can be printed by using &percnt;&percnt;."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-config.8.xml apt-extracttemplates.1.xml apt-sortpkgs.1.xml
#: apt-ftparchive.1.xml
msgid "&apt-conf;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-config.8.xml
msgid ""
"<command>apt-config</command> returns zero on normal operation, decimal 100 "
"on error."
msgstr ""
#. type: Content of: <refentry><refentryinfo><author><contrib>
#: apt.conf.5.xml
msgid "Initial documentation of Debug::*."
msgstr ""
#. type: Content of: <refentry><refentryinfo><author><email>
#: apt.conf.5.xml
msgid "dburrows@debian.org"
msgstr ""
#. type: Content of: <refentry><refmeta><manvolnum>
#: apt.conf.5.xml apt_preferences.5.xml sources.list.5.xml apt_auth.conf.5.xml
msgid "5"
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt.conf.5.xml
msgid "Configuration file for APT"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
msgid ""
"<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><orderedlist><para>
#: apt.conf.5.xml
msgid ""
"When an APT tool starts up it will read the configuration files in the "
"following order:"
msgstr ""
#. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
#: apt.conf.5.xml
msgid ""
"the file specified by the <envar>APT_CONFIG</envar> environment variable (if "
"any)"
msgstr ""
#. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
#: apt.conf.5.xml
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, 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><orderedlist><listitem><para>
#: apt.conf.5.xml
msgid "the main configuration file specified by <literal>Dir::Etc::main</literal>"
msgstr ""
#. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
#: apt.conf.5.xml
msgid ""
"all options set in the binary specific configuration subtree are moved into "
"the root of the tree."
msgstr ""
#. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
#: apt.conf.5.xml
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
msgid "Syntax"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
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 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><informalexample><programlisting>
#: apt.conf.5.xml
#, no-wrap
msgid ""
"APT {\n"
" Get {\n"
" Assume-Yes \"true\";\n"
" Fix-Broken \"true\";\n"
" };\n"
"};\n"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
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, separated by a semicolon."
msgstr ""
#. type: Content of: <refentry><refsect1><informalexample><programlisting>
#: apt.conf.5.xml
#, no-wrap
msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
msgid ""
"In general the sample configuration file &configureindex; is a good guide "
"for how it should look."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
msgid ""
"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><para>
#: apt.conf.5.xml
msgid ""
"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><para>
#: apt.conf.5.xml
msgid ""
"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><para>
#: apt.conf.5.xml
msgid ""
"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><para>
#: apt.conf.5.xml
msgid ""
"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><para>
#: apt.conf.5.xml
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
msgid "The APT Group"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
msgid ""
"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.conf.5.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"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.conf.5.xml
msgid ""
"This scope defines which compression formats are supported, how compression "
"and decompression can be performed if support for this format isn't built "
"into apt directly and a cost-value indicating how costly it is to compress "
"something in this format. As an example the following configuration stanza "
"would allow apt to download and uncompress as well as create and store files "
"with the low-cost <literal>.reversed</literal> file extension which it will "
"pass to the command <command>rev</command> without additional commandline "
"parameters for compression and uncompression:"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
#: apt.conf.5.xml
#, no-wrap
msgid ""
"APT::Compressor::rev {\n"
"\tName \"rev\";\n"
"\tExtension \".reversed\";\n"
"\tBinary \"rev\";\n"
"\tCompressArg {};\n"
"\tUncompressArg {};\n"
"\tCost \"10\";\n"
"};\n"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"List of all build profiles enabled for build-dependency resolution, without "
"the \"<literal>profile.</literal>\" namespace prefix. By default this list "
"is empty. The <envar>DEB_BUILD_PROFILES</envar> as used by "
"&dpkg-buildpackage; overrides the list notation."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"Default release to install packages from if more than one version is "
"available. Contains release name, codename or release version. Examples: "
"'stable', 'testing', 'unstable', '&debian-stable-codename;', "
"'&debian-testing-codename;', '4.0', '5.0*'. See also &apt-preferences;."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"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.conf.5.xml
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"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.conf.5.xml
msgid ""
"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.conf.5.xml
msgid ""
"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.conf.5.xml
msgid ""
"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.conf.5.xml
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 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.conf.5.xml
msgid "Defines which packages are considered essential build dependencies."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"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.conf.5.xml
msgid ""
"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.conf.5.xml
msgid ""
"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><title>
#: apt.conf.5.xml
msgid "The Acquire Group"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml
msgid ""
"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><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"Security related option defaulting to true, enabling time-related "
"checks. Disabling it means that the machine's time cannot be trusted, and "
"APT will hence disable all time-related checks, such as "
"<option>Check-Valid-Until</option> and verifying that the Date field of a "
"release file is not in the future."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"Maximum time (in seconds) before its creation (as indicated by the "
"<literal>Date</literal> header) that the <filename>Release</filename> file "
"should be considered valid. The default value is <literal>10</literal>. "
"Archive specific settings can be made by appending the label of the archive "
"to the option name. Preferably, the same can be achieved for specific "
"&sources-list; entries by using the <option>Date-Max-Future</option> option "
"there."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
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. The <option>Check-Valid-Until</option> option of &sources-list; "
"entries should be preferred to disable the check selectively instead of "
"using this global override."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"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. Preferably, the same can be "
"achieved for specific &sources-list; entries by using the "
"<option>Valid-Until-Max</option> option there."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
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. Preferably, the "
"same can be achieved for specific &sources-list; entries by using the "
"<option>Valid-Until-Min</option> option there."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"Allow use of the internal TLS support in the http method. If set to false, "
"this completely disables support for TLS in apt's own methods (excluding the "
"curl-based https method). No TLS-related functions will be called anymore."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
msgid ""
"Try to download deltas called <literal>PDiffs</literal> for indexes (like "
"<filename>Packages</filename> files) instead of downloading whole ones. True "
"by default. Preferably, this can be set for specific &sources-list; entries "
"or index files by using the <option>PDiffs</option> option there."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml
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><varlistent