Bonjour à tous, en parcourant la page de manuel de apt.conf, je me suis rendu compte qu'elle était assez datée, et je l'ai mis à jour en suivant la version anglaise actuelle de sid (apt 0.7.21). Le diff étant assez volumineux je joins aussi le fichier mis à jour pour faciliter la relecture. Par rapport à la version anglaise, j'ai rajouté de la doc sur les sections APT::Periodic et APT::Archive qui sont décrites en anglais dans l'en-tête de /etc/cron.daily/apt. Le fichier est encodé en iso-8859-15, serait-ce une bonne idée de le passer en utf-8 ? @+ Aurélien
--- apt.conf.fr.5.xml-initial 2009-07-07 00:36:08.000000000 +0200
+++ apt.conf.fr.5.xml 2009-07-11 20:07:30.000000000 +0200
@@ -15,7 +15,7 @@
&apt-email;
&apt-product;
<!-- The last update date -->
- <date>29 F�ier 2004</date>
+ <date>11 juillet 2008</date>
</refentryinfo>
<refmeta>
@@ -33,26 +33,30 @@
de la collection d'outils que constitue APT ; tous les outils font appel �e
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�rre, il lit (si elle existe) la variable d'environnement
-<envar>APT_CONFIG</envar> ; puis il lit les fichiers situ�dans
+d'APT d�rre, il lit la configuration d�gn�par variable d'environnement
+<envar>APT_CONFIG</envar> (si elle existe), puis il lit les fichiers situ�dans
<literal>Dir::Etc::Parts</literal> ainsi que le principal fichier de configuration
indiqu�ar <literal>Dir::Etc::main</literal> ; enfin il applique les options de
-la ligne de commande qui annulent les directives de configuration, chargeant,
-si n�ssaire, d'autres fichiers de configuration.
+la ligne de commande qui pr�lent sur les directives de configuration, chargeant
+si n�ssaire d'autres fichiers de configuration.
</para>
<para>
Le fichier de configuration est construit comme un arbre d'options
organis� 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��'outil Get. Les options
-n'h�tent pas des groupes de leurs parents.
+une option pour le groupe d'outils APT, destin��'outil Get. Il n'y a pas d'h�tage
+des options des groupes parents.
</para>
<para>
Syntaxiquement, le langage de configuration est con�sur le m� mod�
que les langages utilis�par des outils ISC tels que bind et dhcp. Une ligne
-qui commence par <literal>//</literal> est un commentaire et elle est ignor�
+qui commence par <literal>//</literal> est trait�comme un commentaire et ignor� de
+m� que les sections de texte plac� 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�arer un nouveau champ d'action avec des accolades, comme
suit :
@@ -68,10 +72,9 @@
</programlisting></informalexample>
<para>
-avec des retours �a ligne pour faciliter la lecture. On peut cr� 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�,
-s�r� par un point-virgule.
+avec des retours �a ligne pour faciliter la lecture. On peut cr� une liste
+en ouvrant un champ d'action et en y ins�nt une cha� entre guillemets suivie
+d'un point virgule pour chaque �ment de la liste.
</para>
<informalexample><programlisting>
@@ -79,14 +82,21 @@
</programlisting></informalexample>
<para>
-Les mod�s <filename>&docdir;examples/apt.conf</filename> &configureindex;
+Les mod�s <filename>&docdir;examples/apt.conf</filename> et &configureindex;
montrent �uoi devrait ressembler le fichier de configuration.
</para>
<para>
+Les identifiants des options de configuration ne sont pas sensibles �a casse.
+Dans l'exemple pr�dent, on pourrait donc aussi bien utiliser
+<literal>dpkg::pre-install-pkgs</literal>.
+ </para>
+<para>
Deux �ments sp�aux sont autoris�nbsp;: <literal>#include</literal> et
-<literal>#clear</literal>. <literal>#include</literal> inclut le fichier donn�n argument,
-�oins 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�n
+argument, �oins que le nom ne se termine par une barre oblique auquel cas le
+r�rtoire entier est inclus. <literal>#clear</literal> sert �+effacer une partie de l'arbre de configuration. L'�ment d�gn�t tout ses
+descendants sont supprim�
</para>
<para>
Tous les outils d'APT poss�nt une option <option>-o</option> qui permet de
@@ -95,20 +105,31 @@
<literal>APT::Get::Assume-Yes</literal>) suivi par un signe �l, puis par la nouvelle
valeur de l'option. On peut compl�r 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�aussi bien le comportement global d'APT que
-la prise en compte des options pour chaque outil.
+<para>
+Ce groupe d'options contr�le comportement global d'APT et contient �lement
+des options communes �ous les outils.
</para>
<variablelist>
<varlistentry><term>Architecture</term>
<listitem><para>
L'architecture du syst� ; cette option positionne l'architecture �tiliser
-pour r�p�r des fichiers et analyser des listes de paquets. L'architecture
-interne par d�ut est celle pour laquelle APT a � compil�+pour r�p�r des fichiers et analyser des listes de paquets. La valeur interne par
+d�ut est l'architecture pour laquelle APT a � compil�+ </para></listitem>
+</varlistentry>
+
+<varlistentry><term>Default-Release</term>
+<listitem><para>
+Indique la distribution �tiliser par d�ut lors de l'installation d'un
+paquet si plusieurs versions sont disponibles. La valeur peut �e un nom de
+distribution ou un num� 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 @@
<varlistentry><term>Clean-Installed</term>
<listitem><para>
Avec cette option qui est activ�par d�ut, la fonctionnalit� autoclean �
-supprime tout paquet qui ne peut plus �e r�p� dans le cache.
+supprime du cache tout paquet qui ne peut plus �e r�p�.
Quand cette option est d�ctiv� les paquets qui sont install�localement
sont aussi exclus du nettoyage - mais notez que APT ne fournit aucun moyen
direct pour les r�staller.
@@ -134,9 +155,9 @@
<listitem><para>
D�ctive la configuration imm�ate ; cette dangereuse option d�ctive
une partie du code de mise en ordre de APT pour que ce dernier effectue le
-moins d'appels possible �pkg. C'est peut-�e n�ssaire sur des syst�s
-lents �n seul utilisateur mais c'est extr�ment dangereux et cela peut
-faire �ouer les scripts d'installation, voire pire.
+moins d'appels possible �dpkg;. � peut �e n�ssaire sur des syst�s
+�n seul utilisateur extr�ment lents, mais cette option est tr�dangereuse et
+peut faire �ouer les scripts d'installation, voire pire.
Utilisez-la �os risques et p�ls.
</para></listitem>
</varlistentry>
@@ -155,39 +176,37 @@
<varlistentry><term>Cache-Limit</term>
<listitem><para>
-APT utilise un fichier cache d'une taille m�ire fixe pour ranger les
-informations du fichier � available �. Cette option fixe la taille
-de ce cache.
+APT utilise un fichier de cache charg�n m�ire avec &mmap; pour ranger les
+informations sur les paquets disponibles. Cette option fixe la taille m�ire
+allou�pour le chargement de ce cache.
</para></listitem>
</varlistentry>
<varlistentry><term>Build-Essential</term>
<listitem><para>
Cette option d�nit les paquets qui sont consid�s comme faisant partie
-des d�ndances essentielles pour la construction des paquets.
+des d�ndances essentielles pour la construction de paquets.
</para></listitem>
</varlistentry>
<varlistentry><term>Get</term>
<listitem><para>La sous-section <literal>Get</literal> contr�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�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�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�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�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 @@
les gestionnaires d'URI.
<variablelist>
+<varlistentry><term>PDiffs</term>
+<listitem><para>Essayer de t�charger les fichiers diff�ntiels appel�+<literal>PDiffs</literal> pour les paquets ou les fichiers sources, plut�ue
+de les t�charger enti�ment. Par d�ut � 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�rmine comment APT
-parall�se les connexions sortantes. <literal>Host</literal> signifie qu'une
-connexion par cible sera initi� tandis que <literal>access</literal> signifie qu'une
-connexion par type d'URI sera initi�
+Le mode de file d'attente ; <literal>Queue-Mode</literal> peut prendre les
+valeurs <literal>host</literal> ou <literal>access</literal> et cela d�rmine
+comment APT parall�se les connexions sortantes. <literal>Host</literal> signifie
+qu'une connexion par cible sera initi� tandis que <literal>access</literal> signifie
+qu'une connexion par type d'URI sera initi�
</para></listitem>
</varlistentry>
@@ -227,30 +253,32 @@
<varlistentry><term>http</term>
<listitem><para>
-URI HTTP ; http::Proxy est le mandataire (proxy) http �tiliser par d�ut.
+URI HTTP ; http::Proxy est le mandataire (proxy) HTTP �tiliser par d�ut.
Il se pr�nte sous la forme standard :
-<literal>http://[[user][:pass]@]host[:port]/</literal>. En utilisant la syntaxe :
-<literal>http::Proxy::<host></literal>, o�mot-cl�p�al <literal>DIRECT</literal>
-indique de n'utiliser aucun mandataire, on peut sp�fier un mandataire
-pour chaque machine distante. La variable d'environnement <envar>http_proxy</envar>
-remplace tous ces param�es.
+<literal>http://[[user][:pass]@]host[:port]/</literal>. On peut sp�fier un
+mandataire particulier par h�distant en utilisant la syntaxe :
+<literal>http::Proxy::<h�gt;</literal>. Le mot-cl�p�al
+<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour
+l'h�
+Lorsqu'elle est d�nie, 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�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�nses qu'il a stock� ; <literal>Max-Age</literal>
+Trois options de configuration sont fournies pour le contr�des caches compatibles
+avec HTTP/1.1. <literal>No-Cache</literal> signifie que le mandataire ne doit jamais
+utiliser les r�nses qu'il a stock� ; <literal>Max-Age</literal>
sert uniquement pour les fichiers d'index : cela demande au cache de les
mettre �our quand leur anciennet�st sup�eure au nombre de secondes
-donn�Debian met �our son fichier d'index de mani� journali�, la
+donn�Debian met �our ses fichiers d'index de mani� quotidienne ; la
valeur par d�ut 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�. Cela peut �ter de polluer un cache mandataire avec des
fichiers .deb tr�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�ar la m�ode : cela vaut pour tout (connexion, donn�).
+utilis�ar la m�ode. Cela vaut pour tout, connexion et donn�.
</para>
<para>
Une option de configuration est fournie pour contr� la profondeur du tube
@@ -264,27 +292,62 @@
</para></listitem>
</varlistentry>
+<varlistentry><term>https</term>
+<listitem><para>
+URI HTTPS. Les options de contr�de cache et de mandataire (proxy) sont les
+m�s que pour la m�ode <literal>http</literal>. L'option
+<literal>Pipeline-Depth</literal> n'est pas encore support�
+ </para>
+
+<para>La sous-option <literal>CaInfo</literal> sp�fie le fichier contenant
+les informations sur les certificats de confiance.
+La sous-option bool�ne <literal>Verify-Peer</literal> pr�se si le
+certificat d'h�du serveur doit �e confront�ux certificats de confiance
+ou pas. La sous-option bool�ne <literal>Verify-Host</literal> pr�se s'il
+faut v�fier ou pas le nom d'h�du serveur. <literal>SslCert</literal>
+d�rmine le certificat �tiliser pour l'authentification du client.
+<literal>SslKey</literal> d�rmine quelle clef priv�doit �e utilis�pour
+l'authentification du client. <literal>SslForceVersion</literal> surcharge la
+valeur par d�ut pour la version de SSL �tiliser et peut contenir l'une des
+cha�s 'TLSv1' ou 'SSLv3'.
+ </para>
+<para>Chacune de ces options peut �e sp�fi�pour un h�particulier en
+utilisant <literal><h�gt;::CaInfo</literal>,
+<literal><h�gt;::Verify-Peer</literal>,
+<literal><h�gt;::Verify-Host</literal>,
+<literal><h�gt;::SslCert</literal>,
+<literal><h�gt;::SslKey</literal> et
+<literal><h�gt;::SslForceVersion</literal> respectivement.
+ </para></listitem>
+</varlistentry>
+
<varlistentry><term>ftp</term>
<listitem><para>
-URI FTP ; ftp::Proxy est le serveur mandataire par d�ut �tiliser. Il se
-pr�nte sous la forme standard :
-<literal>ftp://[[user][:pass]@]host[:port]/</literal> ; il est remplac�ar la
-variable d'environnement <envar>ftp_proxy</envar>. Pour utiliser un mandataire ftp,
-vous devez renseigner l'entr�<literal>ftp::ProxyLogin</literal> dans le fichier de
-configuration. Cette entr�sp�fie 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 �n �ment de l'URI.
+URI FTP ; ftp::Proxy est le mandataire (proxy) FTP �tiliser par d�ut.
+Il se pr�nte sous la forme standard :
+<literal>ftp://[[user][:pass]@]host[:port]/</literal>. On peut sp�fier un
+mandataire particulier par h�distant en utilisant la syntaxe :
+<literal>ftp::Proxy::<h�gt;</literal>. Le mot-cl�p�al
+<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour
+l'h� Lorsqu'elle est d�nie, 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�+<literal>ftp::ProxyLogin</literal> dans le fichier de configuration. Cette
+entr�sp�fie les commandes �nvoyer au mandataire pour lui pr�ser �uoi
+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 �'�ment respectif de l'URI.
</para>
<para>
-L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout)
-utilis�ar la m�ode : cela vaut pour tout (connexion, donn�).
+L'option <literal>timeout</literal> positionne le compteur de temps mort
+(timeout) utilis�ar la m�ode. Cela vaut pour tout, connexion et donn�.
</para>
<para>
Plusieurs options de configuration sont fournies pour contr� le mode
-passif. G�ralement, c'est plus s�activer le mode passif ; cela
+passif. Il est g�ralement plus s�activer le mode passif et cela
marche dans presque tous les environnements. Cependant, certaines situations
n�ssitent que le mode passif soit d�ctiv�t que le mode
� port � de ftp
@@ -293,16 +356,18 @@
sp�fique (examinez le mod� 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> �ne url http --
-consultez la m�ode 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 �ause 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> �ne URL
+HTTP --
+consultez la m�ode http ci-dessus pour la syntaxe. On ne peut pas le faire
+dans le fichier de configuration et il n'est de toute fa� pas recommand�d'utiliser FTP au travers de HTTP en raison la faible efficacit�e cette
+m�ode.
</para>
<para>
L'option <literal>ForceExtended</literal> contr�l'utilisation des commandes li�
�a RFC 2428, <literal>EPSV</literal> et <literal>EPRT</literal>. Par d�ut, elle vaut
-� false � ; ce qui signifie que ces commandes ne sont
+� false � ce qui signifie que ces commandes ne sont
utilis� que pour une connexion de type IPv6. Quand elle vaut
� true �, on les utilise m� si la connexion est de type IPv4. La
plupart des serveurs FTP ne suivent pas la RFC 2428.
@@ -311,7 +376,7 @@
<varlistentry><term>cdrom</term>
<listitem><para>
-URI CDROM ; la seule option de configuration pour les URI de CDROM
+URI c�rom ; la seule option de configuration pour les URI de c�rom
est le point de montage : <literal>cdrom::Mount</literal> ; il doit
repr�nter le point de montage du lecteur de c�rom indiqu�ans
<filename>/etc/fstab</filename>.
@@ -326,9 +391,9 @@
<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�es �pgv.
- <literal>gpgv::Options</literal> Options suppl�ntaires pass� � <literal>gpgv::Options</literal> : options suppl�ntaires pass� � gpgv.
</para>
</listitem>
@@ -341,7 +406,8 @@
<para>
Les r�rtoires de la section <literal>Dir::State</literal> concernent le syst�
local. <literal>lists</literal> est le r�rtoire o�cer les listes de paquets
-t�charg�et <literal>status</literal> est le nom du fichier d'�t de Dpkg.
+t�charg�et <literal>status</literal> est le nom du fichier d'�t de
+&dpkg;.
<literal>preferences</literal> concerne APT : c'est le nom du fichier des
pr�rences.
<literal>Dir::State</literal> contient le r�rtoire par d�ut pr�x� tous les
@@ -353,8 +419,8 @@
cache local : par exemple, les deux caches de paquets
<literal>srcpkgcache</literal> et <literal>pkgcache</literal>, et aussi l'endroit o�t
plac� les archives t�charg�, <literal>Dir::Cache::archives</literal>. On peut
-emp�er la cr�ion des caches en laissant leur nom en blanc. Cela ralentit
-le d�rrage mais cela sauve de l'espace disque. Il vaut mieux se passer du
+emp�er la cr�ion des caches en saisissant un nom vide. Cela ralentit
+le d�rrage mais sauve de l'espace disque. Il vaut mieux se passer du
cache <literal>pkgcache</literal> plut�ue se passer du cache <literal>srcpkgcache</literal>.
Comme pour <literal>Dir::State</literal>, le r�rtoire par d�ut est contenu dans
<literal>Dir::Cache</literal>.
@@ -375,11 +441,22 @@
Les programmes binaires sont point�par <literal>Dir::Bin</literal>.
L'emplacement des gestionnaires de m�odes est indiqu�ar
<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�. Lorsqu'elle est d�nie, tous les chemins d�ar�dans
+<literal>Dir::</literal> sont consid�s relativement �<literal>RootDir</literal>, <emphasis>m� les chemins sp�fi�de mani�
+absolue</emphasis>. Ainsi par exemple si <literal>RootDir</literal> est
+d�ni comme <filename>/tmp/staging</filename>, et que chemin du fichier d'�t
+<literal>Dir::State::status</literal> est d�ar�omme
+<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 @@
<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�ans la phase d'installation.
+Le contenu de cette variable est pass�omme 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�ans la phase de mise �our.
+Le contenu de cette variable est pass�omme options de ligne de commande �&apt-get; lors de la phase de mise �our.
</para></listitem>
</varlistentry>
@@ -427,7 +504,7 @@
</variablelist>
</refsect1>
-<refsect1><title>Comment APT appelle Dpkg</title>
+<refsect1><title>Comment APT appelle &dpkg;</title>
<para>
Plusieurs directives de configuration contr�t la mani� dont APT
invoque &dpkg; : elles figurent dans la section <literal>DPkg</literal>.
@@ -435,8 +512,8 @@
<variablelist>
<varlistentry><term>Options</term>
<listitem><para>
-Il s'agit d'une liste d'options �asser �pkg. Les options doivent �e
-d�ar� en utilisant la notation de liste et chaque �ment de liste est
+Il s'agit d'une liste d'options �asser �dpkg;. Les options doivent �e
+d�ar� en utilisant la notation de liste et chaque �ment de la liste est
pass�omme un seul argument �dpkg;.
</para></listitem>
</varlistentry>
@@ -450,7 +527,7 @@
</varlistentry>
<varlistentry><term>Pre-Install-Pkgs</term>
<listitem><para>
-Il s'agit d'une liste de commandes shell �x�ter avant d'appeler Dpkg.
+Il s'agit d'une liste de commandes shell �x�ter avant d'appeler &dpkg;.
Tout comme pour <literal>Options</literal>, on doit utiliser la notation de liste.
Les commandes sont appel� dans l'ordre, en utilisant
<filename>/bin/sh</filename> : APT s'arr� d�que l'une d'elles �oue. Sur
@@ -467,7 +544,7 @@
</varlistentry>
<varlistentry><term>Run-Directory</term>
<listitem><para>
-APT se place dans ce r�rtoire avant d'appeler Dpkg ; par d�ut c'est
+APT se place dans ce r�rtoire avant d'appeler &dpkg; ; par d�ut c'est
le r�rtoire <filename>/</filename>.
</para></listitem>
</varlistentry>
@@ -481,25 +558,262 @@
</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�odiques
+r�is�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�ence
+d'ex�tion des t�es APT lanc� automatiquement. Ces param�e prennent
+comme valeurs des p�odicit�d'ex�tion en nombre de jours.
+ </para>
+<listitem><para>
+<literal>Update-Package-List</literal> : p�odicit�e mise �our de la
+liste des paquets disponibles. (0 = d�ctiv�+ </para></listitem>
+<listitem><para>
+<literal>Download-Upgradable-Packages</literal> : p�odicit�e
+t�chargement dans le cache des paquets pour lesquels une mise �our est
+disponible. (0 = d�ctiv�+ </para></listitem>
+<listitem><para>
+<literal>AutocleanInterval</literal> : p�odicit�es
+� autoclean �, c'est �ire de la suppression du cache des paquets
+qui ne peuvent plus �e t�charg� (0 = d�ctiv�+ </para></listitem>
+<listitem><para>
+<literal>Unattended-Upgrade</literal> : p�odicit�e mise �our
+automatique du syst� sans intervention humaine. Le paquet
+<literal>unattended-upgrades</literal> doit �e install�our que cette t�e
+s'ex�te. Le cas ��t un fichier journal est �it dans
+<literal>/var/log/unattended-upgrades</literal>. (0 = d�ctiv�+ </para></listitem>
+</varlistentry>
+<varlistentry><term>APT::Archive</term>
+<para>Les options de la section APT::Archive permettent de contr� la taille
+du cache de paquets.
+ </para>
+<listitem><para>
+<literal>MaxAge</literal> : anciennet�aximale d'un paquet dans le cache,
+en nombre de jours. Les paquets plus anciens sont supprim� (0 = d�ctiv�+ </para></listitem>
+<listitem><para>
+<literal>MaxSize</literal> : taille maximale du cache en Mo. (0 =
+d�ctive) Si ce maximum est d�ss�des paquets sont supprim�jusqu'�e
+que la taille du cache repasse sous la limite. Les paquets les plus volumineux
+sont supprim�en premier.
+ </para></listitem>
+<listitem><para>
+<literal>MinAge</literal> : age minimum d'un paquet du cache, en nombre de
+jours (0 = d�ctiv� Un paquet plus r�nt ne sera pas supprim�Cette option
+est utile pour garder �isposition une version des paquets en cas de probl�
+grave.
+ </para></listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+
<refsect1><title>Les options de d�gage</title>
-<para>
-La plupart des options de la section <literal>debug</literal> n'ont aucun int�t
-pour le simple utilisateur ; cependant,
-<literal>Debug::pkgProblemResolver</literal> affiche d'int�ssantes informations sur
-les d�sions que prend la commande dist-upgrade. <literal>Debug::NoLocking</literal>
-d�ctive le verrouillage de fichier de mani� �e que APT puisse effectuer
-quelques op�tions sans �e � root � et
-<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande �haque appel de
-Dpkg. <literal>Debug::IdentCdrom</literal> d�ctive l'inclusion de
-donn� de type statfs dans les ID de CDROM.
-<literal>Debug::Acquire::gpgv</literal> D�gage de la m�ode gpgv.
- </para>
+<para>
+Les options de la section <literal>Debug::</literal> servent soit �rovoquer
+l'affichage d'informations de d�gage sur la sortie d'erreur standard du
+programme qui utilise les librairies APT, soit �ctiver des modes de
+fonctionnement sp�aux qui sont principalement utiles pour d�guer le
+comportement de <literal>APT</literal>. La plupart de ces options n'ont pas
+d'int�t pour un utilisateur normal, mais certaines peuvent tout de m� �e
+utiles :
+ </para>
+<itemizedlist>
+<listitem><para>
+<literal>Debug::pkgProblemResolver</literal> affiche d'int�ssantes
+informations sur les d�sions prises par les commandes <literal>dist-upgrade,
+upgrade, install, remove et purge</literal>.
+ </para></listitem>
+<listitem><para>
+<literal>Debug::NoLocking</literal> d�ctive le verrouillage de fichier de
+mani� �e que APT puisse effectuer quelques op�tions (telles que
+<literal>apt-get -s install</literal>) sans �e � root �.
+ </para></listitem>
+<listitem><para>
+<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande �haque appel
+de &dpkg;.
+ </para></listitem>
+<listitem><para>
+<literal>Debug::IdentCdrom</literal> d�ctive l'inclusion de donn� de type
+statfs dans les ID de c�rom.
+ </para></listitem>
+</itemizedlist>
+
+<para>Voici une liste compl� des options de d�gage 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�chargement de paquets par FTP.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Acquire::http</term>
+<listitem><para>
+Affiche les informations concernant le t�chargement de paquets par HTTP.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Acquire::https</term>
+<listitem><para>
+Affiche les informations concernant le t�chargement de paquets par HTTPS.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Acquire::gpgv</term>
+<listitem><para>
+Affiche les informations relatives �a v�fication de signatures
+cryptographiques avec <literal>gpg</literal>.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::aptcdrom</term>
+<listitem><para>
+Affiche des informations concernant l'acc�aux collections de paquets
+stock� sur c�rom.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::BuildDeps</term>
+<listitem><para>
+D�it le processus de r�lution des d�ndances 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�r� par les
+librairies APT.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::IdentCdrom</term>
+<listitem><para>D�ctive l'inclusion des donn� de type
+<literal>statfs</literal> pour la g�ration des ID de c�rom, �avoir le
+nombre de blocs libres et utilis�sur le syst� de fichier du c�rom.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::NoLocking</term>
+<listitem><para>
+D�ctive le verrouillage de fichiers. Cela permet par exemple de lancer deux
+instances de � apt-get update � en m� temps.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire</term>
+<listitem><para>
+Trace les ajouts et suppressions d'�ments de la queue globale de
+t�chargement.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::Auth</term>
+<listitem><para>
+Affiche les d�ils de la v�fication des sommes de contr�et des signatures
+cryptographiques des fichiers t�charg� ainsi que les erreurs �ntuelles.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::Diffs</term>
+<listitem><para>
+Affiche les informations de t�chargement et de prise en compte des fichiers
+diff�ntiels des indexes de paquets, ainsi que les erreurs �ntuelles.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::RRed</term>
+<listitem><para>
+Affiche les d�ils de la v�fication des sommes de contr�et des signatures
+cryptographiques des fichiers t�charg� ainsi que les erreurs �ntuelles.
+ </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�chargements.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::pkgAutoRemove</term>
+<listitem><para>
+Affiche les changements concernant le marquage des paquets comme install�+automatiquement, et la suppression des paquets inutiles.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgDepCache::AutoInstall</term>
+<listitem><para>
+G�re les informations de d�gage d�ivant quels paquets sont install�+automatiquement pour satisfaire les d�ndances. Cela concerne la passe
+initiale d'installation automatique effectu�par exemple par
+<literal>apt-get install</literal> et pas le syst� de r�lution de
+d�ndances 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; �haque appel ; les
+arguments sont s�r�par des espaces.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgDPkgProgressReporting</term>
+<listitem><para> Affiche l'ensemble des informations re�s de &dpkg; par
+l'interm�aire du descripteur de fichier d'�t, et les �ntuelles erreurs
+d'analyse de ce fichier.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgOrderList</term>
+<listitem><para>
+Affiche les �pes de l'algorithme utilis�our choisir l'ordre dans lequel APT
+passe les paquets �dpkg;.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgPackageManager</term>
+<listitem><para>
+Affiche le d�il des op�tions li� �'invocation de &dpkg;.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgPolicy</term>
+<listitem><para>
+Au lancement, affiche la priorit�e chaque liste de paquets.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgProblemResolver</term>
+<listitem><para>
+Affiche la trace d'ex�tion du syst� de r�lution de d�ndances (ne
+concerne que les cas o�probl� de d�ndances complexe se pr�nte).
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::sourceList</term>
+<listitem><para>
+Affiche les fournisseurs d�ar�dans le fichier
+<filename>/etc/apt/vendors.list</filename>.
+ </para></listitem>
+</varlistentry>
+<!-- 2009/07/11 Utilis�ulle 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� de fichier montrant les valeurs par
-d�ut de toutes les options possibles.
+Le fichier &configureindex; contient un mod� de fichier montrant des exemples
+pour toutes les options existantes.
</para>
</refsect1>
@@ -514,4 +828,4 @@
&manbugs;
&deux-traducteurs;
-</refentry>
\ Pas de fin de ligne à la fin du fichier.
+</refentry>
Attachment:
apt.conf.fr.5.xml
Description: XML document