NAME
apt.conf - Fichier de configuration pour APT
Le fichier apt.conf est le fichier de configuration principal du
l'ensemble de programmes APT, mais n'est de loin pas le seul endroit o
des choix d'options peuvent tre effectus. Tous les outils partagent les
fichiers de configuration et utilisent galement une analyse commune de
la ligne de commande, ce qui permet de garantir un environnement
d'utilisation uniforme.
Lorsqu'un programme de l'ensemble APT est utilis, il lit le fichier de
configuration dans l'ordre suivant :
1. fichier indiqu par la variable d'environnement APT_CONFIG si elle
existe
2. tous les fichiers de Dir::Etc::Parts dans l'ordre alphanumrique
ascendant qui ont soit l'extension "conf", soit aucune extension et
qui ne contiennent que des caractres alphanumriques, des tirets
(-), des caractres de soulignement (_) et des points (.), les
autres fichiers tant ignors.
3. le fichier de configuration dfini par Dir::Etc::Main
4. les options de ligne de commande sont appliques pour remplacer les
directives de configuration ou pour charger d'autres fichiers de
configuration.
SYNTAXE
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. Il
n'y a pas d'hritage des options des groupes 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 traite comme un commentaire et ignore, de
mme que les sections de texte places entre /* et */, tout comme les
commentaires C/C++. Chaque ligne est de la forme : APT::Get::Assume-Yes
"true";. Le point-virgule final est obligatoire et les guillemets sont
optionnels. La valeur doit tenir sur une seule ligne et il n'existe pas
de fusion de chanes. Elle ne doit pas comporter de guillemets. Le
comportement du caractre barre oblique inverse "\" et les caractres
utiliss avec squence d'chappement dans une valeur ne sont pas
dterministes et devraient tre vits. Le nom d'une option peut contenir
des caractres alphanumriques et << /-:._+ >>. 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 une
liste en ouvrant un champ d'action et en y insrant une chane entre
guillemets suivie d'un point virgule pour chaque lment de la liste.
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
Les modles /usr/share/doc/apt/examples/apt.conf et
/usr/share/doc/apt/examples/configure-index.gz montrent quoi devrait
ressembler le fichier de configuration.
Les identifiants des options de configuration ne sont pas sensibles la
casse. Dans l'exemple prcdent, on pourrait donc aussi bien utiliser
dpkg::pre-install-pkgs.
Les noms des lments de configuration sont optionnels si une liste est
dfinie, comme cela peut se voir avec l'exemple DPkg::Pre-Install-Pkgs
prcdent. Si vous n'indiquez pas de nom, une nouvelle entre ajoutera une
nouvelle option la liste. Dans le cas contraire, l'option
correspondante peut tre remplace, comme toute autre option, en lui
raffectant une valeur.
Deux lments spciaux sont autoriss : #include (qui est obsolte et n'est
plus gr par des implmentations alternatives) et #clear. #include
inclut le fichier donn en paramtre, moins que le nom ne se termine par
une barre oblique auquel cas le rpertoire entier est inclus. #clear
sert effacer une partie de l'arbre de configuration. L'lment dsign et
tout ses descendants sont supprims. Veuillez noter que ces lignes
doivent galement se terminer avec un point-virgule.
La commande #clear est la seule faon de supprimer une liste ou un champ
d'action (<< scope >>). La rouverture d'un scope ou le style << ::- >>
dcrit plus loin ne remplaceront pas les entres crites prcdemment.
Seules les options peuvent tre remplaces en leur assignant une nouvelle
valeur. Les listes et les champs d'action ne peuvent tre remplacs mais
seulement effacs.
Tous les outils d'APT possdent une option -o qui permet de spcifier une
configuration quelconque depuis la ligne de commande. La syntaxe
consiste en un nom complet d'option (par exemple APT::Get::Assume-Yes)
suivi par un signe gal, puis par la nouvelle valeur de l'option. On
peut complter une liste en ajoutant un << :: >> au nom de la liste.
Comme on peut s'en douter, la syntaxe de champ d'action (<< scope >>)
ne peut pas tre indique la ligne de commande.
Veuillez noter que vous ne pouvez utiliser << :: >> que pour ajouter un
lment par ligne la liste et que cela ne devrait pas tre utilis en
combinaison avec la syntaxe de champ d'action (<< scope >>) qui inclut
implicitement << :: >>. L'utilisation simultane des deux syntaxes
dclenchera un bogue dont certains utilisateurs se servent comme d'une
fonctionnalit : une option avec le nom inhabituel << :: >> se
comportera comme toute autre option nomme. Cela risque d'avoir de
nombreux problmes comme consquence, par exemple si un utilisateur crit
plusieurs lignes avec cette syntaxe errone afin de faire un ajout la
liste, l'effet obtenu sera inverse puisque seule la dernire valeur pour
l'option << :: >> sera utilise. Les futures versions d'APT retourneront
une erreur et l'excution sera interrompue si cette utilisation
incorrecte est rencontre. Il est donc conseill de corriger ces dfauts
tant qu'APT ne s'en plaint pas explicitement.
LE GROUPE APT
Ce groupe d'options contrle le comportement global d'APT et contient
galement des options communes tous les outils.
Architecture
L'architecture du systme ; cette option positionne l'architecture
utiliser pour rcuprer des fichiers et analyser des listes de
paquets. La valeur interne par dfaut est l'architecture pour
laquelle APT a t compil.
Default-Release
Default release to install packages from if more than one version
available. Contains release name, codename or release version.
Examples: 'stable', 'testing', 'unstable', 'lenny', 'squeeze',
'4.0', '5.0*'. See also apt_preferences(5).
Ignore-Hold
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 du cache tout paquet qui ne peut plus tre
rcupr. 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
La valeur par dfaut de ce rglage est << on >> ce qui conduira APT
installer les paquets essentiels et importants ds que possible
pendant les oprations d'installation ou de mise jour. Cela permet
de limiter les consquences de l'chec d'un appel dpkg(1) : si cette
option est dsactive, APT grera un paquet important de la mme manire
qu'un paquet << extra >> ; entre le dpaquetage du paquet important
A et sa configuration pourront prendre place de nombreux autres
oprations de dpaquetage ou de configuration. Ainsi, si le paquet B,
qui n'a pas de rapport avec A, provoque une erreur de dpkg(1)
(p. ex. en cas d'erreur dans les scripts du responsable), le paquet
A sera alors dans l'tat install mais non configur et chaque paquet
qui en dpend ne fonctionnera plus ncessairement puisque sa
dpendance n'est pas satisfaite. Le marqueur de configuration
immdiate sera aussi utilis pour toute dpendance qui peut crer un
problme, par exemple les dpendances circulaires. En effet, utiliser
le marqueur de configuration immdiate revient grer une
pr-dpendance. Il est donc possible, en thorie, qu'APT rencontre une
situation o il lui est impossible d'effectuer la configuration
immdiate, qu'il se termine alors avec une erreur en faisant rfrence
cette option afin que l'utilisateur puisse la dsactiver
temporairement pour retenter l'opration d'installation ou de mise
jour. Il est noter que << en thorie >> indique ici que cette
situation n'a t rencontre que dans de rares cas, sur des versions
instables de distributions, la cause tant des dpendances
incorrectes ou un systme dj dans un tat instable. Il est donc
dconseill de dsactiver cette option sans rflchir car la situation
dcrite prcdemment n'est qu'un des cas o la configuration immdiate
permet de rsoudre des situations complexes. Avant de tenter une
opration telle que dist-upgrade avec cette option dsactive, il est
largement prfrable d'essayer une opration install sur le paquet
qu'APT ne peut configurer immdiatement. Il est galement conseill de
signaler ce type de problme dans le systme de suivi de bogues de la
distribution utilise afin qu'il soit tudi et corrig.
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 devrait jamais se produire : c'est
un bogue trs important. Cette option fonctionne si les paquets
essentiels ne sont pas tar, gzip, libc, dpkg, bash ou tous les
paquets dont ces paquets dpendent.
Cache-Start, Cache-Grow and Cache-Limit
APT uses since version 0.7.26 a resizable memory mapped cache file
to store the 'available' information. Cache-Start acts as a hint
to which size the Cache will grow and is therefore the amount of
memory APT will request at startup. The default value is 20971520
bytes (~20 MB). Note that these amount of space need to be
available for APT otherwise it will likely fail ungracefully, so
for memory restricted devices these value should be lowered while
on systems with a lot of configured sources this might be
increased. Cache-Grow defines in byte with the default of 1048576
(~1 MB) how much the Cache size will be increased in the event the
space defined by Cache-Start is not enough. These value will be
applied again and again until either the cache is big enough to
store all information or the size of the cache reaches the
Cache-Limit. The default of Cache-Limit is 0 which stands for no
limit. If Cache-Grow is set to 0 the automatic grow of the cache is
disabled.
Build-Essential
Cette option dfinit les paquets qui sont considrs comme faisant
partie des dpendances essentielles pour la construction de 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'outil apt-cdrom(8), veuillez
consulter sa documentation pour avoir plus d'informations sur les
options en question.
LE GROUPE ACQUIRE
Le groupe d'options Acquire contrle le tlchargement des paquets et les
gestionnaires d'URI.
Check-Valid-Until
Security related option defaulting to true as an expiring
validation for a Release file prevents longtime replay attacks and
can e.g. also help users to identify no longer updated mirrors -
but the feature depends on the correctness of the time on the user
system. Archive maintainers are encouraged to create Release files
with the Valid-Until header, but if they don't or a stricter value
is volitional the following Max-ValidTime option can be used.
Max-ValidTime
Seconds the Release file should be considered valid after it was
created. The default is "for ever" (0) if the Release file of the
archive doesn't include a Valid-Until header. If it does then this
date is the default. The date from the Release file or the date
specified by the creation time of the Release file (Date header)
plus the seconds specified with this options are used to check if
the validation of a file has expired by using the earlier date of
the two. Archive specific settings can be made by appending the
label of the archive to the option name.
PDiffs
Essayer de tlcharger les fichiers diffrentiels appels PDiffs pour
les paquets ou les fichiers sources, plutt que de les tlcharger
entirement. Par dfaut << true >>.
Deux sous-options permettant de limite l'utilisation de fichiers
<< pdiff >> sont galement disponibles. FileLimit permet d'indiquer
le nombre maximal de fichiers de diffrences peuvent tre tlchargs
pour modifier un fichier. SizeLimit permet par ailleurs de limiter
la taille combine des fichiers de diffrences rcuprs un certain
pourcentage du fichier modifier. Si une de ces limites est dpasse,
le fichier complet est tlcharg au lieu de tlcharger les fichiers de
diffrences.
Queue-Mode
Mode de file d'attente ; Queue-Mode peut prendre les valeurs host
ou access, ce qui dtermine comment APT paralllise les connexions
sortantes. Host signifie qu'une connexion par cible sera initie,
tandis que access signifie qu'une connexion par type d'URI sera
initie.
Retries
Nombre d'essais effectuer. Si ce nombre n'est pas nul, APT essaie
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://[[utilisateur][:mot_de_passe]@]hte[:port]/. On peut spcifier
un mandataire particulier par hte distant en utilisant la syntaxe :
http::Proxy::<hte>. Le mot-cl spcial DIRECT indique alors de
n'utiliser aucun mandataire pour l'hte. Si aucun des paramtres
prcdents n'est dfini, la variable d'environnement http_proxy annule
et remplace toutes les options de mandataire HTTP.
Trois options de configuration sont fournies pour le contrle des
caches compatibles avec HTTP/1.1. No-Cache signifie que le
mandataire ne doit jamais 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 ses fichiers d'index de
manire quotidienne ; la valeur par dfaut est donc de 1 jour.
No-Store sert uniquement pour les fichiers d'archive et 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 d'expiration du dlai
(timeout) utilis par la mthode. Cela vaut pour tout, connexion et
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, la valeur doit
gale 0. Dans le cas contraire, des donnes seront corrompues. Les
machines qui ont besoin de cette option ne respectent pas la RFC
2068.
La bande passante utilise peut tre limit avec
Acquire::http::Dl-Limit qui peut prendre une valeur entire, l'unit
utilise tant le kilo-octet. La valeur par dfaut est 0, ce qui
correspond aucune limitation de bande passante. Veuillez noter que
cette option dsactive implicitement le tlchargement simultan depuis
plusieurs serveurs.
L'option Acquire::http::User-Agent peut tre utilise pour envoyer
une valeur User-Agent modifie pour les tlchargements HTTP, ce qui
peut par exemple tre utile avec certains mandataires HTTP qui
n'autorisent l'accs qu'aux client s'identifiant de manire
spcifique..
https
URI HTTPS. Les options de contrle de cache, de dlai limite,
d'autorisation de redirection, de Dl-Limit et de mandataire (proxy)
sont les mmes que pour la mthode http. Les valeurs par dfaut sont
les mmes que pour l'option http sauf si des valeurs spcifiques
https sont indiques. L'option Pipeline-Depth n'est pas encore gre.
La sous-option CaInfo spcifie le fichier contenant les informations
sur les certificats de confiance. La sous-option boolenne
Verify-Peer prcise si le certificat d'hte du serveur doit tre
confront aux certificats de confiance ou pas. La sous-option
boolenne Verify-Host prcise s'il faut vrifier ou pas le nom d'hte
du serveur. SslCert dtermine le certificat utiliser pour
l'authentification du client. SslKey dtermine quelle clef prive
doit tre utilise pour l'authentification du client.
SslForceVersion surcharge la valeur par dfaut pour la version de
SSL utiliser et peut contenir l'une des chanes 'TLSv1' ou 'SSLv3'.
ftp
URI FTP ; ftp::Proxy est le mandataire (proxy) FTP utiliser par
dfaut. Il se prsente sous la forme standard :
ftp://[[user][:pass]@]host[:port]/. On peut spcifier un mandataire
particulier par hte distant en utilisant la syntaxe :
ftp::Proxy::<hte>. Le mot-cl spcial DIRECT indique alors de
n'utiliser aucun mandataire pour l'hte. Si aucun des paramtres
prcdents n'est dfinis, la variable d'environnement ftp_proxy annule
et replace toutes les options de mandataire FTP. Pour utiliser un
mandataire FTP, vous devrez renseigner l'entre ftp::ProxyLogin dans
le fichier de configuration. Cette entre spcifie les commandes
envoyer au mandataire pour lui prciser quoi il doit se connecter.
Voyez /usr/share/doc/apt/examples/configure-index.gz pour savoir
comment faire. Les variables de substitution disponibles sont :
$(PROXY_USER), $(PROXY_PASS), $(SITE_USER), $(SITE_PASS), $(SITE)
et $(SITE_PORT). Chacune correspond l'lment respectif de l'URI.
L'option timeout positionne le compteur d'expiration du dlai
(timeout) utilis par la mthode. Cela vaut pour tout, connexion et
donnes.
Plusieurs options de configuration sont fournies pour contrler le
mode passif. Il est gnralement plus sr d'activer le mode passif et
cela marche dans presque tous les environnements. Cependant,
certaines situations ncessitent que le mode passif soit dsactiv 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 spcifique (examinez le modle de
fichier de configuration).
Il est possible de faire transiter le trafic FTP par un mandataire
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 le faire dans le fichier de configuration
et il n'est de toute faon pas recommand d'utiliser FTP au travers
de HTTP en raison de la faible efficacit de cette mthode.
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 CD ; la seule option de configuration pour les URI de CD est le
point de montage : cdrom::Mount ; il doit reprsenter le point de
montage du lecteur de CD-ROM indiqu dans /etc/fstab. D'autres
commandes de montage et de dmontage peuvent tre fournies 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.
CompressionTypes
Cette option indique la liste des types de compression comprises
par les mthodes d'acquisition. Des fichiers comme Packages peuvent
tre disponibles dans divers formats de compression. Par dfaut, les
mthodes d'acquisition dcompressent les fichiers compresss avec
bzip2, lzma et gzip. Ce rglage permet d'ajouter la vole des
formats supplmentaires ou de modifier la mthode utilise. La syntaxe
utiliser est :
Acquire::CompressionTypes::ExtensionFichier "NomMethode";
Le sous-groupe Order peut tre galement utilis pour dfinir l'ordre
dans lequel le systme d'acquisition tentera de tlcharger les
fichiers compresss. Le premier systme mentionn sera essay en
premier, puis le suivant en cas d'chec. Ainsi, pour privilgier un
format par rapport un autre, il suffit de le placer en premier
dans cette liste. Les types par dfaut qui ne sont pas dj indiqus
seront ajouts en fin de liste au moment de l'excution. Ainsi, par
exemple,
Acquire::CompressionTypes::Order:: "gz";
peut tre utiliser de prfrence les fichiers compresss avec gzip par
rapport bzip2 et lzma. Si l'objectif est d'utiliser lzma en priorit
par rapport gzip et bzip2, ce rglage doit ressembler
Acquire::CompressionTypes::Order { "lzma"; "gz"; };
. Il est inutile d'ajouter explicitement bz2
liste car il sera ajout automatiquement.
Veuillez noter qu' l'excution, Dir::Bin::Methodname sera vrifi : si
ce rglage existe, la mthode ne sera utilise que si ce fichier
existe. Ainsi, pour la mthode bzip2, le rglage (utilis en interne)
est
Dir::Bin::bzip2 "/bin/bzip2";
. Veuillez galement noter que les lments de liste indiqus la ligne
de commande seront ajouts la fin de la liste indique dans les
fichiers de configuration, mais avant les valeurs par dfaut. Dans
ce cas, pour tablir une prfrence par rapport aux types mentionns
dans les fichiers de configuration, il est possible de placer
l'option directement, pas sous forme de liste. Cela ne remplacera
pas la liste par dfaut mais elle sera simplement prfixe avec
l'option en question.
Bien qu'il soit possible d'ajouter un type vide de compression la
liste ordonne, APT ne l'interprtera pas correctement et affichera
de nombreux messages d'avertissement propos d'chec de
tlchargement, qui sont le plus souvent des avertissements sans
consquences. Dans de futures versions, il deviendra rellement
possible d'tablir une prfrence pour des fichiers non compresss afin
de grer des miroirs locaux.
GzipIndexes
When downloading gzip compressed indexes (Packages, Sources, or
Translations), keep them gzip compressed locally instead of
unpacking them. This saves quite a lot of disk space at the expense
of more CPU requirements when building the local package caches.
False by default.
Langues
La sous-section << Languages >> contrle quels fichiers Translation
sont tlchargs et dans quel ordre APT les utilisera pour afficher
les traductions de descriptions. APT recherchera d'abord la premire
traduction disponible pour le champ Description dans la langue
choisie en premier. Les langues peuvent tre indiques par leur code
long ou court. Veuillez noter que tous les dpts ne fournissent pas
les fichiers Translation pour toutes les langues, particulirement
pour les codes rarement utiliss. Il est donc conseill de vous
renseigner sur ce qui est disponible avant d'tablir des rglages
impossibles.
La liste par dfaut contient << environment >> and << en >>. La
valeur << environment >> a une signification spciale : elle sera
remplace, l'excution, par les codes de langues utiliss dans la
variable d'environnement LC_MESSAGES. Les codes utiliss en double
ne seront pas inclus deux fois dans la liste. Si LC_MESSAGES
contient << C >>, seul le fichier Translation-en sera utilis, s'il
est disponible. Pour forcer APT n'utiliser aucun fichier de
traduction, il est ncessaire d'utiliser le rglage
Acquire::Languages=none. La valeur << none >> a une signification
spciale et indique de ne rechercher aucun fichier Translation. Cela
permet l'administrateur local d'indiquer APT de tlcharger des
fichiers sans les utiliser si la variable d'environnement ne les
comporte pas. Ainsi, dans l'exemple qui suit, l'ordre utilis sera
<< en, fr >> si dans un environnement configur pour l'anglais et
<< fr, en >> pour un environnement configur en franais. Les
fichiers pour l'allemand seront galement tlchargs mais ne sont
utiliss que dans un environnement configur pour l'allemand. Dans ce
dernier cas, l'ordre est alors << de, fr, en >>.
Acquire::Languages { "environment"; "fr"; "en"; "none"; "de"; };
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(1). 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, ainsi que l'endroit o sont places les archives tlcharges,
Dir::Cache::archives. On peut empcher la cration des caches en
saisissant un nom vide. Cela ralentit le dmarrage mais conomise 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,
sourcelist indique l'emplacement de la liste de sources et main est le
fichier de configuration par dfaut (le modifier n'a aucun effet, moins
qu'on ne le modifie avec le fichier de configuration indiqu par la
variable APT_CONFIG).
Dir::Parts lit, par ordre d'entre, tous les fragments de configuration
dans le rpertoire indiqu. Ensuite, le fichier principal de
configuration est charg.
Les programmes binaires sont points par Dir::Bin. L'emplacement des
gestionnaires de mthodes est indiqu par Dir::Bin::Methods ; gzip,
bzip2, lzma, dpkg, apt-get, dpkg-source, dpkg-buildpackage et apt-cache
indiquent l'emplacement des programmes correspondants.
L'option de configuration RootDir a une signification particulire.
Lorsqu'elle est dfinie, tous les chemins dclars dans Dir:: sont
considrs relativement RootDir, mme les chemins spcifis de manire
absolue. Ainsi par exemple si RootDir est dfini comme /tmp/staging, et
que chemin du fichier d'tat Dir::State::status est dclar comme
/var/lib/dpkg/status alors ce fichier sera cherch dans
/tmp/staging/var/lib/dpkg/status.
The Ignore-Files-Silently list can be used to specify which files APT
should silently ignore while parsing the files in the fragment
directories. Per default a file which end with .disabled, ~, .bak or
.dpkg-[a-z]+ is silently ignored. As seen in the last default value
these patterns can use regular expression syntax.
APT ET DSELECT
Quand APT est utilis comme une mthode de dselect(1), 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 comme options de ligne de
commande apt-get(8) lors de la phase d'installation.
UpdateOptions
Le contenu de cette variable est pass comme options de ligne de
commande apt-get(8) lors de la phase de mise jour.
PromptAfterUpdate
Si cette option est << true >>, l'opration [U]pdate de dselect(1)
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.
METHODE D'APPEL DE DPKG PAR APT
Plusieurs directives de configuration contrlent la manire dont APT
invoque dpkg(1) : elles figurent dans la section DPkg.
options
Il s'agit d'une liste d'options passer dpkg(1). Les options
doivent tre dclares en utilisant la notation de liste et chaque
lment de la liste est pass comme un seul paramtre dpkg(1).
Pre-Invoke, Post-Invoke
Il s'agit d'une liste de commandes shell excuter avant ou aprs
l'appel de dpkg(1). 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(1). 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
standard, APT transmet aux commandes les noms de tous les fichiers
.deb qu'il va installer, raison d'un par ligne.
La deuxime 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 DPkg::Tools::Options::cmd::Version
2. cmd est une commande passe Pre-Install-Pkgs.
Run-Directory
APT se place dans ce rpertoire avant d'appeler dpkg(1) ; par dfaut,
c'est le rpertoire /.
Build-options
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.
utilisation des actions diffres (<< triggers >>) de dpkg (et options
associes)
APT peut lancer dpkg pour utiliser les actions diffres de manire
agressive entre les appels successifs dpkg. Sans options
supplmentaires, dpkg n'utilisera les actions diffres que dans le cadre
de sa propre excution. Si ces options sont utilises, le temps
d'excution peut diminuer fortement dans les actions d'installation ou
de mise jour. Il est prvu de les activer par dfaut dans le futur mais
tant donn qu'elles changent notablement la mthode qu'utilise APT pour
lancer dpkg, elles ont besoin d'importantes validations. Ces options
sont donc exprimentales et ne devraient pas tre utilises avec des
environnements de production.. Elles modifient galement le suivi de
progression et toutes les interfaces passeront la moiti du temps un
tat termin 100% pendant la configuration des paquets.
Veuillez noter que rien ne garantit qu'APT grera encore ces options
dans le futur ou qu'elles ne provoqueront pas de nombreux dgts. Si vous
avez bien compris les implications de ce choix et tes suffisamment
motiv(e) pour essayer ces options, il vous est donc possible de crer un
nouveau fichier de configuration et essayer une combinaison de ces
options. Veuillez signaler tout bogue, problmes ou suggestions
d'amlioration en prenant soin de mentionner les options utilises.
Utiliser l'aide apporte par dpkg peut galement tre utile pour le
dbogage, par exemple dpkg --audit. Une combinaison intressante
d'options pourrait tre
DPkg::NoTriggers "true";
PackageManager::Configure "smart";
DPkg::ConfigurePending "true";
DPkg::TriggersPending "true";
.
DPkg::NoTriggers
Ajoute l'option << no-triggers >> tous les appels dpkg (hormis
l'appel << ConfigurePending >>). Voir dpkg(1) pour plus
d'informations sur la signification de cette option. En rsum, dpkg
n'effectuera pas les actions diffres (<< triggers >>) si cette
option est utilise sauf si cela est demand explicitement dans une
invocation supplmentaire. Cette option existe en fait dj (mais
n'est pas documente) dans de plus anciennes version d'APT avec une
signification lgrement diffrente : elle n'ajoutait l'option
<< --no-triggers >> qu'aux appels de dpkg avec << configure >>
alors que cela sera dsormais utilis galement avec les appels dpkg
avec les options << unpack >> et << remove >>.
PackageManager::Configure
Les valeurs possibles sont << all >>, << smart >> et << no >>. La
valeur par dfaut est << all >> o APT configure explicitement tous
les paquets. La valeur << smart >> permet de ne configurer que les
paquets qui ont besoin de l'tre avant la dcompaction d'un autre
paquet ( cause d'une pr-dpendance) ; les autres configurations sont
laisses pour un appel ultrieur dpkg. L'option << no >> ne
provoquera aucune configuration et s'en remettra totalement dpkg
pour ces oprations (ce qui chouera en cas de pr-dpendances). Si
cette option est dfinie sur une valeur diffrente de << all >>,
l'option suivante sera active par dfaut pour viter de placer le
systme dans un tat non configur et donc ventuellement non amorable.
DPkg::ConfigurePending
Si cette option est choisie, APT lancera dpkg --configure --pending
pour laisser dpkg grer les configurations de paquets et les actions
diffres. Cette option est automatiquement active si l'option
prcdente a une valeur diffrente de << all >>. Il peut par contre
tre utile de la dsactiver pour lancer APT plusieurs fois
successives, par exemple quand il est utilis depuis un outil
d'installation. Dans ce cas, seul le dernier de tous les appels
successifs peut conserver l'option active.
DPkg::TriggersPending
Cette option est utile pour la configuration en mode << smart >>.
En effet, un paquet qui a des actions diffres (<< triggers >>) en
attente n'est pas considr comme install (tat << installed >>) et
dpkg le considre actuellement comme simplement dcompact (tat
<< unpacked >>) ce qui empche une gestion correcte des
pr-dpendances (voir le bogue Debian #526774). Veuillez noter que
cette option provoquera la gestion de toutes les actions diffres,
pas seulement celles concernant le paquet en cours de traitement.
PackageManager::UnpackAll
Cette option permet de ne trier les oprations de dcompactage qu'en
fonction de leur criticit (c'est dire en ne considrant que les
pr-dpendances) dans le cas o la configuration des paquets est
diffre pour n'tre effectue qu' la fin par dpkg. Cette option est
active par dfaut, ce qui revient la mthode traditionnelle o les
oprations ont lieu en plusieurs tapes, selon l'ensemble des critres
de tri. Bien que les deux mthodes existent mme dans les versions,
la mthode << OrderCritical >> n'tait pas utilise. Elle doit donc
tre considre comme trs exprimentale et a besoin de nombreuses
amliorations avant de devenir rellement utile. (Note du
traducteur : la version originale de cette partie des pages de
manuel est trs confuse. Il est donc conseill de s'y reporter en cas
de doute car le contresens de traduction n'est pas exclu...).
OrderList::Score::Immediate
Les paquets essentiels (et leurs dpendances) devraient tre
configurs aprs avoir t dcompresss. Il est conseill que cette
opration ait lieu le plus tt possible dans le processus de mise
jour car ces oprations de configuration ncessitent galement
DPkg::TriggersPending, ce qui peut conduire l'excution de certains
actions diffres qui ne sont pas ncessairement utiles. Les paquets
essentiels obtiennent par dfaut un score lev mais le marqueur
<< immdiat >> implique un score assez bas (par exemple un paquet
qui comporte des prdpendances obtient un score plus lev). Cette
option et les options du mme groupe permettent de modifier la faon
d'attribuer un score. L'exemple ci-dessous indique ces rglages avec
leurs valeurs par dfaut.
OrderList::Score {
Delete 500;
Essential 200;
Immediate 10;
PreDepends 50;
};
OPTIONS << PERIODIC >> ET << ARCHIVE >>
Les groupes d'options APT::Periodic et APT::Archive configurent les
comportements priodiques raliss par le script /etc/cron.daily/apt, lanc
quotidiennement.
LES OPTIONS DE DBOGAGE
Les options de la section Debug:: servent soit provoquer l'affichage
d'informations de dbogage sur la sortie d'erreur standard du programme
qui utilise les librairies APT, soit activer des modes de
fonctionnement spciaux qui sont principalement utiles pour dboguer le
comportement de APT. La plupart de ces options n'ont pas d'intrt pour
un utilisateur normal, mais certaines peuvent tout de mme tre utiles :
o Debug::pkgProblemResolver affiche d'intressantes informations sur
les dcisions prises par les commandes dist-upgrade, upgrade,
install, remove et purge.
o Debug::NoLocking dsactive le verrouillage de fichier de manire ce
qu'APT puisse effectuer quelques oprations (telles que apt-get -s
install) sans avoir les privilges du superutilisateur.
o Debug::pkgDPkgPM affiche la ligne de commande chaque appel de
dpkg(1).
o
Debug::IdentCdrom dsactive l'inclusion de donnes de type statfs
dans les identifiants de CD.
Liste complte des options de dbogage de APT :
Debug::Acquire::cdrom
Affiche les informations concernant les sources de type cdrom://
Debug::Acquire::ftp
Affiche les informations concernant le tlchargement de paquets par
FTP.
Debug::Acquire::http
Affiche les informations concernant le tlchargement de paquets par
HTTP.
Debug::Acquire::https
Print information related to downloading packages using HTTPS.
Debug::Acquire::gpgv
Affiche les informations relatives la vrification de signatures
cryptographiques avec gpg.
Debug::aptcdrom
Affiche des informations concernant l'accs aux collections de
paquets stockes sur CD.
Debug::BuildDeps
Dcrit le processus de rsolution des dpendances pour la construction
de paquets source ( << build-dependencies >> ) par apt-get(8).
Debug::Hashes
Affiche toutes les clefs de hachage cryptographiques cres par les
librairies d'apt.
Debug::IdentCDROM
Dsactive l'inclusion des donnes de type statfs pour la gnration des
identifiants de CD, c'est--dire le nombre de blocs libres et
utiliss sur le systme de fichier du CD.
Debug::NoLocking
Dsactive le verrouillage de fichiers. Cela permet par exemple de
lancer deux instances de "apt-get update" en mme temps.
Debug::pkgAcquire
Trace les ajouts et suppressions d'lments de la queue globale de
tlchargement.
Debug::pkgAcquire::Auth
Affiche les dtails de la vrification des sommes de contrle et des
signatures cryptographiques des fichiers tlchargs, ainsi que les
erreurs ventuelles.
Debug::pkgAcquire::Diffs
Affiche les informations de tlchargement et de prise en compte des
fichiers diffrentiels des indexes de paquets, ainsi que les erreurs
ventuelles.
Debug::pkgAcquire::RRed
Affiche les dtails de l'application des fichiers de diffrences aux
listes de paquets d'APT quand ces fichiers de diffrences sont
tlchargs la place des fichiers complets.
Debug::pkgAcquire::Worker
Affiche toutes les interactions avec les processus enfants qui se
chargent effectivement des tlchargements.
Debug::pkgAutoRemove
Affiche les changements concernant le marquage des paquets comme
installs automatiquement, et la suppression des paquets inutiles.
Debug::pkgDepCache::AutoInstall
Cre les informations de dbogage dcrivant quels paquets sont
installs automatiquement pour satisfaire les dpendances. Cela
concerne la passe initiale d'installation automatique effectue par
exemple par apt-get install et pas le systme de rsolution de
dpendances complet de APT ; voir Debug::pkgProblemResolver pour ce
dernier.
Debug::pkgDepCache::Marker
Cre les informations de dbogage dcrivant quels paquets sont
gards/installs/supprims pendant le travail de l'outil de rsolution
de problmes. Chaque ajout ou suppression peut impliquer des actions
supplmentaires ; elles sont alors indiques avec une indentation de
deux espaces de plus que l'action qui les a dclenches. Le format de
chaque ligne est MarkKeep, MarkDelete ou MarkInstall suivi de
nom-paquet <a.b.c -> d.e.f | x.y.z> (section) o a.b.c est la
version actuelle du paquet, d.e.f la version devant tre installe et
x.y.z une version plus rcente qui n'est pas prvue pour tre installe
( cause d'un score plus faible). Ces deux derniers lments peuvent
ne pas tre mentionns s'ils ne sont pas pertinents o lorsque ils
sont identiques la version installe. section est le nom de la
section o figure le paquet.automatiquement pour satisfaire les
dpendances. Cela concerne la passe initiale d'installation
automatique effectue par exemple par apt-get install et pas le
systme de rsolution de dpendances complet de APT ; voir
Debug::pkgProblemResolver pour ce dernier.
Debug::pkgInitConfig
Affiche, au lancement, l'ensemble de la configuration sur la sortie
d'erreur standard.
Debug::pkgDPkgPM
Affiche la commande exacte d'invocation de dpkg(1)
chaque appel ; les paramtres sont spars par des espaces.
Debug::pkgDPkgProgressReporting
Affiche l'ensemble des informations reues de dpkg(1) par
l'intermdiaire du descripteur de fichier d'tat, et les ventuelles
erreurs d'analyse de ce fichier.
Debug::pkgOrderList
Affiche les tapes de l'algorithme utilis pour choisir l'ordre dans
lequel apt passe les paquets dpkg(1).
Debug::pkgPackageManager
Affiche le dtail des oprations lies l'invocation de dpkg(1).
Debug::pkgPolicy
Affiche, au lancement, la priorit de chaque liste de paquets.
Debug::pkgProblemResolver
Affiche la trace d'excution du systme de rsolution de dpendances
(ne concerne que les cas o un problme de dpendances complexe se
prsente).
Debug::pkgProblemResolver::ShowScores
Affiche la liste de tous les paquets installs avec leur score
calcul par l'outil de rsolution de problmes. La description du
paquet est celle qui est dcrite dans Debug::pkgDepCache::Marker.
Debug::sourceList
Affiche les fournisseurs dclars dans le fichier
/etc/apt/vendors.list.
EXEMPLES
Le fichier /usr/share/doc/apt/examples/configure-index.gz contient un
modle de fichier montrant des exemples pour toutes les options
existantes.
FICHIERS
/etc/apt/apt.conf
Fichier de configuration d'APT. lment de configuration :
Dir::Etc::Main.
/etc/apt/apt.conf.D/
Fragments du fichier de configuration d'APT. lment de
configuration : Dir::Etc::Parts.
VOIR AUSSI
apt-cache(8), apt-config(8), apt_preferences(5).
BOGUES
Page des bogues d'APT[1]. Si vous souhaitez signaler un bogue propos
d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou
utiliser la commande reportbug(1).
TRADUCTEURS
Jrme Marant, Philippe Batailler, Christian Perrier bubulle@debian.org
(2000, 2005, 2009, 2010), quipe de traduction francophone de Debian
debian-l10n-french@lists.debian.org
Veuillez noter que cette traduction peut contenir des parties non
traduites Cela est volontaire, pour viter de perdre du contenu quand la
traduction est lgrement en retard sur le contenu d'origine.
AUTHORS
Jason Gunthorpe
quipe de dveloppement d'APT
Daniel Burrows <dburrows@debian.org>
Documentation d'origine de Debug::*.
NOTES
1. Page des bogues d'APT
http://bugs.debian.org/src:apt