diff options
author | bubulle@debian.org <> | 2009-07-17 20:08:54 +0200 |
---|---|---|
committer | bubulle@debian.org <> | 2009-07-17 20:08:54 +0200 |
commit | 7b139dabdcdff68a2854405e55924559591df8d0 (patch) | |
tree | 84ff8655d6ce4c723a387dfc15800923f56e9d4d /doc/fr | |
parent | 04f4e1a3b110ef5ff8870816169f8f0b9eb23dce (diff) |
Update French manpage translation
Diffstat (limited to 'doc/fr')
-rw-r--r-- | doc/fr/apt.conf.fr.5.xml | 534 |
1 files changed, 424 insertions, 110 deletions
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> |