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