<!-- -*- mode: sgml; mode: fold -*- -->
<!-- translation of version 1.10 -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

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

]>

<refentry lang=fr>
 &apt-docinfo;
 
 <refmeta>
   <refentrytitle>apt.conf</>
   <manvolnum>5</>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt.conf</>
    <refpurpose>Fichier de configuration pour APT</>
 </refnamediv>
 
 <RefSect1><Title>Description</>
   <para>   
   <filename/apt.conf/ 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 (si elle existe) la variable d'environnement 
<envar/APT_CONFIG/&nbsp;; puis il lit les fichiers situ�s dans 
<literal/Dir::Etc::Parts/ ainsi que le principal fichier de configuration
indiqu� par <literal/Dir::Etc::main/&nbsp;; 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.
   <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/ 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.
   <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.
Chaque ligne est de la forme&nbsp;:
   <literallayout>APT::Get::Assume-Yes "true";</literallayout> 
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;:
<informalexample><programlisting>   
APT {
  Get {
    Assume-Yes "true";
    Fix-Broken "true";
  };
};
</programlisting></informalexample>
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.
<informalexample><programlisting>   
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</programlisting></informalexample>
   <para>
Les mod�les <filename>&docdir;/examples/apt.conf</> &configureindex;
montrent � quoi devrait ressembler le fichier de configuration.
   <para>
Deux �l�ments sp�ciaux sont autoris�s&nbsp;: <literal/#include/ et 
<literal/#clear/. <literal/#include/ inclut le fichier donn� en argument, � 
moins que le nom ne se termine par une barre oblique. <literal/#clear/ sert � 
effacer une liste de noms.
   <para>
Tous les outils d'APT poss�dent une option <option>-o</> 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/) 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.
 </RefSect1>

 <RefSect1><Title>Le groupe APT</>
   <para>   
Ce groupe d'options contr�le aussi bien le comportement global d'APT que
la prise en compte des options pour chaque outil.

   <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. L'architecture 
interne par d�faut est celle pour laquelle APT a �t� compil�.
     </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.
     </VarListEntry>

     <VarListEntry><Term>Clean-Installed</Term>
     <ListItem><Para>
Avec cette option qui est activ�e par d�faut, la fonctionnalit� �&nbsp;autoclean&nbsp;�
supprime tout paquet qui ne peut plus �tre r�cup�r� dans le cache.
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.
     </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. 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.
Utilisez-la � vos risques et p�rils.
     </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.
     </VarListEntry>

     <VarListEntry><Term>Cache-Limit</Term>
     <ListItem><Para>
APT utilise un fichier cache d'une taille m�moire fixe pour ranger les
informations du fichier �&nbsp;available&nbsp;�. Cette option fixe la taille 
de ce cache.
     </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.
     </VarListEntry>

     <VarListEntry><Term>Get</Term>
     <ListItem><Para>
La sous-section <literal/Get/ contr�le l'outil &apt-get;, veuillez consulter
sa documentation pour avoir plus d'informations sur les options en question.
     </VarListEntry>

     <VarListEntry><Term>Cache</Term>
     <ListItem><Para>
La sous-section <literal/Cache/ contr�le l'outil &apt-cache;, veuillez 
consulter sa documentation pour avoir plus d'informations sur les options en 
question.
     </VarListEntry>

     <VarListEntry><Term>CDROM</Term>
     <ListItem><Para>
La sous-section <literal/CDROM/ contr�le l'outil &apt-cdrom;, veuillez 
consulter sa documentation pour avoir plus d'informations sur les options en 
question.
     </VarListEntry>
   </VariableList>
 </RefSect1>

 <RefSect1><Title>Le groupe Acquire</>
   <para>   
Le groupe d'options <literal/Acquire/ contr�le le t�l�chargement des paquets et
les gestionnaires d'URI.

   <VariableList>
     <VarListEntry><Term>Queue-Mode</Term>
     <ListItem><Para>
Le mode file d'attente&nbsp;; <literal/Queue-Mode/ peut prendre une valeur 
parmi <literal/host/ ou <literal/access/ et cela d�termine comment APT 
parall�lise les connexions sortantes. <literal/host/ signifie qu'une 
connexion par cible sera initi�e, tandis que <literal/access/ signifie qu'une 
connexion par type d'URI sera initi�e.
     </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�.
     </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;�.
     </VarListEntry>

     <VarListEntry><Term>http</Term>
     <ListItem><Para>
HTTP URIs; 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]/</>. En utilisant la syntaxe&nbsp;:
<literal/http::Proxy::&lt;host&gt;/, o� le mot-cl� sp�cial <literal/DIRECT/
indique de n'utiliser aucun mandataire, on peut sp�cifier un mandataire
pour chaque machine distante. La variable d'environnement <envar/http_proxy/
remplace tous ces param�tres.
     <para>
Trois options de configuration sont fournies pour le contr�le des caches qui
sont compatibles avec HTTP/1.1. <literal/No-Cache/ signifie que le mandataire
ne doit pas du tout utiliser les r�ponses qu'il a stock�es&nbsp;; <literal/Max-Age/
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 son fichier d'index de mani�re journali�re, la
valeur par d�faut est donc de 1 jour. <literal/No-Store/ sert uniquement
pour les fichiers d'archive&nbsp;: cela 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>
L'option <literal/timeout/ positionne le compteur de temps mort (timeout)
utilis� par la m�thode&nbsp;: cela vaut pour tout (connexion, donn�es).
     <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). Acquire::http::Pipeline-Depth 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.
     </VarListEntry>

     <VarListEntry><Term>ftp</Term>
     <ListItem><Para>
FTP URIs&nbsp;; ftp::Proxy est le serveur mandataire par d�faut � utiliser. Il se
pr�sente sous la forme standard&nbsp;: 
<literal>ftp://[[user][:pass]@]host[:port]/</>&nbsp;; il est remplac� par la 
variable d'environnement <envar/ftp_proxy/. Pour utiliser un mandataire ftp,
vous devez renseigner l'entr�e <literal/ftp::ProxyLogin/ 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&nbsp;:
<literal/$(PROXY_USER)/, <literal/$(PROXY_PASS)/, <literal/$(SITE_USER)/,
<literal/$(SITE_PASS)/, <literal/$(SITE)/, et <literal/$(SITE_PORT)/.
Chacune correspond � un �l�ment de l'URI.
     <para>
L'option <literal/timeout/ positionne le compteur de temps mort (timeout)
utilis� par la m�thode&nbsp;: cela vaut pour tout (connexion, donn�es).
     <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&nbsp;; 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>
On peut utiliser un mandataire FTP pour atteindre une cible HTTP en
positionnant la variable d'environnement <envar/ftp_proxy/ � 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�.
     <para>
L'option <literal/ForceExtended/ contr�le l'utilisation des commandes li�es 
� la RFC 2428, <literal/EPSV/ et <literal/EPRT/. Par d�faut, elle vaut 
�&nbsp;false&nbsp;�&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.
     </VarListEntry>

     <VarListEntry><Term>cdrom</Term>
     <ListItem><Para>
CDROM URIs&nbsp;; la seule option de configuration pour les URIs de CDROM
est le point de montage&nbsp;: <literal/cdrom::Mount/&nbsp;; il doit 
repr�senter le point de montage du lecteur de c�d�rom indiqu� dans 
<filename>/etc/fstab</>. 
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</>
(par exemple, un montage SMB ou ...). 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/.
     </VarListEntry>
   </VariableList>
 </RefSect1>

 <RefSect1><Title>Les r�pertoires</>
   <para>   
Les r�pertoires de la section <literal/Dir::State/ concernent le syst�me
local. <literal/lists/ est le r�pertoire o� placer les listes de paquets
t�l�charg�s et <literal/status/ est le nom du fichier d'�tat de Dpkg.
<literal/preferences/ concerne APT&nbsp;: c'est le nom du fichier des 
pr�f�rences.
<literal/Dir::State/ contient le r�pertoire par d�faut pr�fix� � tous les
sous-�l�ments, quand ceux-ci ne commencent pas par <filename>/</> 
ou <filename>./</>.
   <para>
<literal/Dir::Cache/ contient les emplacements qui renseignent sur le
cache local&nbsp;: par exemple, les deux caches de paquets 
<literal/srcpkgcache/ et <literal/pkgcache/, et aussi l'endroit o� sont 
plac�es les archives t�l�charg�es, <literal/Dir::Cache::archives/. 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 
cache <literal/pkgcache/ plut�t que se passer du cache <literal/srcpkgcache/. 
Comme pour <literal/Dir::State/, le r�pertoire par d�faut est contenu dans
<literal/Dir::Cache/.
   <para>
<literal/Dir::Etc/ contient l'emplacement des fichiers de configuration,
<literal/sourcelist/ indique l'emplacement de la liste de sources et 
<literal/main/ 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/). 
   <para>
<literal/Dir::Parts/ 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>
Les programmes binaires sont point�s par <literal/Dir::Bin/.
L'emplacement des gestionnaires de m�thodes est indiqu� par
<literal/Dir::Bin::Methods/&nbsp;; <literal/gzip/, <literal/Dpkg/, <literal/apt-get/,
<literal/dpkg-source/, <literal/dpkg-buildpackage/ et <literal/apt-cache/
indiquent l'emplacement des programmes correspondants.
 </RefSect1>
 
 <RefSect1><Title>APT et DSelect</>
   <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/.
   
   <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.
     </VarListEntry>
     
     <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.
     </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.
     </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.
     </VarListEntry>
   </VariableList>
 </RefSect1>
 
 <RefSect1><Title>Comment APT appelle Dpkg</>
   <para>   
Plusieurs directives de configuration contr�lent la mani�re dont APT
invoque &dpkg;&nbsp;: elles figurent dans la section <literal/DPkg/.

   <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
pass� comme un seul argument � &dpkg;.
     </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/, on doit utiliser la notation de
liste. Les commandes sont appel�es dans l'ordre, en utilisant 
<filename>/bin/sh</>&nbsp;: APT s'arr�te d�s que l'une d'elles �choue.
     </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/, on doit utiliser la notation de liste.
Les commandes sont appel�es dans l'ordre, en utilisant 
<filename>/bin/sh</>&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>
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/ � 2. <literal/cmd/ est une 
commande pass�e � <literal/Pre-Install-Pkgs/.
     </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>/</>.
     </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.
     </VarListEntry>
   </VariableList>
 </RefSect1>

 <RefSect1><Title>Les options de d�bogage</>
   <para>   
La plupart des options de la section <literal/debug/ n'ont aucun int�r�t
pour le simple utilisateur&nbsp;; cependant, 
<literal/Debug::pkgProblemResolver/ affiche d'int�ressantes informations sur 
les d�cisions que prend la commande dist-upgrade. <literal/Debug::NoLocking/ 
d�sactive le verrouillage de fichier de mani�re � ce que APT puisse effectuer 
quelques op�rations sans �tre �&nbsp;root&nbsp;� et 
<literal/Debug::pkgDPkgPM/ affiche la ligne de commande � chaque appel de 
Dpkg. <literal/Debug::IdentCdrom/ d�sactive l'inclusion de 
donn�es de type statfs dans les ID de CDROM.
 </RefSect1>
 
 <RefSect1><Title>Exemples</>
   <para>
   &configureindex; contient un mod�le de fichier montrant les valeurs par
d�faut de toutes les options possibles.
 </RefSect1>
 
 <RefSect1><Title>Fichiers</>
   <para>
   <filename>/etc/apt/apt.conf</>
 </RefSect1>
 
 <RefSect1><Title>Voir aussi</>
   <para>
   &apt-cache;, &apt-config;, &apt-preferences;.
 </RefSect1>

 &manbugs;
 &manauthor;
 &deux-traducteurs;

</refentry>