diff options
Diffstat (limited to 'doc/fr/apt.conf.fr.5.sgml')
| -rw-r--r-- | doc/fr/apt.conf.fr.5.sgml | 451 |
1 files changed, 0 insertions, 451 deletions
diff --git a/doc/fr/apt.conf.fr.5.sgml b/doc/fr/apt.conf.fr.5.sgml deleted file mode 100644 index 942fed10c..000000000 --- a/doc/fr/apt.conf.fr.5.sgml +++ /dev/null @@ -1,451 +0,0 @@ -<!-- -*- 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 ; 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/ ; 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. Une ligne -qui commence par <literal>//</literal> est un commentaire et elle est ignorée. -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 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 « :: » 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 « 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. - </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>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 ; <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 à -« 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 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 : 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/ ; <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 -<filename>/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 -<filename>/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é. 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 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> |