<?xml version="1.0" encoding="iso-8859-15" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!ENTITY % aptent SYSTEM "apt.ent.fr">
%aptent;

]>

<refentry lang="fr">

 <refentryinfo>
   &apt-author.jgunthorpe;
   &apt-author.team;
   &apt-email;
   &apt-product;
   <!-- The last update date -->
   <date>11 juillet 2008</date>
 </refentryinfo>

<refmeta>
<refentrytitle>apt.conf</refentrytitle>
<manvolnum>5</manvolnum>
</refmeta>

<refnamediv><refname>apt.conf</refname>
<refpurpose>Fichier de configuration pour APT</refpurpose>
</refnamediv>

<refsect1><title>Description</title>
<para>   
Le fichier <filename>apt.conf</filename> est le principal fichier de configuration 
de la collection d'outils que constitue APT&nbsp;; 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 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>&nbsp;; enfin il applique les options de 
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 (�&nbsp;::&nbsp;�) 
pour indiquer une option&nbsp;; par exemple, <literal>APT::Get::Assume-Yes</literal> est
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 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&nbsp;:
<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&nbsp;:
</para>

<informalexample><programlisting>   
APT {
  Get {
    Assume-Yes "true";
    Fix-Broken "true";
  };
};
</programlisting></informalexample>

<para>
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>   
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</programlisting></informalexample>

<para>
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&nbsp;: <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 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 
sp�cifier une configuration arbitraire depuis la ligne de commande. La 
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 �&nbsp;::&nbsp;� au nom 
de la liste.
   </para>
</refsect1>

<refsect1><title>Le groupe APT</title>
<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&nbsp;; cette option positionne l'architecture � utiliser 
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&nbsp;: �&nbsp;stable&nbsp;�,
�&nbsp;testing&nbsp;�, �&nbsp;4.0&nbsp;�, �&nbsp;5.0*&nbsp;�. Les noms de codes
des distributions (�&nbsp;etch&nbsp;�, �&nbsp;lenny&nbsp;�, etc.) ne sont pas
permis pour l'instant. Voir aussi &apt-preferences;.
     </para></listitem>
</varlistentry>

<varlistentry><term>Ignore-Hold</term><listitem>
<para>
Ignore les paquets �&nbsp;gel�s&nbsp;�&nbsp;; cette option globale indique au 
syst�me de r�solution de ne pas tenir compte des paquets �&nbsp;gel�s&nbsp;� 
dans sa prise de d�cision.
     </para></listitem>
</varlistentry>

<varlistentry><term>Clean-Installed</term>
<listitem><para>
Avec cette option qui est activ�e par d�faut, la fonctionnalit� �&nbsp;autoclean&nbsp;�
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.
     </para></listitem>
</varlistentry>

<varlistentry><term>Immediate-Configure</term>
<listitem><para>
D�sactive la configuration imm�diate&nbsp;; 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;. �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>

<varlistentry><term>Force-LoopBreak</term>
<listitem><para>
Ne jamais activer cette option � moins que vous ne sachiez - r�ellement - ce 
que vous faites. Elle autorise APT � supprimer temporairement un paquet
essentiel pour mettre fin � une boucle Conflicts / Conflicts ou
Conflicts / Pre-Depends entre deux paquets essentiels. UNE TELLE BOUCLE
NE DOIT JAMAIS SE PRODUIRE&nbsp;: C'EST UN BOGUE S�RIEUX. Cette option 
fonctionne si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, bash 
ou tous les paquets dont ces paquets d�pendent.
     </para></listitem>
</varlistentry>

<varlistentry><term>Cache-Limit</term>
<listitem><para>
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 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.
     </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.
     </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.
     </para></listitem>
</varlistentry>
</variablelist>
 </refsect1>

<refsect1><title>Le groupe Acquire</title>
<para>   
Le groupe d'options <literal>Acquire</literal> contr�le le t�l�chargement des paquets et
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 � �&nbsp;true&nbsp;�.
     </para></listitem>
</varlistentry>

<varlistentry><term>Queue-Mode</term>
<listitem><para>
Le mode de file d'attente&nbsp;; <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>

<varlistentry><term>Retries</term>
<listitem><para>
Nombre d'essais � effectuer. Si ce nombre n'est pas nul, APT essaie de
r�cup�rer, le nombre donn� de fois, les fichiers dont la r�cup�ration a �chou�.
     </para></listitem>
</varlistentry>

<varlistentry><term>Source-Symlinks</term>
<listitem><para>
Utilise des liens symboliques pour les archives de sources. Positionn�e � 
�&nbsp;true&nbsp;�,  cette option cr�e si possible des liens symboliques vers 
les archives de sources au lieu de les copier. 
Par d�faut � �&nbsp;true&nbsp;�.
     </para></listitem>
</varlistentry>

<varlistentry><term>http</term>
<listitem><para>
URI HTTP&nbsp;; http::Proxy est le mandataire (proxy) HTTP � utiliser par d�faut.
Il se pr�sente sous la forme standard&nbsp;:
<literal>http://[[user][:pass]@]host[:port]/</literal>. On peut sp�cifier un
mandataire particulier par h�te distant en utilisant la syntaxe&nbsp;:
<literal>http::Proxy::&lt;h�te&gt;</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 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&nbsp;; <literal>Max-Age</literal>
sert uniquement pour les fichiers d'index&nbsp;: cela demande au cache de les 
mettre � jour quand leur anciennet� est sup�rieure au nombre de secondes 
donn�. Debian met � jour ses fichiers d'index de mani�re quotidienne&nbsp;; la
valeur par d�faut est donc de 1 jour. <literal>No-Store</literal> sert uniquement
pour les fichiers d'archive&nbsp; 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&nbsp;: 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 et donn�es.
     </para>
<para>
Une option de configuration est fournie pour contr�ler la profondeur du tube
pour le cas o� un serveur distant n'est pas conforme � la RFC ou est bogu�
(comme Squid 2.0.2). <literal>Acquire::http::Pipeline-Depth </literal> a une valeur
comprise entre 0 et 5&nbsp;: elle indique le nombre de requ�tes en attente qui 
peuvent �tre �mises. Quand la machine distante ne conserve pas correctement
les connexions TCP, on DOIT donner une valeur �gale � 0 -- sinon des
donn�es seront corrompues. Les machines qui ont besoin de cette option
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>&lt;h�te&gt;::CaInfo</literal>,
<literal>&lt;h�te&gt;::Verify-Peer</literal>,
<literal>&lt;h�te&gt;::Verify-Host</literal>,
<literal>&lt;h�te&gt;::SslCert</literal>,
<literal>&lt;h�te&gt;::SslKey</literal> et
<literal>&lt;h�te&gt;::SslForceVersion</literal> respectivement.
     </para></listitem>
</varlistentry>

<varlistentry><term>ftp</term>
<listitem><para>
URI FTP&nbsp;; ftp::Proxy est le mandataire (proxy) FTP � utiliser par d�faut.
Il se pr�sente sous la forme standard&nbsp;: 
<literal>ftp://[[user][:pass]@]host[:port]/</literal>. On peut sp�cifier un
mandataire particulier par h�te distant en utilisant la syntaxe&nbsp;:
<literal>ftp::Proxy::&lt;h�te&gt;</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&nbsp;:
<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 et donn�es.
     </para>
<para>
Plusieurs options de configuration sont fournies pour contr�ler le mode 
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 
�&nbsp;port&nbsp;� de ftp
soit utilis� � la place. On peut le faire globalement, pour des
connexions qui passent par un mandataire ou pour une machine
sp�cifique (examinez le mod�le de fichier de configuration).
     </para>
<para>
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 
�&nbsp;false&nbsp;� ce qui signifie que ces commandes ne sont 
utilis�es que pour une connexion de type IPv6. Quand elle vaut 
�&nbsp;true&nbsp;�, on les utilise m�me si la connexion est de type IPv4. La 
plupart des serveurs FTP ne suivent pas la RFC 2428.
     </para></listitem>
</varlistentry>

<varlistentry><term>cdrom</term>
<listitem><para>
URI c�d�rom&nbsp;; la seule option de configuration pour les URI de c�d�rom
est le point de montage&nbsp;: <literal>cdrom::Mount</literal>&nbsp;; il doit 
repr�senter le point de montage du lecteur de c�d�rom indiqu� dans 
<filename>/etc/fstab</filename>. 
On peut fournir d'autres commandes de montage et de d�montage quand le
point de montage ne peut �tre list� dans le fichier <filename>/etc/fstab</filename>
(par exemple, un montage SMB). Syntaxiquement, il faut placer
<literallayout>"/cdrom/"::Mount "foo";</literallayout> dans le bloc cdrom.
La barre oblique finale est importante. Les commandes de d�montage
peuvent �tre sp�cifi�es en utilisant <literal>UMount</literal>.
     </para></listitem>
</varlistentry>

     <varlistentry><term>gpgv</term>
     <listitem><para>
URI GPGV&nbsp;; la seule option pour les URI GPGV est celle qui permet de
     passer des param�tres � gpgv.
     <literal>gpgv::Options</literal>&nbsp;: options suppl�mentaires pass�es �
     gpgv.
</para>
	  </listitem>
	</varlistentry>
</variablelist>
 </para>
</refsect1>

<refsect1><title>Les r�pertoires</title>
<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;.
<literal>preferences</literal> concerne APT&nbsp;: 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
sous-�l�ments, quand ceux-ci ne commencent pas par <filename>/</filename> 
ou <filename>./</filename>.
   </para>
<para>
<literal>Dir::Cache</literal> contient les emplacements qui renseignent sur le
cache local&nbsp;: 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 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>.
   </para>
<para>
<literal>Dir::Etc</literal> contient l'emplacement des fichiers de configuration,
<literal>sourcelist</literal> indique l'emplacement de la liste de sources et 
<literal>main</literal> est le fichier de configuration par d�faut (le modifier
n'a aucun effet, � moins qu'on ne le modifie avec le fichier de 
configuration indiqu� par la variable <envar>APT_CONFIG</envar>). 
   </para>
<para>
<literal>Dir::Parts</literal> lit, par ordre d'entr�e, tous les fragments de 
configuration dans le r�pertoire indiqu�. Ensuite, le fichier principal
de configuration est charg�.
   </para>
<para>
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>&nbsp;; <literal>gzip</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>
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>
<para>   
Quand APT est utilis� comme une m�thode de &dselect;, plusieurs directives 
contr�lent le comportement par d�faut. On les trouve dans la section
<literal>DSelect</literal>.
   </para>

   <variablelist>
<varlistentry><term>Clean</term>
<listitem><para>
Mode de nettoyage du cache&nbsp;; cette variable peut prendre l'une des valeurs
suivantes&nbsp;: �&nbsp;always&nbsp;�, �&nbsp;prompt&nbsp;�, 
�&nbsp;auto&nbsp;�, �&nbsp;pre-auto&nbsp;� et �&nbsp;never&nbsp;�. 
�&nbsp;always&nbsp;� et �&nbsp;prompt&nbsp;� suppriment tous les paquets du 
cache apr�s la mise � niveau&nbsp;; �&nbsp;prompt&nbsp;� (valeur par d�faut) 
les supprime apr�s une demande et �&nbsp;auto&nbsp;� ne supprime que les 
archives qui ne peuvent plus �tre t�l�charg�es (remplac�es, par exemple, par 
une nouvelle version). �&nbsp;pre-auto&nbsp;� les supprime avant de r�cup�rer 
de nouveaux paquets.
     </para></listitem>
</varlistentry>

<varlistentry><term>Options</term>
<listitem><para>
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� comme options de ligne de commande �
&apt-get; lors de la phase de mise � jour.
     </para></listitem>
</varlistentry>

<varlistentry><term>PromptAfterUpdate</term>
<listitem><para>
Si cette option est �&nbsp;vraie&nbsp;�, l'op�ration [U]pdate de &dselect; 
interroge toujours l'utilisateur avant de continuer. Par d�faut, ce n'est 
qu'en cas d'erreur que l'on propose � l'utilisateur d'intervenir.
     </para></listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1><title>Comment APT appelle &dpkg;</title>
<para>   
Plusieurs directives de configuration contr�lent la mani�re dont APT
invoque &dpkg;&nbsp;: elles figurent dans la section <literal>DPkg</literal>.
</para>
   <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 la liste est
pass� comme un seul argument � &dpkg;.
     </para></listitem>
</varlistentry>
<varlistentry><term>Pre-Invoke</term><term>Post-Invoke</term>
<listitem><para>
Il s'agit d'une liste de commandes shell � ex�cuter avant ou apr�s l'appel de
&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>&nbsp;: APT s'arr�te d�s que l'une d'elles �choue.
     </para></listitem>
</varlistentry>
<varlistentry><term>Pre-Install-Pkgs</term>
<listitem><para>
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>&nbsp;: APT s'arr�te d�s que l'une d'elles �choue. Sur 
l'entr�e standard, APT transmet aux commandes les noms de tous les fichiers 
.deb qu'il va installer, � raison d'un par ligne.
     </para>
<para>
La deuxi�me version de ce protocole donne plus de renseignements&nbsp;: on 
obtient la version du protocole, la configuration de APT et les paquets, 
fichiers ou versions qui ont chang�. On autorise cette version en positionnant
<literal>DPkg::Tools::Options::cmd::Version</literal> � 2. <literal>cmd</literal> est une 
commande pass�e � <literal>Pre-Install-Pkgs</literal>.
     </para></listitem>
</varlistentry>
<varlistentry><term>Run-Directory</term>
<listitem><para>
APT se place dans ce r�pertoire avant d'appeler &dpkg;&nbsp;; par d�faut c'est 
le r�pertoire <filename>/</filename>.
     </para></listitem>
</varlistentry>
<varlistentry><term>Build-Options</term>
<listitem><para>
Ces options sont pass�es � &dpkg-buildpackage; lors de la compilation des
paquets&nbsp;; par d�faut la signature est d�sactiv�e et tous les binaires sont
cr��s.
     </para></listitem>
</varlistentry>
</variablelist>
 </refsect1>

<refsect1>
<title>Options �&nbsp;Periodic&nbsp;� et �&nbsp;Archive&nbsp;�</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>&nbsp;: p�riodicit� de mise � jour de la
liste des paquets disponibles. (0 = d�sactiv�)
     </para></listitem>
<listitem><para>
<literal>Download-Upgradable-Packages</literal>&nbsp;: 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>&nbsp;: p�riodicit� des
�&nbsp;autoclean&nbsp;�, 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>&nbsp;: 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>&nbsp;: 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>&nbsp;: 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>&nbsp;: 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>
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&nbsp;:
   </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 �&nbsp;root&nbsp;�.
     </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 (&nbsp;�&nbsp;build-dependencies&nbsp;�&nbsp;) 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 �&nbsp;apt-get update&nbsp;� 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&nbsp;; 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&nbsp;; 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 des exemples
pour toutes les options existantes.
 </para>
</refsect1>

<refsect1><title>Fichiers</title>
<para>   <filename>/etc/apt/apt.conf</filename>
 </para>
</refsect1>
<refsect1><title>Voir aussi</title>
<para>
&apt-cache;, &apt-config;<!-- ? reading apt.conf -->, &apt-preferences;.</para>
</refsect1>

&manbugs;
&deux-traducteurs;
</refentry>