From 9975c27866fd2f7b9a7f5ec44b5ca5ee70f947b2 Mon Sep 17 00:00:00 2001 From: Arch Librarian Date: Mon, 20 Sep 2004 17:01:13 +0000 Subject: Add pt_BR translation of apt_preferences(5). Also, bui... Author: doogie Date: 2003-04-27 00:25:57 GMT Add pt_BR translation of apt_preferences(5). Also, build fr manpages. --- doc/fr/apt.conf.fr.5.sgml | 436 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 436 insertions(+) create mode 100644 doc/fr/apt.conf.fr.5.sgml (limited to 'doc/fr/apt.conf.fr.5.sgml') diff --git a/doc/fr/apt.conf.fr.5.sgml b/doc/fr/apt.conf.fr.5.sgml new file mode 100644 index 000000000..3e104203e --- /dev/null +++ b/doc/fr/apt.conf.fr.5.sgml @@ -0,0 +1,436 @@ + + + +%aptent; + +]> + + + &apt-docinfo; + + + apt.conf + 5 + + + + + apt.conf + Fichier de configuration pour APT + + + 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> -- cgit v1.2.3