diff options
Diffstat (limited to 'doc/fr/apt.conf.fr.5.xml')
-rw-r--r-- | doc/fr/apt.conf.fr.5.xml | 517 |
1 files changed, 0 insertions, 517 deletions
diff --git a/doc/fr/apt.conf.fr.5.xml b/doc/fr/apt.conf.fr.5.xml deleted file mode 100644 index 88ce46134..000000000 --- a/doc/fr/apt.conf.fr.5.xml +++ /dev/null @@ -1,517 +0,0 @@ -<?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>29 F�vrier 2004</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 ; tous les outils font appel � ce -fichier de configuration et utilisent un analyseur syntaxique en ligne de -commande commun afin de fournir un environnement uniforme. Quand un outil -d'APT d�marre, il lit (si elle existe) la variable d'environnement -<envar>APT_CONFIG</envar> ; puis il lit les fichiers situ�s dans -<literal>Dir::Etc::Parts</literal> ainsi que le principal fichier de configuration -indiqu� par <literal>Dir::Etc::main</literal> ; enfin il applique les options de -la ligne de commande qui annulent les directives de configuration, chargeant, -si n�cessaire, d'autres fichiers de configuration. - </para> -<para> -Le fichier de configuration est construit comme un arbre d'options -organis�es en groupes fonctionnels. On se sert du double deux points (� :: �) -pour indiquer une option ; par exemple, <literal>APT::Get::Assume-Yes</literal> est -une option pour le groupe d'outils APT, destin�e � l'outil Get. Les options -n'h�ritent pas des groupes de leurs parents. - </para> -<para> -Syntaxiquement, le langage de configuration est con�u sur le m�me mod�le -que les langages utilis�s par des outils ISC tels que bind et dhcp. Une ligne -qui commence par <literal>//</literal> est un commentaire et elle est ignor�e. -Chaque ligne est de la forme : - <literal>APT::Get::Assume-Yes "true";</literal> -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 : -</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 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. -</para> - -<informalexample><programlisting> -DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; -</programlisting></informalexample> - -<para> -Les mod�les <filename>&docdir;examples/apt.conf</filename> &configureindex; -montrent � quoi devrait ressembler le fichier de configuration. - </para> -<para> -Deux �l�ments sp�ciaux sont autoris�s : <literal>#include</literal> et -<literal>#clear</literal>. <literal>#include</literal> inclut le fichier donn� en argument, -� moins que le nom ne se termine par une barre oblique. <literal>#clear</literal> sert � -effacer une liste de noms. - </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 � :: � au nom -de la liste. - </para> -</refsect1> - -<refsect1><title>Le groupe APT</title> -<para> -Ce groupe d'options contr�le aussi bien le comportement global d'APT que -la prise en compte des options pour chaque outil. -</para> - <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�. - </para></listitem> -</varlistentry> - -<varlistentry><term>Ignore-Hold</term><listitem> -<para> -Ignore les paquets � gel�s � ; cette option globale indique au -syst�me de r�solution de ne pas tenir compte des paquets � gel�s � -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� � 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. - </para></listitem> -</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. - </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 : 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 cache d'une taille m�moire fixe pour ranger les -informations du fichier � available �. Cette option fixe la taille -de ce cache. - </para></listitem> -</varlistentry> - -<varlistentry><term>Build-Essential</term> -<listitem><para> - Cette option d�finit les paquets qui sont consid�r�s comme faisant partie -des d�pendances essentielles pour la construction des paquets. - </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>Queue-Mode</term> -<listitem><para> -Le mode file d'attente ; <literal>Queue-Mode</literal> peut prendre une valeur -parmi <literal>host</literal> ou <literal>access</literal> et cela d�termine comment APT -parall�lise les connexions sortantes. <literal>Host</literal> signifie qu'une -connexion par cible sera initi�e, tandis que <literal>access</literal> signifie qu'une -connexion par type d'URI sera initi�e. - </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 � -� true �, cette option cr�e si possible des liens symboliques vers -les archives de sources au lieu de les copier. -Par d�faut � � true �. - </para></listitem> -</varlistentry> - -<varlistentry><term>http</term> -<listitem><para> -URI HTTP ; http::Proxy est le mandataire (proxy) http � utiliser par d�faut. -Il se pr�sente sous la forme standard : -<literal>http://[[user][:pass]@]host[:port]/</literal>. En utilisant la syntaxe : -<literal>http::Proxy::<host></literal>, o� le mot-cl� sp�cial <literal>DIRECT</literal> -indique de n'utiliser aucun mandataire, on peut sp�cifier un mandataire -pour chaque machine distante. La variable d'environnement <envar>http_proxy</envar> -remplace tous ces param�tres. - </para> -<para> -Trois options de configuration sont fournies pour le contr�le des caches qui -sont compatibles avec HTTP/1.1. <literal>No-Cache</literal> signifie que le mandataire -ne doit pas du tout utiliser les r�ponses qu'il a stock�es ; <literal>Max-Age</literal> -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</literal> 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> -<para> -L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout) -utilis� par la m�thode : cela vaut pour tout (connexion, donn�es). - </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 : 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>ftp</term> -<listitem><para> -URI FTP ; ftp::Proxy est le serveur mandataire par d�faut � utiliser. Il se -pr�sente sous la forme standard : -<literal>ftp://[[user][:pass]@]host[:port]/</literal> ; il est remplac� par la -variable d'environnement <envar>ftp_proxy</envar>. Pour utiliser un mandataire ftp, -vous devez renseigner l'entr�e <literal>ftp::ProxyLogin</literal> dans le fichier de -configuration. Cette entr�e sp�cifie les commandes qui disent au serveur -mandataire comment se connecter. Voyez &configureindex; pour savoir -comment faire. Les variables de substitution disponibles sont : -<literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>, -<literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal>, et <literal>$(SITE_PORT)</literal>. -Chacune correspond � un �l�ment de l'URI. - </para> -<para> -L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout) -utilis� par la m�thode : cela vaut pour tout (connexion, donn�es). - </para> -<para> -Plusieurs options de configuration sont fournies pour contr�ler le mode -passif. G�n�ralement, c'est plus s�r d'activer le mode passif ; cela -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> -<para> -On peut utiliser un mandataire FTP pour atteindre une cible HTTP en -positionnant la variable d'environnement <envar>ftp_proxy</envar> � une url http -- -consultez la m�thode http ci-dessus pour la syntaxe. On ne peut pas fixer -cette variable dans le fichier de configuration et il n'est pas recommand� -d'utiliser HTTP par FTP � cause de son peu d'efficacit�. - </para> -<para> -L'option <literal>ForceExtended</literal> contr�le l'utilisation des commandes li�es -� la RFC 2428, <literal>EPSV</literal> et <literal>EPRT</literal>. Par d�faut, elle vaut -� false � ; ce qui signifie que ces commandes ne sont -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. - </para></listitem> -</varlistentry> - -<varlistentry><term>cdrom</term> -<listitem><para> -URI CDROM ; la seule option de configuration pour les URI de CDROM -est le point de montage : <literal>cdrom::Mount</literal> ; il doit -repr�senter le point de montage du lecteur de c�d�rom indiqu� dans -<filename>/etc/fstab</filename>. -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 ; la seule option pour les URI GPGV est celle qui permet de - passer des param�tres � gpgv. - <literal>gpgv::Options</literal> Options suppl�mentaires pass�es � - 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 : 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 : par exemple, les deux caches de paquets -<literal>srcpkgcache</literal> et <literal>pkgcache</literal>, et aussi l'endroit o� sont -plac�es les archives t�l�charg�es, <literal>Dir::Cache::archives</literal>. On peut -emp�cher la cr�ation des caches en laissant leur nom en blanc. Cela ralentit -le d�marrage mais cela sauve de l'espace disque. Il vaut mieux se passer du -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> ; <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> -</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 ; 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. - </para></listitem> -</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. - </para></listitem> -</varlistentry> -<varlistentry><term>UpdateOptions</term> -<listitem><para> -Le contenu de cette variable est pass� � &apt-get; avec les options de la -ligne de commande quand ce programme est utilis� dans la phase de mise � jour. - </para></listitem> -</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. - </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; : 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 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> : 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> : 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 : 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 ; 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 ; par d�faut la signature est d�sactiv�e et tous les binaires sont -cr��s. - </para></listitem> -</varlistentry> -</variablelist> - </refsect1> - -<refsect1><title>Les options de d�bogage</title> -<para> -La plupart des options de la section <literal>debug</literal> n'ont aucun int�r�t -pour le simple utilisateur ; cependant, -<literal>Debug::pkgProblemResolver</literal> affiche d'int�ressantes informations sur -les d�cisions que prend la commande dist-upgrade. <literal>Debug::NoLocking</literal> -d�sactive le verrouillage de fichier de mani�re � ce que APT puisse effectuer -quelques op�rations sans �tre � root � et -<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande � chaque appel de -Dpkg. <literal>Debug::IdentCdrom</literal> d�sactive l'inclusion de -donn�es de type statfs dans les ID de CDROM. -<literal>Debug::Acquire::gpgv</literal> D�bogage de la m�thode gpgv. - </para> -</refsect1> - -<refsect1><title>Exemples</title> -<para> -Le fichier &configureindex; contient un mod�le de fichier montrant les valeurs par -d�faut de toutes les options possibles. - </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>
\ No newline at end of file |