doc/fr/apt.conf.fr.5

   1 .\"     Title: apt.conf
   2 .\"    Author: Jason Gunthorpe
   3 .\" Generator: DocBook XSL Stylesheets v1.71.0 <http://docbook.sf.net/>
   4 .\"      Date: 29 Février 2004
   5 .\"    Manual:
   6 .\"    Source: Linux
   7 .\"
   8 .TH "APT.CONF" "5" "29 Février 2004" "Linux" ""
   9 .\" disable hyphenation
  10 .nh
  11 .\" disable justification (adjust text to left margin only)
  12 .ad l
  13 .SH "NOM"
  14 apt.conf \- Fichier de configuration pour APT
  15 .SH "DESCRIPTION"
  16 .PP
  17 Le fichier
  18 \fIapt.conf\fR
  19 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
  20 \fBAPT_CONFIG\fR\ ; puis il lit les fichiers situés dans
  21 Dir::Etc::Parts
  22 ainsi que le principal fichier de configuration indiqué par
  23 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.
  24 .PP
  25 Le fichier de configuration est construit comme un arbre d'options organisées en groupes fonctionnels. On se sert du double deux points (\(Fo\ ::\ \(Fc) pour indiquer une option\ ; par exemple,
  26 APT::Get::Assume\-Yes
  27 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.
  28 .PP
  29 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
  30 //
  31 est un commentaire et elle est ignorée. Chaque ligne est de la forme\ :
  32 APT::Get::Assume\-Yes "true";
  33 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\ :
  34 .sp
  35 .RS 3n
  36 .nf
  37
  38 APT {
  39   Get {
  40     Assume\-Yes "true";
  41     Fix\-Broken "true";
  42   };
  43 };
  44 .fi
  45 .RE
  46 .PP
  47 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.
  48 .sp
  49 .RS 3n
  50 .nf
  51
  52 DPkg::Pre\-Install\-Pkgs {"/usr/sbin/dpkg\-preconfigure \-\-apt";};
  53 .fi
  54 .RE
  55 .PP
  56 Les modèles
  57 \fI/usr/share/doc/apt/examples/apt.conf\fR
  58 \fI/usr/share/doc/apt/examples/configure\-index.gz\fR
  59 montrent à quoi devrait ressembler le fichier de configuration.
  60 .PP
  61 Deux éléments spéciaux sont autorisés\ :
  62 #include
  63 et
  64 #clear.
  65 #include
  66 inclut le fichier donné en argument, à moins que le nom ne se termine par une barre oblique.
  67 #clear
  68 sert à effacer une liste de noms.
  69 .PP
  70 Tous les outils d'APT possèdent une option
  71 \fB\-o\fR
  72 qui permet de spécifier une configuration arbitraire depuis la ligne de commande. La syntaxe consiste en un nom complet d'option (par exemple
  73 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 \(Fo\ ::\ \(Fc au nom de la liste.
  74 .SH "LE GROUPE APT"
  75 .PP
  76 Ce groupe d'options contrôle aussi bien le comportement global d'APT que la prise en compte des options pour chaque outil.
  77 .PP
  78 Architecture
  79 .RS 3n
  80 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é.
  81 .RE
  82 .PP
  83 Ignore\-Hold
  84 .RS 3n
  85 Ignore les paquets \(Fo\ gelés\ \(Fc\ ; cette option globale indique au système de résolution de ne pas tenir compte des paquets \(Fo\ gelés\ \(Fc dans sa prise de décision.
  86 .RE
  87 .PP
  88 Clean\-Installed
  89 .RS 3n
  90 Avec cette option qui est activée par défaut, la fonctionnalité \(Fo\ autoclean\ \(Fc 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.
  91 .RE
  92 .PP
  93 Immediate\-Configure
  94 .RS 3n
  95 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.
  96 .RE
  97 .PP
  98 Force\-LoopBreak
  99 .RS 3n
 100 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.
 101 .RE
 102 .PP
 103 Cache\-Limit
 104 .RS 3n
 105 APT utilise un fichier cache d'une taille mémoire fixe pour ranger les informations du fichier \(Fo\ available\ \(Fc. Cette option fixe la taille de ce cache.
 106 .RE
 107 .PP
 108 Build\-Essential
 109 .RS 3n
 110 Cette option définit les paquets qui sont considérés comme faisant partie des dépendances essentielles pour la construction des paquets.
 111 .RE
 112 .PP
 113 Get
 114 .RS 3n
 115 La sous\-section
 116 Get
 117 contrôle l'outil
 118 \fBapt\-get\fR(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.
 119 .RE
 120 .PP
 121 Cache
 122 .RS 3n
 123 La sous\-section
 124 Cache
 125 contrôle l'outil
 126 \fBapt\-cache\fR(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.
 127 .RE
 128 .PP
 129 CDROM
 130 .RS 3n
 131 La sous\-section
 132 CDROM
 133 contrôle l'outil\fBapt\-cdrom\fR(8), veuillez consulter sa documentation pour avoir plus d'informations sur les options en question.
 134 .RE
 135 .SH "LE GROUPE ACQUIRE"
 136 .PP
 137 Le groupe d'options
 138 Acquire
 139 contrôle le téléchargement des paquets et les gestionnaires d'URI.
 140 .PP
 141 Queue\-Mode
 142 .RS 3n
 143 Le mode file d'attente\ ;
 144 Queue\-Mode
 145 peut prendre une valeur parmi
 146 host
 147 ou
 148 access
 149 et cela détermine comment APT parallélise les connexions sortantes.
 150 Host
 151 signifie qu'une connexion par cible sera initiée, tandis que
 152 access
 153 signifie qu'une connexion par type d'URI sera initiée.
 154 .RE
 155 .PP
 156 Retries
 157 .RS 3n
 158 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é.
 159 .RE
 160 .PP
 161 Source\-Symlinks
 162 .RS 3n
 163 Utilise des liens symboliques pour les archives de sources. Positionnée à \(Fo\ true\ \(Fc, cette option crée si possible des liens symboliques vers les archives de sources au lieu de les copier. Par défaut à \(Fo\ true\ \(Fc.
 164 .RE
 165 .PP
 166 http
 167 .RS 3n
 168 URI HTTP ; http::Proxy est le mandataire (proxy) http à utiliser par défaut. Il se présente sous la forme standard\ :
 169 http://[[user][:pass]@]host[:port]/. En utilisant la syntaxe\ :
 170 http::Proxy::<host>, où le mot\-clé spécial
 171 DIRECT
 172 indique de n'utiliser aucun mandataire, on peut spécifier un mandataire pour chaque machine distante. La variable d'environnement
 173 \fBhttp_proxy\fR
 174 remplace tous ces paramètres.
 175 .sp
 176 Trois options de configuration sont fournies pour le contrôle des caches qui sont compatibles avec HTTP/1.1.
 177 No\-Cache
 178 signifie que le mandataire ne doit pas du tout utiliser les réponses qu'il a stockées\ ;
 179 Max\-Age
 180 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.
 181 No\-Store
 182 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.
 183 .sp
 184 L'option
 185 timeout
 186 positionne le compteur de temps mort (timeout) utilisé par la méthode\ : cela vaut pour tout (connexion, données).
 187 .sp
 188 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).
 189 Acquire::http::Pipeline\-Depth
 190 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.
 191 .RE
 192 .PP
 193 ftp
 194 .RS 3n
 195 URI FTP ; ftp::Proxy est le serveur mandataire par défaut à utiliser. Il se présente sous la forme standard\ :
 196 ftp://[[user][:pass]@]host[:port]/\ ; il est remplacé par la variable d'environnement
 197 \fBftp_proxy\fR. Pour utiliser un mandataire ftp, vous devez renseigner l'entrée
 198 ftp::ProxyLogin
 199 dans le fichier de configuration. Cette entrée spécifie les commandes qui disent au serveur mandataire comment se connecter. Voyez
 200 \fI/usr/share/doc/apt/examples/configure\-index.gz\fR
 201 pour savoir comment faire. Les variables de substitution disponibles sont\ :
 202 $(PROXY_USER),
 203 $(PROXY_PASS),
 204 $(SITE_USER),
 205 $(SITE_PASS),
 206 $(SITE), et
 207 $(SITE_PORT). Chacune correspond à un élément de l'URI.
 208 .sp
 209 L'option
 210 timeout
 211 positionne le compteur de temps mort (timeout) utilisé par la méthode\ : cela vaut pour tout (connexion, données).
 212 .sp
 213 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 \(Fo\ port\ \(Fc 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).
 214 .sp
 215 On peut utiliser un mandataire FTP pour atteindre une cible HTTP en positionnant la variable d'environnement
 216 \fBftp_proxy\fR
 217 à 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é.
 218 .sp
 219 L'option
 220 ForceExtended
 221 contrôle l'utilisation des commandes liées à la RFC 2428,
 222 EPSV
 223 et
 224 EPRT. Par défaut, elle vaut \(Fo\ false\ \(Fc\ ; ce qui signifie que ces commandes ne sont utilisées que pour une connexion de type IPv6. Quand elle vaut \(Fo\ true\ \(Fc, on les utilise même si la connexion est de type IPv4. La plupart des serveurs FTP ne suivent pas la RFC 2428.
 225 .RE
 226 .PP
 227 cdrom
 228 .RS 3n
 229 URI CDROM\ ; la seule option de configuration pour les URI de CDROM est le point de montage\ :
 230 cdrom::Mount\ ; il doit représenter le point de montage du lecteur de cédérom indiqué dans
 231 \fI/etc/fstab\fR. On peut fournir d'autres commandes de montage et de démontage quand le point de montage ne peut être listé dans le fichier
 232 \fI/etc/fstab\fR
 233 (par exemple, un montage SMB). Syntaxiquement, il faut placer
 234 .sp
 235 .RS 3n
 236 .nf
 237 "/cdrom/"::Mount "foo";
 238 .fi
 239 .RE
 240 .sp
 241 dans le bloc cdrom. La barre oblique finale est importante. Les commandes de démontage peuvent être spécifiées en utilisant
 242 UMount.
 243 .RE
 244 .PP
 245 gpgv
 246 .RS 3n
 247 URI GPGV ; la seule option pour les URI GPGV est celle qui permet de passer des paramètres à gpgv.
 248 gpgv::Options
 249 Options supplémentaires passées à gpgv.
 250 .RE
 251 .SH "LES RÉPERTOIRES"
 252 .PP
 253 Les répertoires de la section
 254 Dir::State
 255 concernent le système local.
 256 lists
 257 est le répertoire où placer les listes de paquets téléchargés et
 258 status
 259 est le nom du fichier d'état de Dpkg.
 260 preferences
 261 concerne APT\ : c'est le nom du fichier des préférences.
 262 Dir::State
 263 contient le répertoire par défaut préfixé à tous les sous\-éléments, quand ceux\-ci ne commencent pas par
 264 \fI/\fR
 265 ou
 266 \fI./\fR.
 267 .PP
 268
 269 Dir::Cache
 270 contient les emplacements qui renseignent sur le cache local\ : par exemple, les deux caches de paquets
 271 srcpkgcache
 272 et
 273 pkgcache, et aussi l'endroit où sont placées les archives téléchargées,
 274 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
 275 pkgcache
 276 plutôt que se passer du cache
 277 srcpkgcache. Comme pour
 278 Dir::State, le répertoire par défaut est contenu dans
 279 Dir::Cache.
 280 .PP
 281
 282 Dir::Etc
 283 contient l'emplacement des fichiers de configuration,
 284 sourcelist
 285 indique l'emplacement de la liste de sources et
 286 main
 287 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
 288 \fBAPT_CONFIG\fR).
 289 .PP
 290
 291 Dir::Parts
 292 lit, par ordre d'entrée, tous les fragments de configuration dans le répertoire indiqué. Ensuite, le fichier principal de configuration est chargé.
 293 .PP
 294 Les programmes binaires sont pointés par
 295 Dir::Bin. L'emplacement des gestionnaires de méthodes est indiqué par
 296 Dir::Bin::Methods\ ;
 297 gzip,
 298 Dpkg,
 299 apt\-get,
 300 dpkg\-source,
 301 dpkg\-buildpackage
 302 et
 303 apt\-cache
 304 indiquent l'emplacement des programmes correspondants.
 305 .SH "APT ET DSELECT"
 306 .PP
 307 Quand APT est utilisé comme une méthode de
 308 \fBdselect\fR(8), plusieurs directives contrôlent le comportement par défaut. On les trouve dans la section
 309 DSelect.
 310 .PP
 311 Clean
 312 .RS 3n
 313 Mode de nettoyage du cache\ ; cette variable peut prendre l'une des valeurs suivantes\ : \(Fo\ always\ \(Fc, \(Fo\ prompt\ \(Fc, \(Fo\ auto\ \(Fc, \(Fo\ pre\-auto\ \(Fc et \(Fo\ never\ \(Fc. \(Fo\ always\ \(Fc et \(Fo\ prompt\ \(Fc suppriment tous les paquets du cache après la mise à niveau\ ; \(Fo\ prompt\ \(Fc (valeur par défaut) les supprime après une demande et \(Fo\ auto\ \(Fc ne supprime que les archives qui ne peuvent plus être téléchargées (remplacées, par exemple, par une nouvelle version). \(Fo\ pre\-auto\ \(Fc les supprime avant de récupérer de nouveaux paquets.
 314 .RE
 315 .PP
 316 Options
 317 .RS 3n
 318 Le contenu de cette variable est passé à
 319 \fBapt\-get\fR(8)
 320 avec les options de la ligne de commande quand ce programme est utilisé dans la phase d'installation.
 321 .RE
 322 .PP
 323 UpdateOptions
 324 .RS 3n
 325 Le contenu de cette variable est passé à
 326 \fBapt\-get\fR(8)
 327 avec les options de la ligne de commande quand ce programme est utilisé dans la phase de mise à jour.
 328 .RE
 329 .PP
 330 PromptAfterUpdate
 331 .RS 3n
 332 Si cette option est \(Fo\ vraie\ \(Fc, l'opération [U]pdate de
 333 \fBdselect\fR(8)
 334 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.
 335 .RE
 336 .SH "COMMENT APT APPELLE DPKG"
 337 .PP
 338 Plusieurs directives de configuration contrôlent la manière dont APT invoque
 339 \fBdpkg\fR(8)\ : elles figurent dans la section
 340 DPkg.
 341 .PP
 342 Options
 343 .RS 3n
 344 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 à
 345 \fBdpkg\fR(8).
 346 .RE
 347 .PP
 348 Pre\-Invoke, Post\-Invoke
 349 .RS 3n
 350 Il s'agit d'une liste de commandes shell à exécuter avant ou après l'appel de
 351 \fBdpkg\fR(8). Tout comme pour
 352 Options, on doit utiliser la notation de liste. Les commandes sont appelées dans l'ordre, en utilisant
 353 \fI/bin/sh\fR\ : APT s'arrête dès que l'une d'elles échoue.
 354 .RE
 355 .PP
 356 Pre\-Install\-Pkgs
 357 .RS 3n
 358 Il s'agit d'une liste de commandes shell à exécuter avant d'appeler Dpkg. Tout comme pour
 359 Options, on doit utiliser la notation de liste. Les commandes sont appelées dans l'ordre, en utilisant
 360 \fI/bin/sh\fR\ : 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.
 361 .sp
 362 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
 363 DPkg::Tools::Options::cmd::Version
 364 à 2.
 365 cmd
 366 est une commande passée à
 367 Pre\-Install\-Pkgs.
 368 .RE
 369 .PP
 370 Run\-Directory
 371 .RS 3n
 372 APT se place dans ce répertoire avant d'appeler Dpkg\ ; par défaut c'est le répertoire
 373 \fI/\fR.
 374 .RE
 375 .PP
 376 Build\-Options
 377 .RS 3n
 378 Ces options sont passées à
 379 \fBdpkg\-buildpackage\fR(1)
 380 lors de la compilation des paquets\ ; par défaut la signature est désactivée et tous les binaires sont créés.
 381 .RE
 382 .SH "LES OPTIONS DE DÉBOGAGE"
 383 .PP
 384 La plupart des options de la section
 385 debug
 386 n'ont aucun intérêt pour le simple utilisateur\ ; cependant,
 387 Debug::pkgProblemResolver
 388 affiche d'intéressantes informations sur les décisions que prend la commande dist\-upgrade.
 389 Debug::NoLocking
 390 désactive le verrouillage de fichier de manière à ce que APT puisse effectuer quelques opérations sans être \(Fo\ root\ \(Fc et
 391 Debug::pkgDPkgPM
 392 affiche la ligne de commande à chaque appel de Dpkg.
 393 Debug::IdentCdrom
 394 désactive l'inclusion de données de type statfs dans les ID de CDROM.
 395 Debug::Acquire::gpgv
 396 Débogage de la méthode gpgv.
 397 .SH "EXEMPLES"
 398 .PP
 399 Le fichier
 400 \fI/usr/share/doc/apt/examples/configure\-index.gz\fR
 401 contient un modèle de fichier montrant les valeurs par défaut de toutes les options possibles.
 402 .SH "FICHIERS"
 403 .PP
 404
 405 \fI/etc/apt/apt.conf\fR
 406 .SH "VOIR AUSSI"
 407 .PP
 408
 409 \fBapt\-cache\fR(8),
 410 \fBapt\-config\fR(8),
 411 \fBapt_preferences\fR(5).
 412 .SH "BOGUES"
 413 .PP
 414 Voyez la
 415 [1]\&\fI page concernant les bogues d'APT\fR. Si vous voulez signaler un bogue, consultez le texte
 416 \fI/usr/share/doc/debian/bug\-reporting.txt\fR
 417 ou utilisez la commande
 418 \fBreportbug\fR(1).
 419 .SH "TRADUCTION"
 420 .PP
 421 Jérôme Marant. 2000\ ; mise à jour : Philippe Batailler. 2005.
 422 <debian\-l10n\-french@lists.debian.org>.
 423 .SH "AUTHORS"
 424 .PP
 425 \fBJason Gunthorpe\fR
 426 .sp -1n
 427 .IP "" 3n
 428 Auteur.
 429 .PP
 430 \fBAPT team\fR
 431 .sp -1n
 432 .IP "" 3n
 433 Auteur.
 434 .SH "REFERENCES"
 435 .TP 3
 436 1.\ page concernant les bogues d'APT
 437 \%http://bugs.debian.org/src:apt