<!-- -*- mode: sgml; mode: fold -*- -->
-<!-- translation of version 1.5 -->
+<!-- translation of version 1.9 -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!ENTITY % aptent SYSTEM "apt.ent.fr">
<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
+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
+<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,
+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
+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>
<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 à
+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
<RefSect1><Title>Le groupe APT</>
<para>
-Ce groupe d'options contrôle aussi bien le comportement global d' APT que
+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
+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.
+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>
<VarListEntry><Term>Immediate-Configure</Term>
<ListItem><Para>
-Désactive la configuration immédiate ; cette dangereuse option désactive
+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
+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><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
+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.
+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.
+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>
<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.
+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é.
+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.
+« 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>
<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/
+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
<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
+<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
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
+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>
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.
+« 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</>.
+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
<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.
+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 celui de <literal/srcpkgcache/. Comme pour
-<literal/Dir::State/, le répertoire par défaut est contenu dans
+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,
<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/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>
<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.
+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>
<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.
+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>
<VariableList>
<VarListEntry><Term>Options</Term>
<ListItem><Para>
-Il s'agit d'une liste d'options à passer à Dpkg. Les options doivent être
+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.
+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.
+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 /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.
+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és. On autorise cette version en positionnant
+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>/</>.
+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
+paquets ; par défaut la signature est désactivée et tous les binaires sont
créés.
</VarListEntry>
</VariableList>
<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.
+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</>
projects / apt.git / blobdiff