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.
 
 
 
 
 

7087 lines
271 KiB

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# 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.0.4~20140610\n"
"Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
"POT-Creation-Date: 2014-06-10 15:59+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:7
#, 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:13
#, 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:24
#, 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:32
#, 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:42
#, 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:50
#, 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:62
#, 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:74
#, 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:85
#, 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:91
#, 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:97
#, 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:103
#, 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:109
#, 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:119
#, 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:125
#, 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:131
#, 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:137
#, 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:144
#, 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:150
#, 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:156
#, 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:163
#, 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:171
#, 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:175
#, 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:184
#, 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:195
#, 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:198
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:201
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:204
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:207
msgid ""
"<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY "
"synopsis-architecture \"architecture\">"
msgstr ""
#. type: Plain text
#: apt.ent:210
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:213
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:216
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:219
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:222
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:225
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:228
msgid ""
"<!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY "
"synopsis-filename \"filename\">"
msgstr ""
#. type: Plain text
#: apt.ent:231
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:234
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:237
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:240
msgid ""
"<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
"generate section --> <!ENTITY synopsis-section \"section\">"
msgstr ""
#. type: Plain text
#: apt.ent:243
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:25 apt-get.8.xml:28 apt-cache.8.xml:28 apt-key.8.xml:27 apt-mark.8.xml:28 apt-secure.8.xml:27 apt-cdrom.8.xml:27 apt-config.8.xml:28
msgid "8"
msgstr ""
#. type: Content of: <refentry><refmeta><refmiscinfo>
#: apt.8.xml:26 apt-get.8.xml:29 apt-cache.8.xml:29 apt-key.8.xml:28 apt-mark.8.xml:29 apt-secure.8.xml:28 apt-cdrom.8.xml:28 apt-config.8.xml:29 apt.conf.5.xml:34 apt_preferences.5.xml:28 sources.list.5.xml:29 apt-extracttemplates.1.xml:29 apt-sortpkgs.1.xml:29 apt-ftparchive.1.xml:29
msgid "APT"
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt.8.xml:32
msgid "command-line interface"
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml:37 apt-get.8.xml:40 apt-cache.8.xml:40 apt-key.8.xml:39 apt-mark.8.xml:40 apt-secure.8.xml:52 apt-cdrom.8.xml:39 apt-config.8.xml:40 apt.conf.5.xml:43 apt_preferences.5.xml:38 sources.list.5.xml:38 apt-extracttemplates.1.xml:40 apt-sortpkgs.1.xml:40 apt-ftparchive.1.xml:40
msgid "Description"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml:38
msgid ""
"<command>apt</command> (Advanced Package Tool) is the command-line tool for "
"handling packages. It provides a commandline interface for the package "
"management of the system. See also &apt-get; and &apt-cache; for more "
"low-level command options."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:47
msgid ""
"<literal>list</literal> is used to display a list of packages. It supports "
"shell pattern for matching package names and the following options: "
"<option>--installed</option>, <option>--upgradable</option>, "
"<option>--all-versions</option> are supported."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:58
msgid ""
"<literal>search</literal> searches for the given term(s) and display "
"matching packages."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:64
msgid ""
"<literal>show</literal> shows the package information for the given "
"package(s)."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:71
msgid ""
"<literal>install</literal> is followed by one or more package names desired "
"for installation or upgrading."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:75 apt-get.8.xml:118
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.8.xml:85 apt-get.8.xml:153
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.8.xml:93
msgid ""
"<literal>edit-sources</literal> lets you edit your sources.list file and "
"provides basic sanity checks."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:99
msgid ""
"<literal>update</literal> is used to resynchronize the package index files "
"from their sources."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:105
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>. New package will be installed, "
"but existing package will never removed."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.8.xml:114
msgid ""
"<literal>full-upgrade</literal> performs the function of upgrade but may "
"also remove installed packages if that is required in order to resolve a "
"package conflict."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml:124 apt-get.8.xml:257 apt-cache.8.xml:250 apt-mark.8.xml:110 apt-config.8.xml:86 apt-extracttemplates.1.xml:54 apt-sortpkgs.1.xml:50 apt-ftparchive.1.xml:506
msgid "options"
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml:134
msgid "Script usage"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml:136
msgid ""
"The &apt; commandline is designed as a end-user tool and it may change the "
"output between versions. While it tries to not break backward compatibility "
"there is no guarantee for it either. All features of &apt; are available in "
"&apt-cache; and &apt-get; via APT options. Please prefer using these "
"commands in your scripts."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml:144
msgid "Differences to &apt-get;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml:145
msgid ""
"The <command>apt</command> command is meant to be pleasant for end users and "
"does not need to be backward compatible like &apt-get;. Therefore some "
"options are different:"
msgstr ""
#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
#: apt.8.xml:151
msgid "The option <literal>DPkg::Progress-Fancy</literal> is enabled."
msgstr ""
#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
#: apt.8.xml:155
msgid "The option <literal>APT::Color</literal> is enabled."
msgstr ""
#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
#: apt.8.xml:159
msgid ""
"A new <literal>list</literal> command is available similar to <literal>dpkg "
"--list</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
#: apt.8.xml:164
msgid ""
"The option <literal>upgrade</literal> has <literal>--with-new-pkgs</literal> "
"enabled by default."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.8.xml:174 apt-get.8.xml:558 apt-cache.8.xml:352 apt-key.8.xml:197 apt-mark.8.xml:133 apt-secure.8.xml:193 apt-cdrom.8.xml:154 apt-config.8.xml:111 apt.conf.5.xml:1227 apt_preferences.5.xml:707 sources.list.5.xml:280 apt-extracttemplates.1.xml:72 apt-sortpkgs.1.xml:65 apt-ftparchive.1.xml:609
msgid "See Also"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml:175
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:180 apt-get.8.xml:564 apt-cache.8.xml:357 apt-mark.8.xml:137 apt-cdrom.8.xml:159 apt-config.8.xml:116 apt-extracttemplates.1.xml:76 apt-sortpkgs.1.xml:69 apt-ftparchive.1.xml:613
msgid "Diagnostics"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.8.xml:181
msgid ""
"<command>apt</command> returns zero on normal operation, decimal 100 on "
"error."
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-get.8.xml:35
msgid "APT package handling utility -- command-line interface"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-get.8.xml:41
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:46 apt-cache.8.xml:46 apt-cdrom.8.xml:53 apt-config.8.xml:46 apt-ftparchive.1.xml:56
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:51
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:63
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:76
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:89
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:100
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:125
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:128
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:139
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:143
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:161
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:166
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:174
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:180
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:187
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:193
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:199
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:206
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:211
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:217
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><listitem><para>
#: apt-get.8.xml:224
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:234
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:239
msgid ""
"<literal>changelog</literal> downloads a package changelog and displays it "
"through <command>sensible-pager</command>. The server name and base "
"directory is defined in the <literal>APT::Changelogs::Server</literal> "
"variable (e.g. <ulink "
"url=\"http://packages.debian.org/changelogs\">packages.debian.org/changelogs</ulink> "
"for Debian or <ulink "
"url=\"http://changelogs.ubuntu.com/changelogs\">changelogs.ubuntu.com/changelogs</ulink> "
"for Ubuntu). By default it displays the changelog for the version that is "
"installed. However, you can specify the same options as for the "
"<option>install</option> command."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml:262
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:267
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:272
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:277
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:292
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:303
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:310
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:325
msgid ""
"No action; perform a simulation of events that would occur but do not "
"actually change the system. Configuration Item: "
"<literal>APT::Get::Simulate</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml:329
msgid ""
"Simulated runs performed as a user will automatically deactivate locking "
"(<literal>Debug::NoLocking</literal>), and if the option "
"<literal>APT::Get::Show-User-Simulation-Note</literal> is set (as it is by "
"default) a notice will also be displayed indicating that this is only a "
"simulation. Runs performed as root do not trigger either NoLocking or the "
"notice - superusers should know what they are doing without further warnings "
"from <literal>apt-get</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml:337
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:345
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:353
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:358
msgid ""
"Show upgraded packages; print out a list of all packages that are to be "
"upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml:364
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:370
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:380
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:391
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:396
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:403
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:415
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:422
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:430
msgid ""
"Force yes; this is a dangerous option that will cause apt to continue "
"without prompting if it is doing something potentially harmful. It should "
"not be used except in very special situations. Using "
"<literal>force-yes</literal> can potentially destroy your system! "
"Configuration Item: <literal>APT::Get::force-yes</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml:438
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:449
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:457
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:462
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:472
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:487
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:494
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:500
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:507
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:518
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:524
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:529
msgid ""
"Ignore if packages can't be authenticated and don't prompt about it. This "
"is useful for tools like pbuilder. Configuration Item: "
"<literal>APT::Get::AllowUnauthenticated</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-get.8.xml:535
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 "
"Item: <literal>Dpkg::Progress</literal> and "
"<literal>Dpkg::Progress-Fancy</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-get.8.xml:548 apt-cache.8.xml:345 apt-key.8.xml:176 apt-mark.8.xml:127 apt.conf.5.xml:1221 apt_preferences.5.xml:700
msgid "Files"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-get.8.xml:559
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:565
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:35
msgid "query the APT cache"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cache.8.xml:41
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:51
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:55 apt-cache.8.xml:144 apt-cache.8.xml:165 apt-cache.8.xml:187 apt-cache.8.xml:192 apt-cache.8.xml:208 apt-cache.8.xml:226 apt-cache.8.xml:238
msgid "&synopsis-pkg;"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:56
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:68
#, 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:80
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:89
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:92
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:96
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:102
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:110
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:116
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:123
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:130
msgid ""
"<literal>Total distinct</literal> versions is the number of package versions "
"found in the cache; this value is therefore at least equal to the number of "
"total package names. If more than one distribution is being accessed (for "
"instance, \"stable\" and \"unstable\"), this value can be considerably "
"larger than the number of total package names."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
#: apt-cache.8.xml:137
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:145
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:151
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:156
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:161
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:166
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:171
msgid "&synopsis-regex;"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:172
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 is."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:183
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:188
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:193
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:197
msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:198
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:203
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:209
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:218
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:223
msgid "Caution, dotty cannot graph larger sets of packages."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:227
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:231
msgid "<optional><replaceable>&synopsis-pkg;</replaceable>…</optional>"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:232
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:239
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:255
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:261
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:269
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:276
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:290
msgid ""
"Per default the <literal>depends</literal> and <literal>rdepends</literal> "
"print all dependencies. This can be tweaked with these flags which will omit "
"the specified dependency type. Configuration Item: "
"<literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal> "
"e.g. <literal>APT::Cache::ShowRecommends</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-cache.8.xml:297
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:302
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:311
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:317
msgid ""
"Only search on the 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:322
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:328
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:335
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><para>
#: apt-cache.8.xml:353
msgid "&apt-conf;, &sources-list;, &apt-get;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cache.8.xml:358
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:34
msgid "APT key management utility"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml:41
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><title>
#: apt-key.8.xml:47
msgid "Commands"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:52
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:65
msgid "Remove a key from the list of trusted keys."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:76
msgid "Output the key &synopsis-param-keyid; to standard output."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:87
msgid "Output all trusted keys to standard output."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:98
msgid "List trusted keys."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:109
msgid "List fingerprints of trusted keys."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:120
msgid ""
"Pass advanced options to gpg. With adv --recv-key you can download the "
"public key."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:132
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:146
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:162 apt-cdrom.8.xml:82
msgid "Options"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml:163
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:166
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><variablelist><varlistentry><term>
#: apt-key.8.xml:181
msgid "<filename>/etc/apt/trustdb.gpg</filename>"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:182
msgid "Local trust database of archive keys."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt-key.8.xml:185
msgid "&keyring-filename;"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:186
msgid "Keyring of &keyring-distro; archive trusted keys."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
#: apt-key.8.xml:189
msgid "&keyring-removed-filename;"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-key.8.xml:190
msgid "Keyring of &keyring-distro; archive removed trusted keys."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-key.8.xml:199
msgid "&apt-get;, &apt-secure;"
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt-mark.8.xml:35
msgid "mark/unmark a package as being automatically-installed"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-mark.8.xml:41
msgid ""
"<command>apt-mark</command> will change whether a package has been marked as "
"being automatically installed."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-mark.8.xml:45
msgid ""
"When you request that a package is installed, and as a result other packages "
"are installed to satisfy its dependencies, the dependencies are marked as "
"being automatically installed. Once these automatically installed packages "
"are no longer depended on by any manually installed packages, they will be "
"removed by e.g. <command>apt-get</command> or <command>aptitude</command>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml:54
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:62
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:70
msgid ""
"<literal>hold</literal> is used to mark a package as held back, which will "
"prevent the package from being automatically installed, upgraded or "
"removed. The command is only a wrapper around <command>dpkg "
"--set-selections</command> and the state is therefore maintained by &dpkg; "
"and not affected by the <option>--file</option> option."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml:80
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:86
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:94
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><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml:101
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><variablelist><varlistentry><listitem><para>
#: apt-mark.8.xml:117
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><para>
#: apt-mark.8.xml:138
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:49
msgid "Archive authentication support for APT"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:54
msgid ""
"Starting with version 0.6, <command>apt</command> contains code that does "
"signature checking of the Release file for all archives. This ensures that "
"packages in the archive can't be modified by people who have no access to "
"the Release file signing key."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:62
msgid ""
"If a package comes from a archive without a signature, or with a signature "
"that apt does not have a key for, that package is considered untrusted, and "
"installing it will result in a big warning. <command>apt-get</command> will "
"currently only warn for unsigned archives; future releases might force all "
"sources to be verified before downloading packages from them."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:71
msgid ""
"The package frontends &apt-get;, &aptitude; and &synaptic; support this new "
"authentication feature."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-secure.8.xml:76
msgid "Trusted archives"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:79
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:87
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:94
msgid ""
"The chain of trust in Debian starts when a maintainer uploads a new package "
"or a new version of a package to the Debian archive. In order to become "
"effective, this upload needs to be signed by a key contained in the Debian "
"Maintainers keyring (available in the debian-keyring package). Maintainers' "
"keys are signed by other maintainers following pre-established procedures to "
"ensure the identity of the key holder."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:104
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:115
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:120
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:125
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:133
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:140
msgid ""
"However, it does not defend against a compromise of the Debian master server "
"itself (which signs the packages) or against a compromise of the key used to "
"sign the Release files. In any case, this mechanism can complement a "
"per-package signature."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-secure.8.xml:146
msgid "User configuration"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:148
msgid ""
"<command>apt-key</command> is the program that manages the list of keys used "
"by apt. It can be used to add or remove keys, although an installation of "
"this release will automatically contain the default Debian archive signing "
"keys used in the Debian package repositories."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:155
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:164
msgid "Archive configuration"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:166
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:171
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:176
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:180
msgid ""
"<emphasis>Publish the key fingerprint</emphasis>, that way your users will "
"know what key they need to import in order to authenticate the files in the "
"archive."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:187
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:195
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:199
msgid ""
"For more background information you might want to review the <ulink "
"url=\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian "
"Security Infrastructure</ulink> chapter of the Securing Debian Manual "
"(available also in the harden-doc package) and the <ulink "
"url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong "
"Distribution HOWTO</ulink> by V. Alex Brennen."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt-secure.8.xml:212
msgid "Manpage Authors"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-secure.8.xml:214
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:34
msgid "APT CD-ROM management utility"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cdrom.8.xml:40
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:47
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:58
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:66
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:74
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:87
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:95
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:104
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:113
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:121
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:131
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:142
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:155
msgid "&apt-conf;, &apt-get;, &sources-list;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-cdrom.8.xml:160
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:35
msgid "APT Configuration Query program"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-config.8.xml:41
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:53
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:61
#, 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:66
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:70
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:79
msgid "Just show the contents of the configuration space."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-config.8.xml:92
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:97
msgid "&percnt;f &#x0022;&percnt;v&#x0022;;&percnt;n"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt-config.8.xml:98
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:112 apt-extracttemplates.1.xml:73 apt-sortpkgs.1.xml:66 apt-ftparchive.1.xml:610
msgid "&apt-conf;"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt-config.8.xml:117
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:22
msgid "Initial documentation of Debug::*."
msgstr ""
#. type: Content of: <refentry><refentryinfo><author><email>
#: apt.conf.5.xml:23
msgid "dburrows@debian.org"
msgstr ""
#. type: Content of: <refentry><refmeta><manvolnum>
#: apt.conf.5.xml:33 apt_preferences.5.xml:27 sources.list.5.xml:28
msgid "5"
msgstr ""
#. type: Content of: <refentry><refnamediv><refpurpose>
#: apt.conf.5.xml:40
msgid "Configuration file for APT"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:44
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:50
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:52
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:54
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:61
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:63
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:67
msgid "Syntax"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:68
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:74
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:87
#, 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:95
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:100
#, no-wrap
msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:103
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:106
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:109
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:114
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:124
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:132
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:140
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:155
msgid "The APT Group"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:156
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:161
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:168
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:182
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:190
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', '&stable-codename;', '&testing-codename;', "
"'4.0', '5.0*'. See also &apt-preferences;."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:196
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:201
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:209
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:221
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:234
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:245
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:257
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:273
msgid "Defines which packages are considered essential build dependencies."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:277
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:282
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:287
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:293
msgid "The Acquire Group"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:294
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:301
msgid ""
"Security related option defaulting to true, as giving a Release file's "
"validation an expiration date prevents replay attacks over a long timescale, "
"and can also for example help users to identify mirrors that are no longer "
"updated - but the feature depends on the correctness of the clock on the "
"user system. Archive maintainers are encouraged to create Release files with "
"the <literal>Valid-Until</literal> header, but if they don't or a stricter "
"value is desired the <literal>Max-ValidTime</literal> option below can be "
"used."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:314
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."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:326
msgid ""
"Minimum time (in seconds) after its creation (as indicated by the "
"<literal>Date</literal> header) that the <filename>Release</filename> file "
"should be considered valid. Use this if you need to use a seldom updated "
"(local) mirror of a more frequently updated archive with a "
"<literal>Valid-Until</literal> header instead of completely disabling the "
"expiration date checking. Archive specific settings can and should be used "
"by appending the label of the archive to the option name."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:338
msgid ""
"Try to download deltas called <literal>PDiffs</literal> for indexes (like "
"<filename>Packages</filename> files) instead of downloading whole ones. True "
"by default."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:341
msgid ""
"Two sub-options to limit the use of PDiffs are also available: "
"<literal>FileLimit</literal> can be used to specify a maximum number of "
"PDiff files should be downloaded to update a "
"file. <literal>SizeLimit</literal> on the other hand is the maximum "
"percentage of the size of all patches compared to the size of the targeted "
"file. If one of these limits is exceeded the complete file is downloaded "
"instead of the patches."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:351
msgid ""
"Queuing mode; <literal>Queue-Mode</literal> can be one of "
"<literal>host</literal> or <literal>access</literal> which determines how "
"APT parallelizes outgoing connections. <literal>host</literal> means that "
"one connection per target host will be opened, <literal>access</literal> "
"means that one connection per URI type will be opened."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:359
msgid ""
"Number of retries to perform. If this is non-zero APT will retry failed "
"files the given number of times."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:364
msgid ""
"Use symlinks for source archives. If set to true then source archives will "
"be symlinked when possible instead of copying. True is the default."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:369
msgid ""
"<literal>http::Proxy</literal> sets the default proxy to use for HTTP "
"URIs. It is in the standard form of "
"<literal>http://[[user][:pass]@]host[:port]/</literal>. Per host proxies "
"can also be specified by using the form "
"<literal>http::Proxy::&lt;host&gt;</literal> with the special keyword "
"<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
"settings is specified, <envar>http_proxy</envar> environment variable will "
"be used."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:377
msgid ""
"Three settings are provided for cache control with HTTP/1.1 compliant proxy "
"caches. <literal>No-Cache</literal> tells the proxy not to use its cached "
"response under any circumstances. <literal>Max-Age</literal> sets the "
"allowed maximum age (in seconds) of an index file in the cache of the "
"proxy. <literal>No-Store</literal> specifies that the proxy should not "
"store the requested archive files in its cache, which can be used to prevent "
"the proxy from polluting its cache with (big) .deb files."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:387 apt.conf.5.xml:475
msgid ""
"The option <literal>timeout</literal> sets the timeout timer used by the "
"method; this value applies to the connection as well as the data timeout."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:390
msgid ""
"The setting <literal>Acquire::http::Pipeline-Depth</literal> can be used to "
"enable HTTP pipelining (RFC 2616 section 8.1.2.2) which can be beneficial "
"e.g. on high-latency connections. It specifies how many requests are sent in "
"a pipeline. Previous APT versions had a default of 10 for this setting, but "
"the default value is now 0 (= disabled) to avoid problems with the "
"ever-growing amount of webservers and proxies which choose to not conform to "
"the HTTP/1.1 specification."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:397
msgid ""
"<literal>Acquire::http::AllowRedirect</literal> controls whether APT will "
"follow redirects, which is enabled by default."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:400
msgid ""
"The used bandwidth can be limited with "
"<literal>Acquire::http::Dl-Limit</literal> which accepts integer values in "
"kilobytes per second. The default value is 0 which deactivates the limit and "
"tries to use all available bandwidth. Note that this option implicitly "
"disables downloading from multiple servers at the same time."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:407
msgid ""
"<literal>Acquire::http::User-Agent</literal> can be used to set a different "
"User-Agent for the http download method as some proxies allow access for "
"clients only if the client uses a known identifier."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:411
msgid ""
"<literal>Acquire::http::Proxy-Auto-Detect</literal> can be used to specify "
"an external command to discover the http proxy to use. Apt expects the "
"command to output the proxy on stdout in the style "
"<literal>http://proxy:port/</literal>. This will override the generic "
"<literal>Acquire::http::Proxy</literal> but not any specific host proxy "
"configuration set via <literal>Acquire::http::Proxy::$HOST</literal>. See "
"the &squid-deb-proxy-client; package for an example implementation that uses "
"avahi. This option takes precedence over the legacy option name "
"<literal>ProxyAutoDetect</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:429
msgid ""
"The <literal>Cache-control</literal>, <literal>Timeout</literal>, "
"<literal>AllowRedirect</literal>, <literal>Dl-Limit</literal> and "
"<literal>proxy</literal> options work for HTTPS URIs in the same way as for "
"the <literal>http</literal> method, and default to the same values if they "
"are not explicitly set. The <literal>Pipeline-Depth</literal> option is not "
"yet supported."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:437
msgid ""
"<literal>CaInfo</literal> suboption specifies place of file that holds info "
"about trusted certificates. <literal>&lt;host&gt;::CaInfo</literal> is the "
"corresponding per-host option. <literal>Verify-Peer</literal> boolean "
"suboption determines whether or not the server's host certificate should be "
"verified against trusted certificates. "
"<literal>&lt;host&gt;::Verify-Peer</literal> is the corresponding per-host "
"option. <literal>Verify-Host</literal> boolean suboption determines whether "
"or not the server's hostname should be verified. "
"<literal>&lt;host&gt;::Verify-Host</literal> is the corresponding per-host "
"option. <literal>SslCert</literal> determines what certificate to use for "
"client authentication. <literal>&lt;host&gt;::SslCert</literal> is the "
"corresponding per-host option. <literal>SslKey</literal> determines what "
"private key to use for client "
"authentication. <literal>&lt;host&gt;::SslKey</literal> is the corresponding "
"per-host option. <literal>SslForceVersion</literal> overrides default SSL "
"version to use. It can contain either of the strings "
"'<literal>TLSv1</literal>' or '<literal>SSLv3</literal>'. "
"<literal>&lt;host&gt;::SslForceVersion</literal> is the corresponding "
"per-host option."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:458
msgid ""
"<literal>ftp::Proxy</literal> sets the default proxy to use for FTP URIs. "
"It is in the standard form of "
"<literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host proxies can "
"also be specified by using the form "
"<literal>ftp::Proxy::&lt;host&gt;</literal> with the special keyword "
"<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
"settings is specified, <envar>ftp_proxy</envar> environment variable will be "
"used. To use an FTP proxy you will have to set the "
"<literal>ftp::ProxyLogin</literal> script in the configuration file. This "
"entry specifies the commands to send to tell the proxy server what to "
"connect to. Please see &configureindex; for an example of how to do "
"this. The substitution variables representing the corresponding URI "
"component are <literal>$(PROXY_USER)</literal>, "
"<literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, "
"<literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal> and "
"<literal>$(SITE_PORT)</literal>."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:478
msgid ""
"Several settings are provided to control passive mode. Generally it is safe "
"to leave passive mode on; it works in nearly every environment. However, "
"some situations require that passive mode be disabled and port mode FTP used "
"instead. This can be done globally or for connections that go through a "
"proxy or for a specific host (see the sample config file for examples)."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:485
msgid ""
"It is possible to proxy FTP over HTTP by setting the "
"<envar>ftp_proxy</envar> environment variable to an HTTP URL - see the "
"discussion of the http method above for syntax. You cannot set this in the "
"configuration file and it is not recommended to use FTP over HTTP due to its "
"low efficiency."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:490
msgid ""
"The setting <literal>ForceExtended</literal> controls the use of RFC2428 "
"<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is "
"false, which means these commands are only used if the control connection is "
"IPv6. Setting this to true forces their use even on IPv4 connections. Note "
"that most FTP servers do not support RFC2428."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><literallayout>
#: apt.conf.5.xml:504
#, no-wrap
msgid "/cdrom/::Mount \"foo\";"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:499
msgid ""
"For URIs using the <literal>cdrom</literal> method, the only configurable "
"option is the mount point, <literal>cdrom::Mount</literal>, which must be "
"the mount point for the CD-ROM (or DVD, or whatever) drive as specified in "
"<filename>/etc/fstab</filename>. It is possible to provide alternate mount "
"and unmount commands if your mount point cannot be listed in the fstab. The "
"syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the "
"<literal>cdrom</literal> block. It is important to have the trailing slash. "
"Unmount commands can be specified using UMount."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:512
msgid ""
"For GPGV URIs the only configurable option is "
"<literal>gpgv::Options</literal>, which passes additional parameters to "
"gpgv."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis>
#: apt.conf.5.xml:523
#, no-wrap
msgid ""
"Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> "
"\"<replaceable>Methodname</replaceable>\";"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:518
msgid ""
"List of compression types which are understood by the acquire methods. "
"Files like <filename>Packages</filename> can be available in various "
"compression formats. By default the acquire methods can decompress "
"<command>bzip2</command>, <command>lzma</command> and "
"<command>gzip</command> compressed files; with this setting more formats can "
"be added on the fly or the used method can be changed. The syntax for this "
"is: <placeholder type=\"synopsis\" id=\"0\"/>"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis>
#: apt.conf.5.xml:528
#, no-wrap
msgid "Acquire::CompressionTypes::Order:: \"gz\";"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><synopsis>
#: apt.conf.5.xml:531
#, no-wrap
msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:524
msgid ""
"Also, the <literal>Order</literal> subgroup can be used to define in which "
"order the acquire system will try to download the compressed files. The "
"acquire system will try the first and proceed with the next compression type "
"in this list on error, so to prefer one over the other type simply add the "
"preferred type first - default types not already added will be implicitly "
"appended to the end of the list, so e.g. <placeholder type=\"synopsis\" "
"id=\"0\"/> can be used to prefer <command>gzip</command> compressed files "
"over <command>bzip2</command> and <command>lzma</command>. If "
"<command>lzma</command> should be preferred over <command>gzip</command> and "
"<command>bzip2</command> the configure setting should look like this: "
"<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add "
"<literal>bz2</literal> to the list explicitly as it will be added "
"automatically."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><literallayout>
#: apt.conf.5.xml:538
#, no-wrap
msgid "Dir::Bin::bzip2 \"/bin/bzip2\";"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:533
msgid ""
"Note that the "
"<literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be "
"checked at run time. If this option has been set, the method will only be "
"used if this file exists; e.g. for the <literal>bzip2</literal> method (the "
"inbuilt) setting is: <placeholder type=\"literallayout\" id=\"0\"/> Note "
"also that list entries specified on the command line will be added at the "
"end of the list specified in the configuration files, but before the default "
"entries. To prefer a type in this case over the ones specified in the "
"configuration files you can set the option direct - not in list style. This "
"will not override the defined list; it will only prefix the list with this "
"type."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:543
msgid ""
"The special type <literal>uncompressed</literal> can be used to give "
"uncompressed files a preference, but note that most archives don't provide "
"uncompressed files so this is mostly only useable for local mirrors."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:550
msgid ""
"When downloading <literal>gzip</literal> compressed indexes (Packages, "
"Sources, or Translations), keep them gzip compressed locally instead of "
"unpacking them. This saves quite a lot of disk space at the expense of more "
"CPU requirements when building the local package caches. False by default."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:558
msgid ""
"The Languages subsection controls which <filename>Translation</filename> "
"files are downloaded and in which order APT tries to display the "
"description-translations. APT will try to display the first available "
"description in the language which is listed first. Languages can be defined "
"with their short or long language codes. Note that not all archives provide "
"<filename>Translation</filename> files for every language - the long "
"language codes are especially rare."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><programlisting>
#: apt.conf.5.xml:575
#, no-wrap
msgid "Acquire::Languages { \"environment\"; \"de\"; \"en\"; \"none\"; \"fr\"; };"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:563
msgid ""
"The default list includes \"environment\" and "
"\"en\". \"<literal>environment</literal>\" has a special meaning here: it "
"will be replaced at runtime with the language codes extracted from the "
"<literal>LC_MESSAGES</literal> environment variable. It will also ensure "
"that these codes are not included twice in the list. If "
"<literal>LC_MESSAGES</literal> is set to \"C\" only the "
"<filename>Translation-en</filename> file (if available) will be used. To "
"force APT to use no Translation file use the setting "
"<literal>Acquire::Languages=none</literal>. \"<literal>none</literal>\" is "
"another special meaning code which will stop the search for a suitable "
"<filename>Translation</filename> file. This tells APT to download these "
"translations too, without actually using them unless the environment "
"specifies the languages. So the following example configuration will result "
"in the order \"en, de\" in an English locale or \"de, en\" in a German "
"one. Note that \"fr\" is downloaded, but not used unless APT is used in a "
"French locale (where the order would be \"fr, de, en\"). <placeholder "
"type=\"programlisting\" id=\"0\"/>"
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:576
msgid ""
"Note: To prevent problems resulting from APT being executed in different "
"environments (e.g. by different users or by other programs) all Translation "
"files which are found in <filename>/var/lib/apt/lists/</filename> will be "
"added to the end of the list (after an implicit "
"\"<literal>none</literal>\")."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:585
msgid "When downloading, force to use only the IPv4 protocol."
msgstr ""
#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
#: apt.conf.5.xml:591
msgid "When downloading, force to use only the IPv6 protocol."
msgstr ""
#. type: Content of: <refentry><refsect1><title>
#: apt.conf.5.xml:598
msgid "Directories"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:600
msgid ""
"The <literal>Dir::State</literal> section has directories that pertain to "
"local state information. <literal>lists</literal> is the directory to place "
"downloaded package lists in and <literal>status</literal> is the name of the "
"&dpkg; status file. <literal>preferences</literal> is the name of the APT "
"<filename>preferences</filename> file. <literal>Dir::State</literal> "
"contains the default directory to prefix on all sub-items if they do not "
"start with <filename>/</filename> or <filename>./</filename>."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:607
msgid ""
"<literal>Dir::Cache</literal> contains locations pertaining to local cache "
"information, such as the two package caches <literal>srcpkgcache</literal> "
"and <literal>pkgcache</literal> as well as the location to place downloaded "
"archives, <literal>Dir::Cache::archives</literal>. Generation of caches can "
"be turned off by setting their names to the empty string. This will slow "
"down startup but save disk space. It is probably preferable to turn off the "
"pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the "
"default directory is contained in <literal>Dir::Cache</literal>"
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:616
msgid ""
"<literal>Dir::Etc</literal> contains the location of configuration files, "
"<literal>sourcelist</literal> gives the location of the sourcelist and "
"<literal>main</literal> is the default configuration file (setting has no "
"effect, unless it is done from the config file specified by "
"<envar>APT_CONFIG</envar>)."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:622
msgid ""
"The <literal>Dir::Parts</literal> setting reads in all the config fragments "
"in lexical order from the directory specified. After this is done then the "
"main config file is loaded."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:626
msgid ""
"Binary programs are pointed to by "
"<literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies "
"the location of the method handlers and <literal>gzip</literal>, "
"<literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, "
"<literal>apt-get</literal> <literal>dpkg-source</literal> "
"<literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> "
"specify the location of the respective programs."
msgstr ""
#. type: Content of: <refentry><refsect1><para>
#: apt.conf.5.xml:634
msgid ""
"The configuration item <literal>RootDir</literal> has a special meaning. If "
"set, all paths in <literal>Dir::</literal> will be relative to "
"<literal>RootDir</literal>, <emphasis>even paths that are specified "
"absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is "
"set to <filename>/tmp/staging</filename> and "