diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/.cvsignore | 14 | ||||
| -rw-r--r-- | doc/apt-cache.8.xml | 2 | ||||
| -rw-r--r-- | doc/apt-get.8.xml | 25 | ||||
| -rw-r--r-- | doc/apt.conf.5.xml | 46 | ||||
| -rw-r--r-- | doc/apt.ent | 7 | ||||
| -rw-r--r-- | doc/apt_preferences.5.xml | 90 | ||||
| -rw-r--r-- | doc/es/.cvsignore | 14 | ||||
| -rw-r--r-- | doc/examples/configure-index | 69 | ||||
| -rw-r--r-- | doc/fr/.cvsignore | 13 | ||||
| -rw-r--r-- | doc/fr/apt-get.fr.8.xml | 2 | ||||
| -rw-r--r-- | doc/fr/apt.conf.fr.5.xml | 534 | ||||
| -rw-r--r-- | doc/pt_BR/.cvsignore | 3 |
12 files changed, 648 insertions, 171 deletions
diff --git a/doc/.cvsignore b/doc/.cvsignore deleted file mode 100644 index 94d80ad54..000000000 --- a/doc/.cvsignore +++ /dev/null @@ -1,14 +0,0 @@ -apt-cache.8 -apt-get.8 -apt-cdrom.8 -apt.conf.5 -sources.list.5 -apt-config.8 -apt-sortpkgs.1 -apt-ftparchive.1 -manpage.links -manpage.refs -manpage.log -apt_preferences.5 -apt-extracttemplates.1 -vendors.list.5 diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 21605ff0e..6c8938d8c 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -300,7 +300,7 @@ Reverse Provides: </varlistentry> <varlistentry><term><option>-i</option></term><term><option>--important</option></term> - <listitem><para>Print only important dependencies; for use with unmet. Causes only Depends and + <listitem><para>Print only important dependencies; for use with unmet and depends. Causes only Depends and Pre-Depends relations to be printed. Configuration Item: <literal>APT::Cache::Important</literal>.</para></listitem> </varlistentry> diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index ace7f9e1b..920f6b36e 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -53,6 +53,9 @@ <arg choice='plain'> <replaceable>target_release_number_expression</replaceable> </arg> + <arg choice='plain'> + <replaceable>target_release_codename</replaceable> + </arg> </group> </arg> @@ -71,6 +74,9 @@ <arg choice='plain'> /<replaceable>target_release_name</replaceable> </arg> + <arg choice='plain'> + /<replaceable>target_release_codename</replaceable> + </arg> </group> </arg> </arg> @@ -357,6 +363,12 @@ actually change the system. Configuration Item: <literal>APT::Get::Simulate</literal>.</para> + <para>Simulation run as user will deactivate locking (<literal>Debug::NoLocking</literal>) + automatical. Also a notice will be displayed indicating that this is only a simulation, + if the option <literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: true) + Neigther NoLocking nor the notice will be triggered if run as root (root should know what + he is doing without further warnings by <literal>apt-get</literal>).</para> + <para>Simulate prints out a series of lines each one representing a dpkg operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets indicate broken packages with @@ -390,6 +402,14 @@ Configuration Item: <literal>APT::Get::Compile</literal>.</para></listitem> </varlistentry> + <varlistentry><term><option>--install-recommends</option></term> + <listitem><para>Also install recommended packages.</para></listitem> + </varlistentry> + + <varlistentry><term><option>--no-install-recommends</option></term> + <listitem><para>Do not install recommended packages.</para></listitem> + </varlistentry> + <varlistentry><term><option>--ignore-hold</option></term> <listitem><para>Ignore package Holds; This causes <command>apt-get</command> to ignore a hold placed on a package. This may be useful in conjunction with @@ -455,7 +475,8 @@ 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> or <option>-t unstable</option>. + <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.</para></listitem> </varlistentry> @@ -581,8 +602,8 @@ <title>CURRENT AUTHORS</title> <para> &apt-author.team; - &apt-qapage; </para> + &apt-qapage; </refsect1> &manbugs; </refentry> diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index 4d9e708a8..1fe980d28 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -71,7 +71,7 @@ APT { </programlisting></informalexample> <para>with newlines placed to make it more readable. Lists can be created by - opening a scope and including a single word enclosed in quotes followed by a + opening a scope and including a single string enclosed in quotes followed by a semicolon. Multiple entries can be included, each separated by a semicolon.</para> <informalexample><programlisting> @@ -88,7 +88,8 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; <para>Two specials are allowed, <literal>#include</literal> and <literal>#clear</literal> <literal>#include</literal> will include the given file, unless the filename ends in a slash, then the whole directory is included. - <literal>#clear</literal> is used to erase a list of names.</para> + <literal>#clear</literal> is used to erase a part of the configuration tree. The + specified element and all its descendents are erased.</para> <para>All of the APT tools take a -o option which allows an arbitrary configuration directive to be specified on the command line. The syntax is a full option @@ -110,7 +111,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; <varlistentry><term>Default-Release</term> <listitem><para>Default release to install packages from if more than one - version available. Contains release name or release version. Examples: 'stable', 'testing', 'unstable', '4.0', '5.0*'. Release codenames ('etch', 'lenny' etc.) are not allowed now. See also &apt-preferences;.</para></listitem> + version available. Contains release name, codename or release version. Examples: 'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also &apt-preferences;.</para></listitem> </varlistentry> <varlistentry><term>Ignore-Hold</term> @@ -174,7 +175,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; <variablelist> <varlistentry><term>PDiffs</term> - <listitem><para>Try do download deltas called <literal>PDiffs</literal> for + <listitem><para>Try to download deltas called <literal>PDiffs</literal> for Packages or Sources files instead of downloading whole ones. True by default.</para></listitem> </varlistentry> @@ -684,12 +685,33 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; </listitem> </varlistentry> + <varlistentry> + <term><literal>Debug::pkgDepCache::Marker</literal></term> + <listitem> + <para> + Generate debug messages describing which package is marked + as keep/install/remove while the ProblemResolver does his work. + Each addition or deletion may trigger additional actions; + they are shown indented two additional space under the original entry. + The format for each line is <literal>MarkKeep</literal>, + <literal>MarkDelete</literal> or <literal>MarkInstall</literal> followed by + <literal>package-name <a.b.c -> d.e.f | x.y.z> (section)</literal> + where <literal>a.b.c</literal> is the current version of the package, + <literal>d.e.f</literal> is the version considered for installation and + <literal>x.y.z</literal> is a newer version, but not considered for installation + (because of a low pin score). The later two can be omitted if there is none or if + it is the same version as the installed. + <literal>section</literal> is the name of the section the package appears in. + </para> + </listitem> + </varlistentry> + <!-- Question: why doesn't this do anything? The code says it should. --> <varlistentry> <term><literal>Debug::pkgInitConfig</literal></term> <listitem> <para> - Dump the default configuration to standard output on + Dump the default configuration to standard error on startup. </para> </listitem> @@ -762,6 +784,17 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; </varlistentry> <varlistentry> + <term><literal>Debug::pkgProblemResolver::ShowScores</literal></term> + <listitem> + <para> + Display a list of all installed packages with their calculated score + used by the pkgProblemResolver. The description of the package + is the same as described in <literal>Debug::pkgDepCache::Marker</literal> + </para> + </listitem> + </varlistentry> + + <varlistentry> <term><literal>Debug::sourceList</literal></term> <listitem> @@ -772,6 +805,8 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; </listitem> </varlistentry> +<!-- 2009/07/11 Currently used nowhere. The corresponding code +is commented. <varlistentry> <term><literal>Debug::Vendor</literal></term> @@ -781,6 +816,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; </para> </listitem> </varlistentry> +--> </variablelist> </refsect1> diff --git a/doc/apt.ent b/doc/apt.ent index 6594ba1b3..4cfc00069 100644 --- a/doc/apt.ent +++ b/doc/apt.ent @@ -179,6 +179,13 @@ </author> "> +<!ENTITY apt-author.moconnor " + <author> + <firstname>Mike</firstname> + <surname>O'Connor</surname> + </author> +"> + <!ENTITY apt-author.team " <author> <othername>APT team</othername> diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml index 162c2f00e..ff63f1dd3 100644 --- a/doc/apt_preferences.5.xml +++ b/doc/apt_preferences.5.xml @@ -14,7 +14,7 @@ &apt-email; &apt-product; <!-- The last update date --> - <date>29 February 2004</date> + <date>04 May 2009</date> </refentryinfo> <refmeta> @@ -191,6 +191,15 @@ Pin-Priority: 50 </programlisting> <simpara>The following record assigns a high priority to all package versions +belonging to any distribution whose Codename is "<literal>squeeze</literal>".</simpara> + +<programlisting> +Package: * +Pin: release n=squeeze +Pin-Priority: 900 +</programlisting> + +<simpara>The following record assigns a high priority to all package versions belonging to any release whose Archive name is "<literal>stable</literal>" and whose release Version number is "<literal>3.0</literal>".</simpara> @@ -327,10 +336,11 @@ file are relevant for setting APT priorities: <variablelist> <varlistentry> -<term>the <literal>Archive:</literal> line</term> +<term>the <literal>Archive:</literal> or <literal>Suite:</literal> line</term> <listitem><simpara>names the archive to which all the packages in the directory tree belong. For example, the line -"Archive: stable" +"Archive: stable" or +"Suite: stable" specifies that all of the packages in the directory tree below the parent of the <filename>Release</filename> file are in a <literal>stable</literal> archive. Specifying this value in the APT preferences file @@ -343,6 +353,22 @@ Pin: release a=stable </varlistentry> <varlistentry> +<term>the <literal>Codename:</literal> line</term> +<listitem><simpara>names the codename to which all the packages +in the directory tree belong. For example, the line +"Codename: squeeze" +specifies that all of the packages in the directory +tree below the parent of the <filename>Release</filename> file belong to a version named +<literal>squeeze</literal>. Specifying this value in the APT preferences file +would require the line: +</simpara> +<programlisting> +Pin: release n=squeeze +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> <term>the <literal>Version:</literal> line</term> <listitem><simpara>names the release version. For example, the packages in the tree might belong to Debian GNU/Linux release @@ -522,7 +548,64 @@ version. apt-get install <replaceable>package</replaceable>/unstable </programlisting> </para> +</refsect2> + + +<refsect2> +<title>Tracking the evolution of a codename release</title> + +<para>The following APT preferences file will cause APT to assign a +priority higher than the default (500) to all package versions belonging +to a specified codename of a distribution and a prohibitively low priority to +package versions belonging to other <literal>Debian</literal> distributions, +codenames and archives. +Note that with this APT preference APT will follow the migration of a release +from the archive <literal>testing</literal> to <literal>stable</literal> and +later <literal>oldstable</literal>. If you want to follow for example the progress +in <literal>testing</literal> notwithstanding the codename changes you should use +the example configurations above. + +<programlisting> +Explanation: Uninstall or do not install any Debian-originated package versions +Explanation: other than those in the distribution codenamed with squeeze or sid +Package: * +Pin: release n=squeeze +Pin-Priority: 900 + +Explanation: Debian unstable is always codenamed with sid +Package: * +Pin: release a=sid +Pin-Priority: 800 + +Package: * +Pin: release o=Debian +Pin-Priority: -10 +</programlisting> +</para> + +<para>With a suitable &sources-list; file and the above preferences file, +any of the following commands will cause APT to upgrade to the +latest version(s) in the release codenamed with <literal>squeeze</literal>. + +<programlisting> +apt-get install <replaceable>package-name</replaceable> +apt-get upgrade +apt-get dist-upgrade +</programlisting> +</para> + +<para>The following command will cause APT to upgrade the specified +package to the latest version from the <literal>sid</literal> distribution. +Thereafter, <command>apt-get upgrade</command> will upgrade +the package to the most recent <literal>squeeze</literal> version if that is +more recent than the installed version, otherwise, to the most recent +<literal>sid</literal> version if that is more recent than the installed +version. +<programlisting> +apt-get install <replaceable>package</replaceable>/sid +</programlisting> +</para> </refsect2> </refsect1> @@ -535,4 +618,3 @@ apt-get install <replaceable>package</replaceable>/unstable &manbugs; </refentry> - diff --git a/doc/es/.cvsignore b/doc/es/.cvsignore deleted file mode 100644 index ce363466a..000000000 --- a/doc/es/.cvsignore +++ /dev/null @@ -1,14 +0,0 @@ -apt-cache.es.8 -apt-get.es.8 -apt-cdrom.es.8 -apt.conf.es.5 -sources.list.es.5 -apt-config.es.8 -apt-sortpkgs.es.1 -apt-ftparchive.es.1 -manpage.links -manpage.refs -manpage.log -apt_preferences.es.5 -apt-extracttemplates.es.1 -vendors.list.es.5 diff --git a/doc/examples/configure-index b/doc/examples/configure-index index db07f189e..5dc7b5246 100644 --- a/doc/examples/configure-index +++ b/doc/examples/configure-index @@ -55,6 +55,7 @@ APT Diff-Only "false"; Tar-Only "false"; Build-Dep-Automatic "true"; + Show-User-Simulation-Note "true"; }; Cache @@ -115,6 +116,56 @@ APT // Keep the list of FDs open (normally apt closes all fds when it // does a ExecFork) Keep-Fds {}; + + // control parameters for cron jobs by /etc/cron.daily/apt + Periodic + { + BackupArchiveInterval "0"; + // - Backup after n-days if archive contents changed.(0=disable) + + BackupLevel "3"; + // - Backup level.(0=disable), 1 is invalid. + + // APT::Archives::MaxAge "0"; (old, deprecated) + MaxAge "0"; // (new) + // - Set maximum allowed age of a cache package file. If a cache + // package file is older it is deleted (0=disable) + + // APT::Archives::MinAge "2"; (old, deprecated) + MinAge "2"; // (new) + // - Set minimum age of a package file. If a file is younger it + // will not be deleted (0=disable). Usefull to prevent races + // and to keep backups of the packages for emergency. + + // APT::Archives::MaxSize "0"; (old, deprecated) + MaxSize "0"; // (new) + // - Set maximum size of the cache in MB (0=disable). If the cache + // is bigger, cached package files are deleted until the size + // requirement is met (the biggest packages will be deleted + // first). + + Update-Package-Lists "0"; + // - Do "apt-get update" automatically every n-days (0=disable) + // + Download-Upgradeable-Packages "0"; + // - Do "apt-get upgrade --download-only" every n-days (0=disable) + // + Unattended-Upgrade "0"; + // - Run the "unattended-upgrade" security upgrade script + // every n-days (0=disabled) + // Requires the package "unattended-upgrades" and will write + // a log in /var/log/unattended-upgrades + // + AutocleanInterval "0"; + // - Do "apt-get autoclean" every n-days (0=disable) + + Verbose "0"; + // - Send report mail to root + // 0: no report (or null string) + // 1: progress report (actually any string) + // 2: + command outputs (remove -qq, remove 2>/dev/null, add -d) + // 3: + trace on + }; }; // Options for the downloading routines @@ -133,7 +184,8 @@ Acquire Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting Timeout "120"; Pipeline-Depth "5"; - + AllowRedirect "true"; + // Cache Control. Note these do not work with Squid 2.0.2 No-Cache "false"; Max-Age "86400"; // 1 Day age on index files @@ -150,7 +202,8 @@ Acquire Verify-Peer "false"; SslCert "/etc/apt/some.pem"; CaPath "/etc/ssl/certs"; - Verify-Host" "2"; + Verify-Host" "true"; + AllowRedirect "true"; }; ftp @@ -211,16 +264,22 @@ Dir "/" // Location of the cache dir Cache "var/cache/apt/" { Archives "archives/"; + // backup directory created by /etc/cron.daily/apt + Backup "backup/"; srcpkgcache "srcpkgcache.bin"; pkgcache "pkgcache.bin"; }; // Config files Etc "etc/apt/" { - SourceList "sources.list"; Main "apt.conf"; - Preferences "preferences"; Parts "apt.conf.d/"; + Preferences "preferences"; + PreferencesParts "preferences.d"; + SourceList "sources.list"; + SourceParts "sources.list.d"; + VendorList "vendors.list"; + VendorParts "vendors.list.d"; }; // Locations of binaries @@ -286,7 +345,9 @@ DPkg Debug { pkgProblemResolver "false"; + pkgProblemResolver::ShowScores "false"; pkgDepCache::AutoInstall "false"; // what packages apt install to satify dependencies + pkgDepCache::Marker "false"; pkgAcquire "false"; pkgAcquire::Worker "false"; pkgAcquire::Auth "false"; diff --git a/doc/fr/.cvsignore b/doc/fr/.cvsignore deleted file mode 100644 index cfa89623e..000000000 --- a/doc/fr/.cvsignore +++ /dev/null @@ -1,13 +0,0 @@ -apt-cdrom.fr.8 -apt-config.fr.8 -apt-extracttemplates.fr.1 -apt-ftparchive.fr.1 -apt-sortpkgs.fr.1 -apt.conf.fr.5 -apt_preferences.fr.5 -manpage.links -manpage.refs -sources.list.fr.5 -apt-cache.fr.8 -apt-get.fr.8 -vendors.list.fr.5 diff --git a/doc/fr/apt-get.fr.8.xml b/doc/fr/apt-get.fr.8.xml index dccf415b1..c1b8552cb 100644 --- a/doc/fr/apt-get.fr.8.xml +++ b/doc/fr/apt-get.fr.8.xml @@ -201,7 +201,7 @@ semblables à des sources téléchargés sous forme de tarball. <listitem><para> Avec la commande <literal>build-dep</literal>, apt-get installe ou supprime des paquets dans le but de satisfaire les dépendances de construction d'un paquet source. -Pour l'instant, dans la cas d'un paquet virtuel, un paquet est choisi au +Pour l'instant, dans le cas d'un paquet virtuel, un paquet est choisi au hasard. </para></listitem> </varlistentry> diff --git a/doc/fr/apt.conf.fr.5.xml b/doc/fr/apt.conf.fr.5.xml index 88ce46134..f4d8eddb8 100644 --- a/doc/fr/apt.conf.fr.5.xml +++ b/doc/fr/apt.conf.fr.5.xml @@ -15,7 +15,7 @@ &apt-email; &apt-product; <!-- The last update date --> - <date>29 Février 2004</date> + <date>11 juillet 2008</date> </refentryinfo> <refmeta> @@ -33,26 +33,30 @@ Le fichier <filename>apt.conf</filename> est le principal fichier de configurati de la collection d'outils que constitue APT ; tous les outils font appel à ce fichier de configuration et utilisent un analyseur syntaxique en ligne de commande commun afin de fournir un environnement uniforme. Quand un outil -d'APT démarre, il lit (si elle existe) la variable d'environnement -<envar>APT_CONFIG</envar> ; puis il lit les fichiers situés dans +d'APT démarre, il lit la configuration désignée par variable d'environnement +<envar>APT_CONFIG</envar> (si elle existe), puis il lit les fichiers situés dans <literal>Dir::Etc::Parts</literal> ainsi que le principal fichier de configuration indiqué par <literal>Dir::Etc::main</literal> ; enfin il applique les options de -la ligne de commande qui annulent les directives de configuration, chargeant, -si nécessaire, d'autres fichiers de configuration. +la ligne de commande qui prévalent sur les directives de configuration, chargeant +si nécessaire d'autres fichiers de configuration. </para> <para> Le fichier de configuration est construit comme un arbre d'options organisées en groupes fonctionnels. On se sert du double deux points (« :: ») pour indiquer une option ; par exemple, <literal>APT::Get::Assume-Yes</literal> est -une option pour le groupe d'outils APT, destinée à l'outil Get. Les options -n'héritent pas des groupes de leurs parents. +une option pour le groupe d'outils APT, destinée à l'outil Get. Il n'y a pas d'héritage +des options des groupes parents. </para> <para> Syntaxiquement, le langage de configuration est conçu sur le même modèle que les langages utilisés par des outils ISC tels que bind et dhcp. Une ligne -qui commence par <literal>//</literal> est un commentaire et elle est ignorée. +qui commence par <literal>//</literal> est traitée comme un commentaire et ignorée, de +même que les sections de texte placées entre <literal>/*</literal> et +<literal>*/</literal>, tout comme les commentaires C/C++. Chaque ligne est de la forme : - <literal>APT::Get::Assume-Yes "true";</literal> +<informalexample><programlisting> +<literal>APT::Get::Assume-Yes "true";</literal> + </programlisting></informalexample> Le point-virgule final est obligatoire et les guillemets sont optionnels. On peut déclarer un nouveau champ d'action avec des accolades, comme suit : @@ -68,10 +72,9 @@ APT { </programlisting></informalexample> <para> -avec des retours à la ligne pour faciliter la lecture. On peut créer des -listes en ouvrant un champ d'action et en mettant un seul mot entre -apostrophes suivi d'un point-virgule. On peut mettre plusieurs entrées, -séparées par un point-virgule. +avec des retours à la ligne pour faciliter la lecture. On peut créer une liste +en ouvrant un champ d'action et en y insérant une chaîne entre guillemets suivie +d'un point virgule pour chaque élément de la liste. </para> <informalexample><programlisting> @@ -79,14 +82,21 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; </programlisting></informalexample> <para> -Les modèles <filename>&docdir;examples/apt.conf</filename> &configureindex; +Les modèles <filename>&docdir;examples/apt.conf</filename> et &configureindex; montrent à quoi devrait ressembler le fichier de configuration. </para> <para> +Les identifiants des options de configuration ne sont pas sensibles à la casse. +Dans l'exemple précédent, on pourrait donc aussi bien utiliser +<literal>dpkg::pre-install-pkgs</literal>. + </para> +<para> Deux éléments spéciaux sont autorisés : <literal>#include</literal> et -<literal>#clear</literal>. <literal>#include</literal> inclut le fichier donné en argument, -à moins que le nom ne se termine par une barre oblique. <literal>#clear</literal> sert à -effacer une liste de noms. +<literal>#clear</literal>. <literal>#include</literal> inclut le fichier donné en +argument, à moins que le nom ne se termine par une barre oblique auquel cas le +répertoire entier est inclus. <literal>#clear</literal> sert à +effacer une partie de l'arbre de configuration. L'élément désigné et tout ses +descendants sont supprimés. </para> <para> Tous les outils d'APT possèdent une option <option>-o</option> qui permet de @@ -95,20 +105,31 @@ syntaxe consiste en un nom complet d'option (par exemple <literal>APT::Get::Assume-Yes</literal>) suivi par un signe égal, puis par la nouvelle valeur de l'option. On peut compléter une liste en ajoutant un « :: » au nom de la liste. - </para> + </para> </refsect1> <refsect1><title>Le groupe APT</title> -<para> -Ce groupe d'options contrôle aussi bien le comportement global d'APT que -la prise en compte des options pour chaque outil. +<para> +Ce groupe d'options contrôle le comportement global d'APT et contient également +des options communes à tous les outils. </para> <variablelist> <varlistentry><term>Architecture</term> <listitem><para> L'architecture du système ; cette option positionne l'architecture à utiliser -pour récupérer des fichiers et analyser des listes de paquets. L'architecture -interne par défaut est celle pour laquelle APT a été compilé. +pour récupérer des fichiers et analyser des listes de paquets. La valeur interne par +défaut est l'architecture pour laquelle APT a été compilé. + </para></listitem> +</varlistentry> + +<varlistentry><term>Default-Release</term> +<listitem><para> +Indique la distribution à utiliser par défaut lors de l'installation d'un +paquet si plusieurs versions sont disponibles. La valeur peut être un nom de +distribution ou un numéro de version. Exemples : « stable », +« testing », « 4.0 », « 5.0* ». Les noms de codes +des distributions (« etch », « lenny », etc.) ne sont pas +permis pour l'instant. Voir aussi &apt-preferences;. </para></listitem> </varlistentry> @@ -123,7 +144,7 @@ dans sa prise de décision. <varlistentry><term>Clean-Installed</term> <listitem><para> Avec cette option qui est activée par défaut, la fonctionnalité « autoclean » -supprime tout paquet qui ne peut plus être récupéré dans le cache. +supprime du cache tout paquet qui ne peut plus être récupéré. Quand cette option est désactivée, les paquets qui sont installés localement sont aussi exclus du nettoyage - mais notez que APT ne fournit aucun moyen direct pour les réinstaller. @@ -134,9 +155,9 @@ direct pour les réinstaller. <listitem><para> Désactive la configuration immédiate ; cette dangereuse option désactive une partie du code de mise en ordre de APT pour que ce dernier effectue le -moins d'appels possible à Dpkg. C'est peut-être nécessaire sur des systèmes -lents à un seul utilisateur mais c'est extrêmement dangereux et cela peut -faire échouer les scripts d'installation, voire pire. +moins d'appels possible à &dpkg;. Ça peut être nécessaire sur des systèmes +à un seul utilisateur extrêmement lents, mais cette option est très dangereuse et +peut faire échouer les scripts d'installation, voire pire. Utilisez-la à vos risques et périls. </para></listitem> </varlistentry> @@ -155,39 +176,37 @@ ou tous les paquets dont ces paquets dépendent. <varlistentry><term>Cache-Limit</term> <listitem><para> -APT utilise un fichier cache d'une taille mémoire fixe pour ranger les -informations du fichier « available ». Cette option fixe la taille -de ce cache. +APT utilise un fichier de cache chargé en mémoire avec mmap pour ranger les +informations sur les paquets disponibles. Cette option fixe la taille mémoire +allouée pour le chargement de ce cache. </para></listitem> </varlistentry> <varlistentry><term>Build-Essential</term> <listitem><para> Cette option définit les paquets qui sont considérés comme faisant partie -des dépendances essentielles pour la construction des paquets. +des dépendances essentielles pour la construction de paquets. </para></listitem> </varlistentry> <varlistentry><term>Get</term> <listitem><para>La sous-section <literal>Get</literal> contrôle l'outil &apt-get;, -veuillez consulter -sa documentation pour avoir plus d'informations sur les options en question. +veuillez consulter sa documentation pour avoir plus d'informations sur les options +en question. </para></listitem> </varlistentry> <varlistentry><term>Cache</term> -<listitem><para>La sous-section <literal>Cache</literal> contrôle l'outil &apt-cache;, -veuillez -consulter sa documentation pour avoir plus d'informations sur les options en -question. +<listitem><para>La sous-section <literal>Cache</literal> contrôle l'outil +&apt-cache;, veuillez consulter sa documentation pour avoir plus d'informations +sur les options en question. </para></listitem> </varlistentry> <varlistentry><term>CDROM</term> -<listitem><para>La sous-section <literal>CDROM</literal> contrôle l'outil&apt-cdrom;, -veuillez -consulter sa documentation pour avoir plus d'informations sur les options en -question. +<listitem><para>La sous-section <literal>CDROM</literal> contrôle l'outil +&apt-cdrom;, veuillez consulter sa documentation pour avoir plus d'informations +sur les options en question. </para></listitem> </varlistentry> </variablelist> @@ -199,13 +218,20 @@ Le groupe d'options <literal>Acquire</literal> contrôle le téléchargement des pa les gestionnaires d'URI. <variablelist> +<varlistentry><term>PDiffs</term> +<listitem><para>Essayer de télécharger les fichiers différentiels appelés +<literal>PDiffs</literal> pour les paquets ou les fichiers sources, plutôt que +de les télécharger entièrement. Par défaut à « true ». + </para></listitem> +</varlistentry> + <varlistentry><term>Queue-Mode</term> <listitem><para> -Le mode file d'attente ; <literal>Queue-Mode</literal> peut prendre une valeur -parmi <literal>host</literal> ou <literal>access</literal> et cela détermine comment APT -parallélise les connexions sortantes. <literal>Host</literal> signifie qu'une -connexion par cible sera initiée, tandis que <literal>access</literal> signifie qu'une -connexion par type d'URI sera initiée. +Le mode de file d'attente ; <literal>Queue-Mode</literal> peut prendre les +valeurs <literal>host</literal> ou <literal>access</literal> et cela détermine +comment APT parallélise les connexions sortantes. <literal>Host</literal> signifie +qu'une connexion par cible sera initiée, tandis que <literal>access</literal> signifie +qu'une connexion par type d'URI sera initiée. </para></listitem> </varlistentry> @@ -227,30 +253,32 @@ Par défaut à « true ». <varlistentry><term>http</term> <listitem><para> -URI HTTP ; http::Proxy est le mandataire (proxy) http à utiliser par défaut. +URI HTTP ; http::Proxy est le mandataire (proxy) HTTP à utiliser par défaut. Il se présente sous la forme standard : -<literal>http://[[user][:pass]@]host[:port]/</literal>. En utilisant la syntaxe : -<literal>http::Proxy::<host></literal>, où le mot-clé spécial <literal>DIRECT</literal> -indique de n'utiliser aucun mandataire, on peut spécifier un mandataire -pour chaque machine distante. La variable d'environnement <envar>http_proxy</envar> -remplace tous ces paramètres. +<literal>http://[[user][:pass]@]host[:port]/</literal>. On peut spécifier un +mandataire particulier par hôte distant en utilisant la syntaxe : +<literal>http::Proxy::<hôte></literal>. Le mot-clé spécial +<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour +l'hôte. +Lorsqu'elle est définie, la variable d'environnement <envar>http_proxy</envar> +annule et remplace toutes les options de mandataire HTTP. </para> <para> -Trois options de configuration sont fournies pour le contrôle des caches qui -sont compatibles avec HTTP/1.1. <literal>No-Cache</literal> signifie que le mandataire -ne doit pas du tout utiliser les réponses qu'il a stockées ; <literal>Max-Age</literal> +Trois options de configuration sont fournies pour le contrôle des caches compatibles +avec HTTP/1.1. <literal>No-Cache</literal> signifie que le mandataire ne doit jamais +utiliser les réponses qu'il a stockées ; <literal>Max-Age</literal> sert uniquement pour les fichiers d'index : cela demande au cache de les mettre à jour quand leur ancienneté est supérieure au nombre de secondes -donné. Debian met à jour son fichier d'index de manière journalière, la +donné. Debian met à jour ses fichiers d'index de manière quotidienne ; la valeur par défaut est donc de 1 jour. <literal>No-Store</literal> sert uniquement -pour les fichiers d'archive : cela demande au cache de ne jamais garder +pour les fichiers d'archive et demande au cache de ne jamais garder la requête. Cela peut éviter de polluer un cache mandataire avec des fichiers .deb très grands. Note : Squid 2.0.2 ne prend en compte aucune de ces options. </para> <para> L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout) -utilisé par la méthode : cela vaut pour tout (connexion, données). +utilisé par la méthode. Cela vaut pour tout, connexion et données. </para> <para> Une option de configuration est fournie pour contrôler la profondeur du tube @@ -264,27 +292,62 @@ ne respectent pas la RFC 2068. </para></listitem> </varlistentry> +<varlistentry><term>https</term> +<listitem><para> +URI HTTPS. Les options de contrôle de cache et de mandataire (proxy) sont les +mêmes que pour la méthode <literal>http</literal>. L'option +<literal>Pipeline-Depth</literal> n'est pas encore supportée. + </para> + +<para>La sous-option <literal>CaInfo</literal> spécifie le fichier contenant +les informations sur les certificats de confiance. +La sous-option booléenne <literal>Verify-Peer</literal> précise si le +certificat d'hôte du serveur doit être confronté aux certificats de confiance +ou pas. La sous-option booléenne <literal>Verify-Host</literal> précise s'il +faut vérifier ou pas le nom d'hôte du serveur. <literal>SslCert</literal> +détermine le certificat à utiliser pour l'authentification du client. +<literal>SslKey</literal> détermine quelle clef privée doit être utilisée pour +l'authentification du client. <literal>SslForceVersion</literal> surcharge la +valeur par défaut pour la version de SSL à utiliser et peut contenir l'une des +chaînes 'TLSv1' ou 'SSLv3'. + </para> +<para>Chacune de ces options peut être spécifiée pour un hôte particulier en +utilisant <literal><hôte>::CaInfo</literal>, +<literal><hôte>::Verify-Peer</literal>, +<literal><hôte>::Verify-Host</literal>, +<literal><hôte>::SslCert</literal>, +<literal><hôte>::SslKey</literal> et +<literal><hôte>::SslForceVersion</literal> respectivement. + </para></listitem> +</varlistentry> + <varlistentry><term>ftp</term> <listitem><para> -URI FTP ; ftp::Proxy est le serveur mandataire par défaut à utiliser. Il se -présente sous la forme standard : -<literal>ftp://[[user][:pass]@]host[:port]/</literal> ; il est remplacé par la -variable d'environnement <envar>ftp_proxy</envar>. Pour utiliser un mandataire ftp, -vous devez renseigner l'entrée <literal>ftp::ProxyLogin</literal> dans le fichier de -configuration. Cette entrée spécifie les commandes qui disent au serveur -mandataire comment se connecter. Voyez &configureindex; pour savoir -comment faire. Les variables de substitution disponibles sont : -<literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, -<literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal>, et <literal>$(SITE_PORT)</literal>. -Chacune correspond à un élément de l'URI. +URI FTP ; ftp::Proxy est le mandataire (proxy) FTP à utiliser par défaut. +Il se présente sous la forme standard : +<literal>ftp://[[user][:pass]@]host[:port]/</literal>. On peut spécifier un +mandataire particulier par hôte distant en utilisant la syntaxe : +<literal>ftp::Proxy::<hôte></literal>. Le mot-clé spécial +<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour +l'hôte. Lorsqu'elle est définie, la variable d'environnement +<envar>ftp_proxy</envar> annule et replace toutes les options de mandataire +FTP. Pour utiliser un mandataire FTP, vous devrez renseigner l'entrée +<literal>ftp::ProxyLogin</literal> dans le fichier de configuration. Cette +entrée spécifie les commandes à envoyer au mandataire pour lui préciser à quoi +il doit se connecter. Voyez &configureindex; pour savoir comment faire. Les +variables de substitution disponibles sont : +<literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, +<literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>, +<literal>$(SITE)</literal> et <literal>$(SITE_PORT)</literal>. Chacune +correspond à l'élément respectif de l'URI. </para> <para> -L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout) -utilisé par la méthode : cela vaut pour tout (connexion, données). +L'option <literal>timeout</literal> positionne le compteur de temps mort +(timeout) utilisé par la méthode. Cela vaut pour tout, connexion et données. </para> <para> Plusieurs options de configuration sont fournies pour contrôler le mode -passif. Généralement, c'est plus sûr d'activer le mode passif ; cela +passif. Il est généralement plus sûr d'activer le mode passif et cela marche dans presque tous les environnements. Cependant, certaines situations nécessitent que le mode passif soit désactivé et que le mode « port » de ftp @@ -293,16 +356,18 @@ connexions qui passent par un mandataire ou pour une machine spécifique (examinez le modèle de fichier de configuration). </para> <para> -On peut utiliser un mandataire FTP pour atteindre une cible HTTP en -positionnant la variable d'environnement <envar>ftp_proxy</envar> à une url http -- -consultez la méthode http ci-dessus pour la syntaxe. On ne peut pas fixer -cette variable dans le fichier de configuration et il n'est pas recommandé -d'utiliser HTTP par FTP à cause de son peu d'efficacité. +Il est possible de faire transiter le trafic FTP par un mandataire HTTP en +positionnant la variable d'environnement <envar>ftp_proxy</envar> à une URL +HTTP -- +consultez la méthode http ci-dessus pour la syntaxe. On ne peut pas le faire +dans le fichier de configuration et il n'est de toute façon pas recommandé +d'utiliser FTP au travers de HTTP en raison la faible efficacité de cette +méthode. </para> <para> L'option <literal>ForceExtended</literal> contrôle l'utilisation des commandes liées à la RFC 2428, <literal>EPSV</literal> et <literal>EPRT</literal>. Par défaut, elle vaut -« false » ; ce qui signifie que ces commandes ne sont +« false » ce qui signifie que ces commandes ne sont utilisées que pour une connexion de type IPv6. Quand elle vaut « true », on les utilise même si la connexion est de type IPv4. La plupart des serveurs FTP ne suivent pas la RFC 2428. @@ -311,7 +376,7 @@ plupart des serveurs FTP ne suivent pas la RFC 2428. <varlistentry><term>cdrom</term> <listitem><para> -URI CDROM ; la seule option de configuration pour les URI de CDROM +URI cédérom ; la seule option de configuration pour les URI de cédérom est le point de montage : <literal>cdrom::Mount</literal> ; il doit représenter le point de montage du lecteur de cédérom indiqué dans <filename>/etc/fstab</filename>. @@ -326,9 +391,9 @@ peuvent être spécifiées en utilisant <literal>UMount</literal>. <varlistentry><term>gpgv</term> <listitem><para> -URI GPGV ; la seule option pour les URI GPGV est celle qui permet de +URI GPGV ; la seule option pour les URI GPGV est celle qui permet de passer des paramètres à gpgv. - <literal>gpgv::Options</literal> Options supplémentaires passées à + <literal>gpgv::Options</literal> : options supplémentaires passées à gpgv. </para> </listitem> @@ -341,7 +406,8 @@ URI GPGV ; la seule option pour les URI GPGV est celle qui permet de <para> Les répertoires de la section <literal>Dir::State</literal> concernent le système local. <literal>lists</literal> est le répertoire où placer les listes de paquets -téléchargés et <literal>status</literal> est le nom du fichier d'état de Dpkg. +téléchargés et <literal>status</literal> est le nom du fichier d'état de +&dpkg;. <literal>preferences</literal> concerne APT : c'est le nom du fichier des préférences. <literal>Dir::State</literal> contient le répertoire par défaut préfixé à tous les @@ -353,8 +419,8 @@ ou <filename>./</filename>. cache local : par exemple, les deux caches de paquets <literal>srcpkgcache</literal> et <literal>pkgcache</literal>, et aussi l'endroit où sont placées les archives téléchargées, <literal>Dir::Cache::archives</literal>. On peut -empêcher la création des caches en laissant leur nom en blanc. Cela ralentit -le démarrage mais cela sauve de l'espace disque. Il vaut mieux se passer du +empêcher la création des caches en saisissant un nom vide. Cela ralentit +le démarrage mais sauve de l'espace disque. Il vaut mieux se passer du cache <literal>pkgcache</literal> plutôt que se passer du cache <literal>srcpkgcache</literal>. Comme pour <literal>Dir::State</literal>, le répertoire par défaut est contenu dans <literal>Dir::Cache</literal>. @@ -375,11 +441,22 @@ de configuration est chargé. Les programmes binaires sont pointés par <literal>Dir::Bin</literal>. L'emplacement des gestionnaires de méthodes est indiqué par <literal>Dir::Bin::Methods</literal> ; <literal>gzip</literal>, -<literal>Dpkg</literal>, <literal>apt-get</literal>, +<literal>dpkg</literal>, <literal>apt-get</literal>, <literal>dpkg-source</literal>, <literal>dpkg-buildpackage</literal> et <literal>apt-cache</literal> indiquent l'emplacement des programmes correspondants. - </para> + </para> +<para> +L'option de configuration <literal>RootDir</literal> a une signification +particulière. Lorsqu'elle est définie, tous les chemins déclarés dans +<literal>Dir::</literal> sont considérés relativement à +<literal>RootDir</literal>, <emphasis>même les chemins spécifiés de manière +absolue</emphasis>. Ainsi par exemple si <literal>RootDir</literal> est +défini comme <filename>/tmp/staging</filename>, et que chemin du fichier d'état +<literal>Dir::State::status</literal> est déclaré comme +<filename>/var/lib/dpkg/status</filename> alors ce fichier sera cherché +dans <filename>/tmp/staging/var/lib/dpkg/status</filename>. + </para> </refsect1> <refsect1><title>APT et DSelect</title> @@ -406,14 +483,14 @@ de nouveaux paquets. <varlistentry><term>Options</term> <listitem><para> -Le contenu de cette variable est passé à &apt-get; avec les options de la ligne -de commande quand ce programme est utilisé dans la phase d'installation. +Le contenu de cette variable est passé comme options de ligne de commande à +&apt-get; lors de la phase d'installation. </para></listitem> </varlistentry> <varlistentry><term>UpdateOptions</term> <listitem><para> -Le contenu de cette variable est passé à &apt-get; avec les options de la -ligne de commande quand ce programme est utilisé dans la phase de mise à jour. +Le contenu de cette variable est passé comme options de ligne de commande à +&apt-get; lors de la phase de mise à jour. </para></listitem> </varlistentry> @@ -427,7 +504,7 @@ qu'en cas d'erreur que l'on propose à l'utilisateur d'intervenir. </variablelist> </refsect1> -<refsect1><title>Comment APT appelle Dpkg</title> +<refsect1><title>Comment APT appelle &dpkg;</title> <para> Plusieurs directives de configuration contrôlent la manière dont APT invoque &dpkg; : elles figurent dans la section <literal>DPkg</literal>. @@ -435,8 +512,8 @@ invoque &dpkg; : elles figurent dans la section <literal>DPkg</literal>. <variablelist> <varlistentry><term>Options</term> <listitem><para> -Il s'agit d'une liste d'options à passer à dpkg. Les options doivent être -déclarées en utilisant la notation de liste et chaque élément de liste est +Il s'agit d'une liste d'options à passer à &dpkg;. Les options doivent être +déclarées en utilisant la notation de liste et chaque élément de la liste est passé comme un seul argument à &dpkg;. </para></listitem> </varlistentry> @@ -450,7 +527,7 @@ liste. Les commandes sont appelées dans l'ordre, en utilisant </varlistentry> <varlistentry><term>Pre-Install-Pkgs</term> <listitem><para> -Il s'agit d'une liste de commandes shell à exécuter avant d'appeler Dpkg. +Il s'agit d'une liste de commandes shell à exécuter avant d'appeler &dpkg;. Tout comme pour <literal>Options</literal>, on doit utiliser la notation de liste. Les commandes sont appelées dans l'ordre, en utilisant <filename>/bin/sh</filename> : APT s'arrête dès que l'une d'elles échoue. Sur @@ -467,7 +544,7 @@ commande passée à <literal>Pre-Install-Pkgs</literal>. </varlistentry> <varlistentry><term>Run-Directory</term> <listitem><para> -APT se place dans ce répertoire avant d'appeler Dpkg ; par défaut c'est +APT se place dans ce répertoire avant d'appeler &dpkg; ; par défaut c'est le répertoire <filename>/</filename>. </para></listitem> </varlistentry> @@ -481,25 +558,262 @@ créés. </variablelist> </refsect1> +<refsect1> +<title>Options « Periodic » et « Archive »</title> +<para> +Les groupes d'options <literal>APT::Periodic</literal> et +<literal>APT::Archive</literal> configurent les comportements périodiques +réalisés par le script <literal>/etc/cron.daily/apt</literal>, lancé +quotidiennement. + </para> +<variablelist> +<varlistentry><term>APT::Periodic</term> +<para>Les options de cette section permettent de configurer la fréquence +d'exécution des tâches APT lancées automatiquement. Ces paramètre prennent +comme valeurs des périodicités d'exécution en nombre de jours. + </para> +<listitem><para> +<literal>Update-Package-List</literal> : périodicité de mise à jour de la +liste des paquets disponibles. (0 = désactivé) + </para></listitem> +<listitem><para> +<literal>Download-Upgradable-Packages</literal> : périodicité de +téléchargement dans le cache des paquets pour lesquels une mise à jour est +disponible. (0 = désactivé) + </para></listitem> +<listitem><para> +<literal>AutocleanInterval</literal> : périodicité des +« autoclean », c'est à dire de la suppression du cache des paquets +qui ne peuvent plus être téléchargés. (0 = désactivé) + </para></listitem> +<listitem><para> +<literal>Unattended-Upgrade</literal> : périodicité de mise à jour +automatique du système sans intervention humaine. Le paquet +<literal>unattended-upgrades</literal> doit être installé pour que cette tâche +s'exécute. Le cas échéant un fichier journal est écrit dans +<literal>/var/log/unattended-upgrades</literal>. (0 = désactivé) + </para></listitem> +</varlistentry> +<varlistentry><term>APT::Archive</term> +<para>Les options de la section APT::Archive permettent de contrôler la taille +du cache de paquets. + </para> +<listitem><para> +<literal>MaxAge</literal> : ancienneté maximale d'un paquet dans le cache, +en nombre de jours. Les paquets plus anciens sont supprimés. (0 = désactivé) + </para></listitem> +<listitem><para> +<literal>MaxSize</literal> : taille maximale du cache en Mo. (0 = +désactive) Si ce maximum est dépassé, des paquets sont supprimés jusqu'à ce +que la taille du cache repasse sous la limite. Les paquets les plus volumineux +sont supprimés en premier. + </para></listitem> +<listitem><para> +<literal>MinAge</literal> : age minimum d'un paquet du cache, en nombre de +jours (0 = désactivé). Un paquet plus récent ne sera pas supprimé. Cette option +est utile pour garder à disposition une version des paquets en cas de problème +grave. + </para></listitem> +</varlistentry> +</variablelist> +</refsect1> + <refsect1><title>Les options de débogage</title> -<para> -La plupart des options de la section <literal>debug</literal> n'ont aucun intérêt -pour le simple utilisateur ; cependant, -<literal>Debug::pkgProblemResolver</literal> affiche d'intéressantes informations sur -les décisions que prend la commande dist-upgrade. <literal>Debug::NoLocking</literal> -désactive le verrouillage de fichier de manière à ce que APT puisse effectuer -quelques opérations sans être « root » et -<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande à chaque appel de -Dpkg. <literal>Debug::IdentCdrom</literal> désactive l'inclusion de -données de type statfs dans les ID de CDROM. -<literal>Debug::Acquire::gpgv</literal> Débogage de la méthode gpgv. - </para> +<para> +Les options de la section <literal>Debug::</literal> servent soit à provoquer +l'affichage d'informations de débogage sur la sortie d'erreur standard du +programme qui utilise les librairies APT, soit à activer des modes de +fonctionnement spéciaux qui sont principalement utiles pour déboguer le +comportement de <literal>APT</literal>. La plupart de ces options n'ont pas +d'intérêt pour un utilisateur normal, mais certaines peuvent tout de même être +utiles : + </para> +<itemizedlist> +<listitem><para> +<literal>Debug::pkgProblemResolver</literal> affiche d'intéressantes +informations sur les décisions prises par les commandes <literal>dist-upgrade, +upgrade, install, remove et purge</literal>. + </para></listitem> +<listitem><para> +<literal>Debug::NoLocking</literal> désactive le verrouillage de fichier de +manière à ce que APT puisse effectuer quelques opérations (telles que +<literal>apt-get -s install</literal>) sans être « root ». + </para></listitem> +<listitem><para> +<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande à chaque appel +de &dpkg;. + </para></listitem> +<listitem><para> +<literal>Debug::IdentCdrom</literal> désactive l'inclusion de données de type +statfs dans les ID de cédérom. + </para></listitem> +</itemizedlist> + +<para>Voici une liste complète des options de débogage de APT.</para> +<variablelist> +<varlistentry><term>Debug::Acquire::cdrom</term> +<listitem><para> +Affiche les informations concernant les sources de type cdrom:// + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::Acquire::ftp</term> +<listitem><para> +Affiche les informations concernant le téléchargement de paquets par FTP. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::Acquire::http</term> +<listitem><para> +Affiche les informations concernant le téléchargement de paquets par HTTP. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::Acquire::https</term> +<listitem><para> +Affiche les informations concernant le téléchargement de paquets par HTTPS. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::Acquire::gpgv</term> +<listitem><para> +Affiche les informations relatives à la vérification de signatures +cryptographiques avec <literal>gpg</literal>. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::aptcdrom</term> +<listitem><para> +Affiche des informations concernant l'accès aux collections de paquets +stockées sur cédérom. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::BuildDeps</term> +<listitem><para> +Décrit le processus de résolution des dépendances pour la construction de +paquets source ( « build-dependencies » ) par &apt-get;. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::Hashes</term> +<listitem><para> +Affiche toutes les clefs de hachage cryptographiques générées par les +librairies APT. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::IdentCdrom</term> +<listitem><para>Désactive l'inclusion des données de type +<literal>statfs</literal> pour la génération des ID de cédérom, à savoir le +nombre de blocs libres et utilisés sur le système de fichier du cédérom. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::NoLocking</term> +<listitem><para> +Désactive le verrouillage de fichiers. Cela permet par exemple de lancer deux +instances de « apt-get update » en même temps. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgAcquire</term> +<listitem><para> +Trace les ajouts et suppressions d'éléments de la queue globale de +téléchargement. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgAcquire::Auth</term> +<listitem><para> +Affiche les détails de la vérification des sommes de contrôle et des signatures +cryptographiques des fichiers téléchargés, ainsi que les erreurs éventuelles. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgAcquire::Diffs</term> +<listitem><para> +Affiche les informations de téléchargement et de prise en compte des fichiers +différentiels des indexes de paquets, ainsi que les erreurs éventuelles. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgAcquire::RRed</term> +<listitem><para> +Affiche les détails de la vérification des sommes de contrôle et des signatures +cryptographiques des fichiers téléchargés, ainsi que les erreurs éventuelles. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgAcquire::Worker</term> +<listitem><para> +Affiche toutes les interactions avec les processus enfants qui se chargent +effectivement des téléchargements. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgAcquire::pkgAutoRemove</term> +<listitem><para> +Affiche les changements concernant le marquage des paquets comme installés +automatiquement, et la suppression des paquets inutiles. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgDepCache::AutoInstall</term> +<listitem><para> +Génère les informations de débogage décrivant quels paquets sont installés +automatiquement pour satisfaire les dépendances. Cela concerne la passe +initiale d'installation automatique effectuée par exemple par +<literal>apt-get install</literal> et pas le système de résolution de +dépendances complet de APT ; voir +<literal>Debug::pkgProblemResolver</literal> pour ce dernier. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgInitConfig</term> +<listitem><para> +Au lancement, affiche l'ensemble de la configuration sur la sortie d'erreur +standard. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgDPkgPM</term> +<listitem><para> +Affiche la commande exacte d'invocation de &dpkg; à chaque appel ; les +arguments sont séparés par des espaces. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgDPkgProgressReporting</term> +<listitem><para> Affiche l'ensemble des informations reçues de &dpkg; par +l'intermédiaire du descripteur de fichier d'état, et les éventuelles erreurs +d'analyse de ce fichier. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgOrderList</term> +<listitem><para> +Affiche les étapes de l'algorithme utilisé pour choisir l'ordre dans lequel APT +passe les paquets à &dpkg;. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgPackageManager</term> +<listitem><para> +Affiche le détail des opérations liées à l'invocation de &dpkg;. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgPolicy</term> +<listitem><para> +Au lancement, affiche la priorité de chaque liste de paquets. + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::pkgProblemResolver</term> +<listitem><para> +Affiche la trace d'exécution du système de résolution de dépendances (ne +concerne que les cas où un problème de dépendances complexe se présente). + </para></listitem> +</varlistentry> +<varlistentry><term>Debug::sourceList</term> +<listitem><para> +Affiche les fournisseurs déclarés dans le fichier +<filename>/etc/apt/vendors.list</filename>. + </para></listitem> +</varlistentry> +<!-- 2009/07/11 Utilisé nulle part actuellement, le code est commenté. +<varlistentry><term>Debug::Vendor</term> +<listitem><para> +Affiche les informations sur la recherche de fournisseurs. + </para></listitem> +</varlistentry> +--> +</variablelist> + </refsect1> <refsect1><title>Exemples</title> <para> -Le fichier &configureindex; contient un modèle de fichier montrant les valeurs par -défaut de toutes les options possibles. +Le fichier &configureindex; contient un modèle de fichier montrant des exemples +pour toutes les options existantes. </para> </refsect1> @@ -514,4 +828,4 @@ défaut de toutes les options possibles. &manbugs; &deux-traducteurs; -</refentry>
\ No newline at end of file +</refentry> diff --git a/doc/pt_BR/.cvsignore b/doc/pt_BR/.cvsignore deleted file mode 100644 index 8d11bcc88..000000000 --- a/doc/pt_BR/.cvsignore +++ /dev/null @@ -1,3 +0,0 @@ -apt_preferences.pt_BR.5 -manpage.links -manpage.refs |