DESCRIPTION
Le fichier 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 dmarre, il lit (si elle existe) la variable d'environnement
APT_CONFIG ; puis il lit les fichiers situs dans Dir::Etc::Parts ainsi
que le principal fichier de configuration indiqu par Dir::Etc::main ;
enfin il applique les options de la ligne de commande qui annulent les
directives de configuration, chargeant, si ncessaire, d'autres fichiers
de configuration.
Le fichier de configuration est construit comme un arbre d'options
organises en groupes fonctionnels. On se sert du double deux points
( :: ) pour indiquer une option ; par exemple, APT::Get::Assume-Yes est
une option pour le groupe d'outils APT, destine l'outil Get. Les
options n'hritent pas des groupes de leurs parents.
Syntaxiquement, le langage de configuration est conu sur le mme modle
que les langages utiliss par des outils ISC tels que bind et dhcp. Une
ligne qui commence par // est un commentaire et elle est ignore. Chaque
ligne est de la forme : APT::Get::Assume-Yes "true"; Le point-virgule
final est obligatoire et les guillemets sont optionnels. On peut
dclarer un nouveau champ d'action avec des accolades, comme suit :
APT {
Get {
Assume-Yes "true";
Fix-Broken "true";
};
};
avec des retours la ligne pour faciliter la lecture. On peut crer 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 entres,
spares par un point-virgule.
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
Les modles /usr/share/doc/apt/examples/apt.conf
/usr/share/doc/apt/examples/configure-index.gz montrent quoi devrait
ressembler le fichier de configuration.
Deux lments spciaux sont autoriss : #include et #clear. #include
inclut le fichier donn en argument, moins que le nom ne se termine par
une barre oblique. #clear sert effacer une liste de noms.
Tous les outils d'APT possdent une option -o qui permet de spcifier une
configuration arbitraire depuis la ligne de commande. La syntaxe
consiste en un nom complet d'option (par exemple APT::Get::Assume-Yes)
Ignore les paquets gels ; cette option globale indique au systme
de rsolution de ne pas tenir compte des paquets gels dans sa prise
de dcision.
Clean-Installed
Avec cette option qui est active par dfaut, la fonctionnalit
autoclean supprime tout paquet qui ne peut plus tre rcupr dans le
cache. Quand cette option est dsactive, les paquets qui sont
installs localement sont aussi exclus du nettoyage - mais notez que
APT ne fournit aucun moyen direct pour les rinstaller.
Immediate-Configure
Dsactive la configuration immdiate ; cette dangereuse option
dsactive 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
ncessaire sur des systmes lents un seul utilisateur mais c'est
extrmement dangereux et cela peut faire chouer les scripts
d'installation, voire pire. Utilisez-la vos risques et prils.
Force-LoopBreak
Ne jamais activer cette option moins que vous ne sachiez -
rellement - 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 SRIEUX. Cette option fonctionne si les paquets essentiels ne
sont pas tar, gzip, libc, dpkg, bash ou tous les paquets dont ces
paquets dpendent.
Cache-Limit
APT utilise un fichier cache d'une taille mmoire fixe pour ranger
les informations du fichier available . Cette option fixe la taille
de ce cache.
Build-Essential
Cette option dfinit les paquets qui sont considrs comme faisant
partie des dpendances essentielles pour la construction des paquets.
Get
La sous-section Get contrle l'outil apt-get(8), veuillez consulter
sa documentation pour avoir plus d'informations sur les options en
question.
Cache
La sous-section Cache contrle l'outil apt-cache(8), veuillez
consulter sa documentation pour avoir plus d'informations sur les
options en question.
CDROM
La sous-section CDROM contrle l'outilapt-cdrom(8), veuillez
consulter sa documentation pour avoir plus d'informations sur les
options en question.
de rcuprer, le nombre donn de fois, les fichiers dont la rcupration
a chou.
Source-Symlinks
Utilise des liens symboliques pour les archives de sources.
Positionne true , cette option cre si possible des liens
symboliques vers les archives de sources au lieu de les copier. Par
dfaut true .
http
URI HTTP ; http::Proxy est le mandataire (proxy) http utiliser par
dfaut. Il se prsente sous la forme standard :
http://[[user][:pass]@]host[:port]/. En utilisant la syntaxe :
http::Proxy::<host>, o le mot-cl spcial DIRECT indique de n'utiliser
aucun mandataire, on peut spcifier un mandataire pour chaque machine
distante. La variable d'environnement http_proxy remplace tous ces
paramtres.
Trois options de configuration sont fournies pour le contrle des
caches qui sont compatibles avec HTTP/1.1. No-Cache signifie que le
mandataire ne doit pas du tout utiliser les rponses qu'il a
stockes ; Max-Age sert uniquement pour les fichiers d'index : cela
demande au cache de les mettre jour quand leur anciennet est
suprieure au nombre de secondes donn. Debian met jour son fichier
d'index de manire journalire, la valeur par dfaut est donc de 1
jour. No-Store sert uniquement pour les fichiers d'archive : cela
demande au cache de ne jamais garder la requte. Cela peut viter de
polluer un cache mandataire avec des fichiers .deb trs grands.
Note : Squid 2.0.2 ne prend en compte aucune de ces options.
L'option timeout positionne le compteur de temps mort (timeout)
utilis par la mthode : cela vaut pour tout (connexion, donnes).
Une option de configuration est fournie pour contrler 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 requtes
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 donnes seront corrompues. Les machines
qui ont besoin de cette option ne respectent pas la RFC 2068.
ftp
URI FTP ; ftp::Proxy est le serveur mandataire par dfaut utiliser.
Il se prsente sous la forme standard :
ftp://[[user][:pass]@]host[:port]/ ; il est remplac par la variable
d'environnement ftp_proxy. Pour utiliser un mandataire ftp, vous
devez renseigner l'entre ftp::ProxyLogin dans le fichier de
configuration. Cette entre spcifie les commandes qui disent au
serveur mandataire comment se connecter. Voyez
/usr/share/doc/apt/examples/configure-index.gz pour savoir comment
faire. Les variables de substitution disponibles sont :
On peut utiliser un mandataire FTP pour atteindre une cible HTTP en
positionnant la variable d'environnement ftp_proxy une url http --
consultez la mthode 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.
L'option ForceExtended contrle l'utilisation des commandes lies la
RFC 2428, EPSV et EPRT. Par dfaut, elle vaut false ; ce qui
signifie que ces commandes ne sont utilises que pour une connexion
de type IPv6. Quand elle vaut true , on les utilise mme si la
connexion est de type IPv4. La plupart des serveurs FTP ne suivent
pas la RFC 2428.
cdrom
URI CDROM ; la seule option de configuration pour les URI de CDROM
est le point de montage : cdrom::Mount ; il doit reprsenter le point
de montage du lecteur de cdrom indiqu dans /etc/fstab. On peut
fournir d'autres commandes de montage et de dmontage quand le point
de montage ne peut tre list dans le fichier /etc/fstab (par exemple,
un montage SMB). Syntaxiquement, il faut placer
"/cdrom/"::Mount "foo";
dans le bloc cdrom. La barre oblique finale est importante. Les
commandes de dmontage peuvent tre spcifies en utilisant UMount.
gpgv
URI GPGV ; la seule option pour les URI GPGV est celle qui permet de
passer des paramtres gpgv. gpgv::Options Options supplmentaires
passes gpgv.
LES RPERTOIRES
Les rpertoires de la section Dir::State concernent le systme local.
lists est le rpertoire o placer les listes de paquets tlchargs et
status est le nom du fichier d'tat de Dpkg. preferences concerne APT :
c'est le nom du fichier des prfrences. Dir::State contient le
rpertoire par dfaut prfix tous les sous-lments, quand ceux-ci ne
commencent pas par / ou ./.
Dir::Cache contient les emplacements qui renseignent sur le cache
local : par exemple, les deux caches de paquets srcpkgcache et
pkgcache, et aussi l'endroit o sont places les archives tlcharges,
Dir::Cache::archives. On peut empcher la cration des caches en laissant
leur nom en blanc. Cela ralentit le dmarrage mais cela sauve de
l'espace disque. Il vaut mieux se passer du cache pkgcache plutt que se
passer du cache srcpkgcache. Comme pour Dir::State, le rpertoire par
dfaut est contenu dans Dir::Cache.
Dir::Etc contient l'emplacement des fichiers de configuration,
APT ET DSELECT
Quand APT est utilis comme une mthode de dselect(8), plusieurs
directives contrlent le comportement par dfaut. On les trouve dans la
section DSelect.
Clean
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
aprs la mise niveau ; prompt (valeur par dfaut) les supprime aprs
une demande et auto ne supprime que les archives qui ne peuvent
plus tre tlcharges (remplaces, par exemple, par une nouvelle
version). pre-auto les supprime avant de rcuprer de nouveaux
paquets.
Options
Le contenu de cette variable est pass apt-get(8) avec les options de
la ligne de commande quand ce programme est utilis dans la phase
d'installation.
UpdateOptions
Le contenu de cette variable est pass apt-get(8) avec les options de
la ligne de commande quand ce programme est utilis dans la phase de
mise jour.
PromptAfterUpdate
Si cette option est vraie , l'opration [U]pdate de dselect(8)
interroge toujours l'utilisateur avant de continuer. Par dfaut, ce
n'est qu'en cas d'erreur que l'on propose l'utilisateur
d'intervenir.
COMMENT APT APPELLE DPKG
Plusieurs directives de configuration contrlent la manire dont APT
invoque dpkg(8) : elles figurent dans la section DPkg.
Options
Il s'agit d'une liste d'options passer dpkg. Les options doivent
tre dclares en utilisant la notation de liste et chaque lment de
liste est pass comme un seul argument dpkg(8).
Pre-Invoke, Post-Invoke
Il s'agit d'une liste de commandes shell excuter avant ou aprs
l'appel de dpkg(8). Tout comme pour Options, on doit utiliser la
notation de liste. Les commandes sont appeles dans l'ordre, en
utilisant /bin/sh : APT s'arrte ds que l'une d'elles choue.
Pre-Install-Pkgs
Il s'agit d'une liste de commandes shell excuter avant d'appeler
Dpkg. Tout comme pour Options, on doit utiliser la notation de
liste. Les commandes sont appeles dans l'ordre, en utilisant
/bin/sh : APT s'arrte ds que l'une d'elles choue. Sur l'entre
Ces options sont passes dpkg-buildpackage(1) lors de la compilation
des paquets ; par dfaut la signature est dsactive et tous les
binaires sont crs.
LES OPTIONS DE DBOGAGE
La plupart des options de la section debug n'ont aucun intrt pour le
simple utilisateur ; cependant, Debug::pkgProblemResolver affiche
d'intressantes informations sur les dcisions que prend la commande
dist-upgrade. Debug::NoLocking dsactive le verrouillage de fichier de
manire ce que APT puisse effectuer quelques oprations sans tre root
et Debug::pkgDPkgPM affiche la ligne de commande chaque appel de Dpkg.
Debug::IdentCdrom dsactive l'inclusion de donnes de type statfs dans
les ID de CDROM. Debug::Acquire::gpgv Dbogage de la mthode gpgv.
EXEMPLES
Le fichier /usr/share/doc/apt/examples/configure-index.gz contient un
modle de fichier montrant les valeurs par dfaut de toutes les options
possibles.
FICHIERS
/etc/apt/apt.conf
VOIR AUSSI
apt-cache(8), apt-config(8), apt_preferences(5).
BOGUES
Voyez la [1] page concernant les bogues d'APT. Si vous voulez signaler
un bogue, consultez le texte /usr/share/doc/debian/bug-reporting.txt ou
utilisez la commande reportbug(1).
TRADUCTION
Jrme Marant. 2000 ; mise jour : Philippe Batailler. 2005.
<debian-l10n-french@lists.debian.org>.
AUTHORS
Jason Gunthorpe
Auteur.
APT team
Auteur.
REFERENCES
1. page concernant les bogues d'APT
http://bugs.debian.org/src:apt
Linux 29 Fvrier 2004 APT.CONF(5)
Man(1) output converted with
man2html