summaryrefslogtreecommitdiff
path: root/doc/fr/apt.conf.fr.5.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fr/apt.conf.fr.5.sgml')
-rw-r--r--doc/fr/apt.conf.fr.5.sgml451
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&nbsp;; 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/&nbsp;; 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/&nbsp;; 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&nbsp;; 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&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 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 «&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&nbsp;; 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;gelés&nbsp;»&nbsp;; cette option globale indique au
-système de résolution de ne pas tenir compte des paquets «&nbsp;gelés&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&nbsp;; 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>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&nbsp;; <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 à
-«&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&nbsp;; <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]/</>&nbsp;; 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&nbsp;; 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;»&nbsp;; 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&nbsp;; la seule option de configuration pour les URIs de CDROM
-est le point de montage&nbsp;: <literal/cdrom::Mount/&nbsp;; 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 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&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 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/&nbsp;; <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&nbsp;; 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&nbsp;; «&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
-<filename>/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
-<filename>/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é. 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&nbsp;; 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&nbsp;; 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&nbsp;; 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 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>