doc/fr/apt-cache.8

   1 .\"     Title: apt\-cache
   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\-CACHE" "8" "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\-cache \- Gestion des paquets et manipulation du cache par APT
  15 .SH "SYNOPSIS"
  16 .HP 10
  17 \fBapt\-cache\fR [\fB\-hvsn\fR] [\fB\-o=\fR\fB\fIoption\ de\ configuration\fR\fR] [\fB\-c=\fR\fB\fIfichier\fR\fR] {[add\ \fIfichier\fR...] | [gencaches] | [showpkg\ \fIpaquet\fR...] | [showsrc\ \fIpaquet\fR...] | [stats] | [dump] | [dumpavail] | [unmet] | [search\ \fIregex\fR] | [show\ \fIpaquet\fR...] | [depends\ \fIpaquet\fR...] | [rdepends\ \fIpaquet\fR...] | [pkgnames\ \fIprefix\fR] | [dotty\ \fIpaquet\fR...] | [policy\ \fIpaquets\fR...] | [madison\ \fIpaquets\fR...]}
  18 .SH "DESCRIPTION"
  19 .PP
  20
  21 \fBapt\-cache\fR
  22 réalise différentes opérations sur le cache de paquet d' APT.
  23 \fBapt\-cache\fR
  24 ne manipule pas l'état du système mais fournit des moyens de recherche dans les métadonnées d'un paquet desquelles il extrait d'intéressantes informations.
  25 .PP
  26 À moins que l'option
  27 \fB\-h\fR
  28 ou
  29 \fB\-\-help\fR
  30 ne soit donnée, l'une des commandes suivantes doit être présente.
  31 .PP
  32 add \fIfichier(s)\fR
  33 .RS 3n
  34 La commande
  35 add
  36 ajoute des fichiers indexant des paquets au cache des paquets. Cela sert uniquement pour le débogage.
  37 .RE
  38 .PP
  39 gencaches
  40 .RS 3n
  41 La commande
  42 gencaches
  43 fait la même chose que
  44 \fBapt\-get check\fR. Elle construit les caches des sources et des paquets à partir des sources répertoriées dans
  45 \fBsources.list\fR(5)et dans
  46 \fI/var/lib/dpkg/status\fR.
  47 .RE
  48 .PP
  49 showpkg \fIpaquet(s)\fR
  50 .RS 3n
  51 La commande
  52 showpkg
  53 affiche des informations sur les paquets donnés en argument. Les arguments restants sont les noms de paquets. Les versions disponibles et les dépendances inverses de chaque paquet répertorié sont listées, ainsi que les dépendances normales pour chaque version. Les dépendances normales d'un paquet sont constituées par les paquets dont il dépend\ ; les dépendances inverses sont les paquets qui dépendent du paquet en question. Les dépendances normales doivent donc être satisfaites et les dépendances inverses n'ont pas besoin de l'être. Ainsi, la commande
  54 \fBapt\-cache showpkg libreadline2\fR
  55 donnera ce résultat\ :
  56 .sp
  57 .RS 3n
  58 .nf
  59 Package: libreadline2
  60 Versions: 2.1\-12(/var/state/apt/lists/foo_Packages),
  61 Reverse Depends:
  62   libreadlineg2,libreadline2
  63   libreadline2\-altdev,libreadline2
  64 Dependencies:
  65 2.1\-12 \- libc5 (2 5.4.0\-0) ncurses3.0 (0 (null))
  66 Provides:
  67 2.1\-12 \-
  68 Reverse Provides:
  69 .fi
  70 .RE
  71 On peut voir que libreadline2, version 2.1\-12, dépend de libc5, ncurses3.0\ ; ces paquets doivent être installés au préalable pour que libreadline2 fonctionne. À leur tour, libreadlineg2 et libreadline2\-altdev dépendent de libreadline2. Si libreadline2 est installé, libc5 et ncurses3.0 doivent être installés\ ; libreadlineg2 et libreadline2\-altdev n'ont pas à l'être. Pour connaître le sens de la fin de chaîne, il est préférable de consulter le code source d'APT.
  72 .RE
  73 .PP
  74 stats
  75 .RS 3n
  76 La commande
  77 stats
  78 affiche des statistiques à propos du cache. Aucun autre argument n'est attendu. Voici les informations rapportées\ :
  79 .RS 3n
  80 .TP 3n
  81 \(bu
  82
  83 Total package names
  84 est le nombre de paquets trouvés dans le cache.
  85 .TP 3n
  86 \(bu
  87
  88 Normal packages
  89 est le nombre de paquets simples, ordinaires\ ; ces paquets tolèrent une correspondance bijective entre leur nom et le nom utilisé par les autres paquets pour les qualifier comme dépendance. La majorité des paquets appartient à cette catégorie.
  90 .TP 3n
  91 \(bu
  92
  93 Pure virtual packages
  94 est le nombre des paquets qui n'existent que sous la forme d'un nom représentant un paquet virtuel\ ; ces paquets \(Fo\ fournissent\ \(Fc seulement un nom de paquet virtuel et aucun paquet n'utilise véritablement ce nom. Par exemple, au sein du système Debian GNU/Linux, le nom \(Fo\ mail\-transport\-agent\ \(Fc est un paquet virtuel pur\ ; plusieurs paquets peuvent \(Fo\ remplir\ \(Fc ce nom \(Fo\ mail\-transport\-agent\ \(Fc, mais il n'existe aucun paquet nommé \(Fo\ mail\-transport\-agent\ \(Fc.
  95 .TP 3n
  96 \(bu
  97
  98 Single virtual packages
  99 est le nombre de paquets virtuels qui ne peuvent être remplis que par un seul paquet. Par exemple, au sein du système Debian GNU/Linux, \(Fo\ X11\-text\-viewer\ \(Fc est un paquet virtuel\ ; seul le paquet \(Fo\ xless\ \(Fc remplit \(Fo\ X11\-text\-viewer\ \(Fc.
 100 .TP 3n
 101 \(bu
 102
 103 Mixed virtual packages
 104 est le nombre des paquets qui remplissent un paquet virtuel particulier ou dont le nom est un nom de paquet virtuel. Par exemple, au sein du système Debian GNU/Linux, \(Fo\ debconf\ \(Fc est un paquet réel et il est aussi fourni par \(Fo\ debconf\-tiny\ \(Fc.
 105 .TP 3n
 106 \(bu
 107
 108 Missing
 109 est le nombre de paquets référencés dans une dépendance mais qui ne sont fournis par aucun paquet. Les paquets manquants peuvent être mis en évidence quand on n'accède pas à une distribution complète ou si un paquet (réel ou virtuel) a été sorti d'une distribution. Habituellement on les trouve dans les champs \(Fo\ Conflicts\ \(Fc.
 110 .TP 3n
 111 \(bu
 112
 113 Total distinct versions
 114 est le nombre de versions de paquets trouvées dans le cache\ ; cette valeur est par conséquent au moins égale au nombre total de paquets. Quand on accède à plus d'une distribution (\(Fo\ stable\ \(Fc et \(Fo\ unstable\ \(Fc, par exemple), cette valeur peut être considérablement plus grande que le nombre total de paquets.
 115 .TP 3n
 116 \(bu
 117
 118 Total dependencies
 119 est le nombre de relations de dépendances déclarées par tous les paquets présents dans le cache.
 120 .RE
 121 .IP "" 3n
 122 .RE
 123 .PP
 124 showsrc \fIpaquet(s)\fR
 125 .RS 3n
 126
 127 showsrc
 128 affiche toutes les entrées de paquet source qui correspondent aux noms donnés. Toutes les versions sont affichées et toutes les entrées qui déclarent que ces noms correspondent à des paquets binaires.
 129 .RE
 130 .PP
 131 dump
 132 .RS 3n
 133 La commande
 134 dump
 135 affiche un court résumé sur chaque paquet du cache. Elle est d'abord destinée au débogage.
 136 .RE
 137 .PP
 138 dumpavail
 139 .RS 3n
 140 La commande
 141 dumpavail
 142 affiche sur la sortie standard une liste des paquets disponibles. Elle convient à une utilisation avec
 143 \fBdpkg\fR(8)
 144 et la méthode
 145 \fBdselect\fR(8)
 146 s'en sert.
 147 .RE
 148 .PP
 149 unmet
 150 .RS 3n
 151 La commande
 152 unmet
 153 affiche un résumé concernant toutes les dépendances absentes dans le cache de paquets.
 154 .RE
 155 .PP
 156 show \fIpaquet(s)\fR
 157 .RS 3n
 158 La commande
 159 show
 160 est semblable à
 161 \fBdpkg \-\-print\-avail\fR\ ; elle affiche des informations sur les paquets donnés en argument.
 162 .RE
 163 .PP
 164 search \fIregex [ regex ... ]\fR
 165 .RS 3n
 166 La commande
 167 search
 168 recherche l'expression régulière donnée en argument sur tous les paquets disponibles. Elle cherche une occurrence de la chaîne dans les noms de paquets et dans les descriptions puis elle affiche le nom du paquet et sa description courte. Quand on donne l'option
 169 \fB\-\-full\fR, la sortie est identique à
 170 show
 171 pour chaque paquet\ ; l'option
 172 \fB\-\-names\-only\fR
 173 ne recherche pas la chaîne dans les descriptions longues mais seulement dans les noms de paquets.
 174 .sp
 175 On peut utiliser des arguments distincts pour indiquer des expressions régulières différentes sur lesquelles sera réalisé un \(Fo\ et\ \(Fc logique.
 176 .RE
 177 .PP
 178 depends \fIpaquet(s)\fR
 179 .RS 3n
 180 La commande
 181 depends
 182 affiche la liste de toutes les dépendances d'un paquet et la liste de tous les paquets possibles qui satisfont ces dépendances.
 183 .RE
 184 .PP
 185 rdepends \fIpaquet(s)\fR
 186 .RS 3n
 187 La commande
 188 rdepends
 189 affiche la liste de toutes les dépendances inverses d'un paquet.
 190 .RE
 191 .PP
 192 pkgnames \fI[ prefix ]\fR
 193 .RS 3n
 194 Cette commande affiche le nom de chaque paquet du système. Un préfixe pour filtrer la liste des noms peut être donné en argument. La sortie est appropriée à une utilisation au sein d'une fonction complète de shell\ ; elle est produite très rapidement. On utilise au mieux cette commande avec l'option
 195 \fB\-\-generate\fR.
 196 .RE
 197 .PP
 198 dotty \fIpaquet(s)\fR
 199 .RS 3n
 200 La commande
 201 dotty
 202 prend une liste de paquets sur la ligne de commande et affiche une sortie appropriée à une utilisation par la commande dotty du paquet
 203 [1]\&\fIGraphViz\fR. Il en résulte un ensemble de noeuds et d'arcs représentant les relations entre les paquets. Par défaut les paquets donnés en argument suivent toutes leurs dépendances, ce qui peut produire un graphe très volumineux. Pour limiter la sortie aux seuls paquets listés sur la ligne de commande, positionnez l'option
 204 APT::Cache::GivenOnly.
 205 .sp
 206 Les noeuds résultants ont plusieurs formes\ ; les paquets normaux sont des boîtes, les \(Fo\ provides\ \(Fc purs sont des triangles, les \(Fo\ provides\ \(Fc mixtes sont des diamants et les paquets manquants sont des hexagones. Les boîtes oranges expriment un arrêt de la récursivité [paquet feuille], les lignes bleues représentent des prédépendances et les lignes vertes représentent des conflits.
 207 .sp
 208 Attention, dotty ne peut pas représenter des ensembles très grands de paquets.
 209 .RE
 210 .PP
 211 policy \fI[ paquet(s) ]\fR
 212 .RS 3n
 213
 214 policy
 215 sert à déboguer des problèmes relatifs au fichier des préférences. Sans argument, la commande affiche la priorité de chaque source. Sinon, elle affiche des informations précises sur la priorité du paquet donné en argument.
 216 .RE
 217 .PP
 218 madison \fI[ paquet(s) ]\fR
 219 .RS 3n
 220 La commande
 221 madison
 222 d'apt\-cache
 223 cherche à mimer le format de sortie propre à l'outil debian de gestion d'archives,
 224 madison, ainsi qu'une part de ses fonctionnalités. Elle affiche les versions disponibles d'un paquet dans un tableau. Contrairement au programme original
 225 madison, elle n'affiche que des informations concernant l'architecture pour laquelle Apt a lu la liste des paquets disponibles (APT::Architecture).
 226 .RE
 227 .SH "OPTIONS"
 228 .PP
 229 Toutes les options en ligne de commande peuvent être positionnées via le fichier de configuration\ ; les descriptifs indiquent l'option de configuration à positionner. En ce qui concerne les options booléennes, on peut annuler le fichier de configuration en utilisant quelque chose comme
 230 \fB\-f\-\fR,\fB\-\-no\-f\fR,
 231 \fB\-f=no\fR
 232 ou d'autres variantes.
 233 .PP
 234 \fB\-p\fR, \fB\-\-pkg\-cache\fR
 235 .RS 3n
 236 Indique le fichier servant de cache des paquets. Le cache des paquets est le cache primaire utilisé par toutes les opérations. Élément de configuration\ :
 237 Dir::Cache::pkgcache.
 238 .RE
 239 .PP
 240 \fB\-s\fR, \fB\-\-src\-cache\fR
 241 .RS 3n
 242 Indique le fichier servant de cache des sources. Ce cache n'est utilisé que par
 243 gencaches\ ; une version des informations sur les paquets, faite à partir d'une analyse de sources distantes, est conservée. Quand le cache des paquets est créé, le cache des sources est utilisé afin d'éviter d'analyser à nouveau tous les paquets. Élément de configuration\ :
 244 Dir::Cache::srcpkgcache.
 245 .RE
 246 .PP
 247 \fB\-q\fR, \fB\-\-quiet\fR
 248 .RS 3n
 249 Mode silencieux\ ; produit une sortie pertinente pour l'enregistrement dans un fichier\-journal, sans afficher d'indicateur de progression. Un plus grand nombre de q produira un plus grand silence, avec un maximum de 2. Vous pouvez aussi utiliser
 250 \fB\-q=#\fR
 251 pour positionner le niveau de silence, annulant le fichier de configuration. Élément de configuration\ :
 252 quiet.
 253 .RE
 254 .PP
 255 \fB\-i\fR, \fB\-\-important\fR
 256 .RS 3n
 257 N'affiche que les dépendances importantes\ ; à utiliser avec la commande unmet pour n'afficher que les relations Depends et Pre\-Depends. Élément de configuration\ :
 258 APT::Cache::Important.
 259 .RE
 260 .PP
 261 \fB\-f\fR, \fB\-\-full\fR
 262 .RS 3n
 263 Affiche la totalité des champs d'information sur le paquet lors d'une recherche. Élément de configuration\ :
 264 APT::Cache::ShowFull.
 265 .RE
 266 .PP
 267 \fB\-a\fR, \fB\-\-all\-versions\fR
 268 .RS 3n
 269 Affiche la totalité des champs d'information pour toutes les versions disponibles\ : c'est la valeur par défaut. Pour la désactiver, utilisez l'option
 270 \fB\-\-no\-all\-versions\fR. Quand l'option
 271 \fB\-\-no\-all\-versions\fR
 272 est choisie, seuls les éléments de la version choisie (celle qui serait installée) seront affichés. Cette option concerne seulement la commande
 273 show. Élément de configuration\ :
 274 APT::Cache::AllVersions.
 275 .RE
 276 .PP
 277 \fB\-g\fR, \fB\-\-generate\fR
 278 .RS 3n
 279 Réalise une mise à jour automatique du cache des paquets plutôt que de se servir du cache actuel. Pour désactiver cette option (option par défaut), utilisez l'option
 280 \fB\-\-no\-generate\fR. Élément de configuration\ :
 281 APT::Cache::Generate.
 282 .RE
 283 .PP
 284 \fB\-\-names\-only\fR, \fB\-n\fR
 285 .RS 3n
 286 N'effectue une recherche que sur les noms de paquets et pas sur les descriptions longues. Élément de configuration\ :
 287 APT::Cache::NamesOnly.
 288 .RE
 289 .PP
 290 \fB\-\-all\-names\fR
 291 .RS 3n
 292 Avec cette option
 293 pkgnames
 294 affiche tous les noms, les noms des paquets virtuels et les dépendances manquantes. Élément de configuration\ :
 295 APT::Cache::AllNames.
 296 .RE
 297 .PP
 298 \fB\-\-recurse\fR
 299 .RS 3n
 300 Avec cette option
 301 depends
 302 et
 303 rdepends
 304 sont récursives de manière à n'afficher qu'une seule fois les paquets mentionnés. Élément de configuration\ :
 305 APT::Cache::RecurseDepends.
 306 .RE
 307 .PP
 308 \fB\-\-installed\fR
 309 .RS 3n
 310 Cette option limite la sortie de
 311 depends
 312 et de
 313 rdepends
 314 aux paquets qui sont actuellement installés. Élément de configuration\ :
 315 APT::Cache::Installed.
 316 .RE
 317 .PP
 318 \fB\-h\fR, \fB\-\-help\fR
 319 .RS 3n
 320 Affiche un mode d'emploi succinct.
 321 .RE
 322 .PP
 323 \fB\-v\fR, \fB\-\-version\fR
 324 .RS 3n
 325 Affiche la version du programme.
 326 .RE
 327 .PP
 328 \fB\-c\fR, \fB\-\-config\-file\fR
 329 .RS 3n
 330 Fichier de configuration\ ; indique quel fichier de configuration utiliser. Le programme lit le fichier de configuration par défaut, puis celui\-ci. Voyez
 331 \fBapt.conf\fR(5)
 332 pour la syntaxe.
 333 .RE
 334 .PP
 335 \fB\-o\fR, \fB\-\-option\fR
 336 .RS 3n
 337 Donne une option de configuration\ ; cela fixe une option de configuration arbitraire. La syntaxe est :
 338 \fB\-o Foo::Bar=bar\fR.
 339 .RE
 340 .SH "FICHIERS"
 341 .PP
 342 \fI/etc/apt/sources.list\fR
 343 .RS 3n
 344 Emplacements où aller chercher les paquets. Élément de configuration\ :
 345 Dir::Etc::SourceList.
 346 .RE
 347 .PP
 348 \fI/var/lib/apt/lists/\fR
 349 .RS 3n
 350 Zone de stockage pour les informations qui concernent chaque ressource de paquet spécifiée dans
 351 \fBsources.list\fR(5)Élément de configuration\ :
 352 Dir::State::Lists.
 353 .RE
 354 .PP
 355 \fI/var/lib/apt/lists/partial/\fR
 356 .RS 3n
 357 Zone de stockage pour les informations en transit. Élément de configuration\ :
 358 Dir::State::Lists
 359 (partial est implicite).
 360 .RE
 361 .SH "VOIR AUSSI"
 362 .PP
 363
 364 \fBapt.conf\fR(5),
 365 \fBsources.list\fR(5),
 366 \fBapt\-get\fR(8).
 367 .SH "DIAGNOSTICS"
 368 .PP
 369
 370 \fBapt\-cache\fR
 371 retourne zéro après un déroulement normal, et le nombre décimal 100 en cas d'erreur.
 372 .SH "BOGUES"
 373 .PP
 374 Voyez la
 375 [2]\&\fI page concernant les bogues d'APT\fR. Si vous voulez signaler un bogue, consultez le texte
 376 \fI/usr/share/doc/debian/bug\-reporting.txt\fR
 377 ou utilisez la commande
 378 \fBreportbug\fR(1).
 379 .SH "TRADUCTION"
 380 .PP
 381 Jérôme Marant. 2000\ ; mise à jour : Philippe Batailler. 2005.
 382 <debian\-l10n\-french@lists.debian.org>.
 383 .SH "AUTHORS"
 384 .PP
 385 \fBJason Gunthorpe\fR
 386 .sp -1n
 387 .IP "" 3n
 388 Auteur.
 389 .PP
 390 \fBAPT team\fR
 391 .sp -1n
 392 .IP "" 3n
 393 Auteur.
 394 .SH "REFERENCES"
 395 .TP 3
 396 1.\ GraphViz
 397 \%http://www.research.att.com/sw/tools/graphviz/
 398 .TP 3
 399 2.\ page concernant les bogues d'APT
 400 \%http://bugs.debian.org/src:apt