apt/doc/fr/apt.conf.5.fr.sgml

<!-- -*- mode: sgml; mode: fold -*- -->
<!-- translation of version 1.5 -->
<!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&thinsp;; tous les outils font appel à ce 
fichier de configuration et utilisent un analyseur syntaxique de 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/&thinsp;; 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/&thinsp;; 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&thinsp;; 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. 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 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&thinsp;; 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;suspendus&nbsp;»&thinsp;; cette option globale indique au système de
résolution de ne pas tenir compte des paquets «&nbsp;suspendus&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&thinsp;; 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>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&thinsp;; <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 le rapatriement 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&thinsp;; <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]/</>&thinsp;; 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&thinsp;; 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;»&thinsp;; 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&thinsp;; la seule option de configuration pour les URIs de CDROM
est le point de montage&nbsp;: <literal/cdrom::Mount/&thinsp;; 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 de préférence.
<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 celui de <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/methods/&thinsp;; <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&thinsp;; 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&thinsp;; «&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 /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 /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és. 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&thinsp;; 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&thinsp;; 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&thinsp;; 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 statfs dans les IDs 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>