diff options
Diffstat (limited to 'doc/fr/apt.conf.5.fr.sgml')
-rw-r--r-- | doc/fr/apt.conf.5.fr.sgml | 436 |
1 files changed, 436 insertions, 0 deletions
diff --git a/doc/fr/apt.conf.5.fr.sgml b/doc/fr/apt.conf.5.fr.sgml new file mode 100644 index 000000000..3e104203e --- /dev/null +++ b/doc/fr/apt.conf.5.fr.sgml @@ -0,0 +1,436 @@ +<!-- -*- 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 ; 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/ ; 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/ ; 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 (� :: �) pour indiquer une option ; 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 : + <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 : +<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 : <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 � :: � 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 ; 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 � suspendus � ; cette option globale indique au syst�me de +r�solution de ne pas tenir compte des paquets � suspendus � 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� � autoclean � +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 ; 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 : 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 � available �. 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 ; <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 � +� true �, cette option cr�e si possible des liens symboliques vers les +archives de sources au lieu de les copier. +Par d�faut � � true �. + </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 : +<literal>http://[[user][:pass]@]host[:port]/</>. En utilisant la syntaxe : +<literal/http::Proxy::<host>/, 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 ; <literal/Max-Age/ +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 +valeur par d�faut est donc de 1 jour. <literal/No-Store/ sert uniquement +pour les fichiers d'archive : 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 : 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 : 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 : 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 ; ftp::Proxy est le serveur mandataire par d�faut � utiliser. Il se +pr�sente sous la forme standard : +<literal>ftp://[[user][:pass]@]host[:port]/</> ; 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 : +<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 : 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 ; 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 +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 +� 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. + </VarListEntry> + + <VarListEntry><Term>cdrom</Term> + <ListItem><Para> +CDROM URIs ; la seule option de configuration pour les URIs de CDROM +est le point de montage : <literal/cdrom::Mount/ ; 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 : 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 : 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/ ; <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 ; cette variable peut prendre l'une des valeurs +suivantes : � always �, � prompt �, � auto �, � pre-auto � et � never �. +� always � et � prompt � suppriment tous les paquets du cache apr�s la mise � +niveau ; � prompt � (valeur par d�faut) les supprime apr�s une demande et +� auto � ne supprime que les archives qui ne peuvent plus �tre t�l�charg�es +(remplac�es, par exemple, par une nouvelle version). � pre-auto � 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 � vraie �, 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; : 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 : 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 : 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 : 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 ; 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 ; 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 ; 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 � root � 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> |