APT-CACHE(8) APT APT-CACHE(8) NOM apt-cache - recherche dans le cache d'APT SYNOPSIS apt-cache [-agipns] [-o=chaine_de_configuration] [-c=fichier_de_configuration] {gencaches | showpkg paquet... | showsrc paquet... | stats | dump | dumpavail | unmet | search expression_reguliere... | show paquet [{=numero_version_paquet | /publication_cible}]... | depends paquet [{=numero_version_paquet | /publication_cible}]... | rdepends paquet [{=numero_version_paquet | /publication_cible}]... | pkgnames [prefixe] | dotty paquet [{=numero_version_paquet | /publication_cible}]... | xvcg paquet [{=numero_version_paquet | /publication_cible}]... | policy [paquet...] | madison paquet... | {-v | --version} | {-h | --help}} DESCRIPTION apt-cache realise differentes operations sur le cache de paquet d'APT. apt-cache ne manipule pas l'etat du systeme mais fournit des moyens de recherche dans les metadonnees d'un paquet desquelles il extrait les informations interessantes. Les metadonnees sont obtenues et mises a jour avec la commande update d'apt-get par exemple, et peuvent donc etre perimees si la derniere mise a jour est trop ancienne, mais en contrepartie apt-cache fonctionne independamment de la disponibilite des sources configurees (par exemple hors ligne). A moins que l'option -h ou --help ne soit donnee, l'une des commandes suivantes doit etre presente. gencaches gencaches cree le cache d'APT. Cette action est faite implicitement par toute commande qui a besoin de ce cache s'il est manquant ou obsolete. showpkg paquet... La commande showpkg affiche des informations sur les paquets donnes en argument. Les arguments restants sont les noms de paquets. Les versions disponibles et les dependances inverses de chaque paquet repertorie sont listees, ainsi que les dependances normales pour chaque version. Les dependances normales d'un paquet sont constituees par les paquets dont il depend ; les dependances inverses sont les paquets qui dependent du paquet en question. Les dependances normales doivent donc etre satisfaites et les dependances inverses n'ont pas besoin de l'etre. Ainsi, la commande apt-cache showpkg libreadline2 donnera ce resultat : Package: libreadline2 Versions: 2.1-12(/var/state/apt/lists/foo_Packages), Reverse Depends: libreadlineg2,libreadline2 libreadline2-altdev,libreadline2 Dependencies: 2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null)) Provides: 2.1-12 - Reverse Provides: On peut voir que libreadline2, version 2.1-12, depend de libc5 et ncurses3.0 ; ces paquets doivent etre installes au prealable pour que libreadline2 fonctionne. A leur tour, libreadlineg2 et libreadline2-altdev dependent de libreadline2. Si libreadline2 est installe, libc5 et ncurses3.0 doivent etre installes ; libreadlineg2 et libreadline2-altdev n'ont pas a l'etre. Pour connaitre le sens de la fin de chaine, il est preferable de consulter le code source d'APT. stats La commande stats affiche des statistiques a propos du cache. Aucun autre argument n'est attendu. Voici les informations rapportees : o Total package names est le nombre de paquets trouves dans le cache. o Normal packages est le nombre de paquets simples, ordinaires ; ces paquets tolerent une correspondance bijective entre leur nom et le nom utilise par les autres paquets pour les qualifier comme dependance. La majorite des paquets appartient a cette categorie. o Pure virtual packages est le nombre de paquets qui n'existent que sous la forme d'un nom representant un paquet virtuel ; ces paquets << fournissent >> seulement un nom de paquet virtuel et aucun paquet n'utilise veritablement ce nom. Par exemple, au sein du systeme Debian GNU/Linux, le nom << mail-transport-agent >> est un paquet virtuel pur ; plusieurs paquets peuvent << fournir >> ce nom << mail-transport-agent >>, mais il n'existe aucun paquet nomme << mail-transport-agent >>. o Single virtual packages est le nombre de paquets virtuels qui ne peuvent etre remplis que par un seul paquet. Par exemple, au sein du systeme Debian, << X11-text-viewer >> est un paquet virtuel ; seul le paquet << xless >> remplit << X11-text-viewer >>. o Mixed virtual packages est le nombre de paquets qui remplissent un paquet virtuel particulier ou dont le nom est un nom de paquet virtuel. Par exemple, au sein du systeme Debian, << debconf >> est un paquet reel et il est aussi fourni par << debconf-tiny >>. o Missing est le nombre de paquets references dans une dependance mais qui ne sont fournis par aucun paquet. Les paquets manquants peuvent etre mis en evidence quand on n'accede pas a une distribution complete ou si un paquet (reel ou virtuel) a ete sorti d'une distribution. Habituellement on les trouve dans les champs << Conflicts >> ou << Breaks >>. o Total distinct versions est le nombre de versions de paquets trouvees dans le cache. Quand on accede a plus d'une distribution (<< stable >> et << unstable >>, par exemple), cette valeur peut etre considerablement plus grande que le nombre total de paquets. o Total dependencies est le nombre de relations de dependances declarees par tous les paquets presents dans le cache. showsrc paquet... showsrc affiche toutes les entrees de paquets source qui correspondent aux noms donnes. Toutes les versions sont affichees et toutes les entrees qui declarent que ces noms correspondent a des paquets binaires. Utilisez l'option --only-source pour n'afficher que le nom des paquets source. dump La commande dump affiche un court resume sur chaque paquet du cache. Elle est d'abord destinee au debogage. dumpavail La commande dumpavail affiche sur la sortie standard la liste des paquets disponibles. Elle convient a une utilisation avec dpkg(1) et la methode dselect(1) s'en sert. unmet La commande unmet affiche un resume concernant toutes les dependances absentes dans le cache de paquets. show paquet... La commande show est semblable a dpkg --print-avail ; elle affiche des informations sur les paquets donnes en argument. search expression_reguliere... La commande search recherche l'expression rationnelle POSIX donnee en parametre sur tous les paquets disponibles, voir regex(7). Elle cherche une occurrence de la chaine dans les noms de paquets et dans les descriptions puis elle affiche le nom du paquet et sa description courte. Quand l'option --full est fournie, la sortie est identique a show pour chaque paquet ; quand l'option --names-only est fournie, la recherche ne porte pas sur les descriptions longues, mais seulement sur les noms de paquets et les paquets fournis. On peut utiliser des arguments distincts pour indiquer des expressions rationnelles differentes sur lesquelles seront realisees un << et >> logique. depends paquet... La commande depends affiche la liste de toutes les dependances d'un paquet et la liste de tous les paquets possibles qui satisfont ces dependances. rdepends paquet... La commande rdepends affiche la liste de toutes les dependances inverses d'un paquet. pkgnames [prefixe] Cette commande affiche le nom de chaque paquet connu par APT. Un prefixe pour filtrer la liste des noms peut etre donne en parametre. La sortie est adaptee a une utilisation au sein d'une fonction complete de shell ; elle est produite tres rapidement. On utilise au mieux cette commande avec l'option --generate. Veuillez noter qu'un paquet connu par APT n'est pas forcement disponible, installable ou installe. Par exemple, les paquets virtuels sont egalement affiches dans la liste creee. dotty paquet... La commande dotty prend une liste de paquets sur la ligne de commande et affiche une sortie appropriee a une utilisation par la commande dotty du paquet GraphViz[1]. Il en resulte un ensemble de noeuds et d'arcs representant les relations entre les paquets. Par defaut les paquets donnes en argument suivent toutes leurs dependances, ce qui peut produire un graphe tres volumineux. Pour limiter la sortie aux seuls paquets listes sur la ligne de commande, positionnez l'option APT::Cache::GivenOnly. Les noeuds resultants ont plusieurs formes ; les paquets normaux sont des boites, les << provides >> purs sont des triangles, les << provides >> mixtes sont des diamants et les paquets manquants sont des hexagones. Les boites oranges expriment un arret de la recursivite [paquet feuille], les lignes bleues representent des predependances et les lignes vertes representent des conflits. Attention, dotty ne peut pas representer des ensembles tres grands de paquets. xvcg paquet... Identique a dotty, mais reserve a xvcg fourni avec VCG tool[2]. policy [paquet...] policy sert a deboguer des problemes relatifs au fichier des preferences. Sans argument, la commande affiche la priorite de chaque source. Sinon, elle affiche des informations precises sur la priorite du paquet donne en argument. madison paquet... La commande madison d'apt-cache cherche a mimer le format de sortie propre a l'outil debian de gestion d'archives, madison, ainsi qu'une partie de ses fonctionnalites. Elle affiche les versions disponibles d'un paquet dans un tableau. Contrairement au programme original madison, elle n'affiche que des informations concernant l'architecture pour laquelle Apt a lu la liste des paquets disponibles (APT::Architecture). OPTIONS Toutes les options de la ligne de commande peuvent etre definies dans le fichier de configuration, les descriptions indiquant l'option de configuration concernee. Pour les options booleennes, vous pouvez inverser les reglages du fichiers de configuration avec -f-,--no-f, -f=no et d'autres variantes analogues. -p, --pkg-cache Indique le fichier servant de cache des paquets. Le cache des paquets est le cache primaire utilise par toutes les operations. Element de configuration : Dir::Cache::pkgcache. -s, --src-cache Indique le fichier servant de cache des sources. Ce cache n'est utilise que par gencaches ; une version des informations sur les paquets, issue d'une analyse de sources distantes, est conservee. Quand le cache des paquets est cree, le cache des sources est utilise afin d'eviter d'analyser a nouveau tous les paquets. Element de configuration : Dir::Cache::srcpkgcache. -q, --quiet 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 -q=# pour positionner le niveau de silence, annulant le fichier de configuration. Element de configuration : quiet. -i, --important N'affiche que les dependances importantes ; a utiliser avec les commandes unmet et depends pour n'afficher que les relations Depends et Pre-Depends. Element de configuration : APT::Cache::Important. --no-pre-depends, --no-depends, --no-recommends, --no-suggests, --no-conflicts, --no-breaks, --no-replaces, --no-enhances Par defaut, depends et rdepends affichent toutes les dependances. Ce comportement peut etre modifie avec ces reglages qui omettront le type de dependance indique. Element de configuration : APT::Cache::ShowTypeDependance, p. ex. APT::Cache::ShowRecommends. --implicit Par defaut, depends et rdepends n'affichent que les dependances indiquees explicitement dans les metadonnees. Avec ce marqueur, ils afficheront aussi les dependances ajoutees de facon implicite basees sur les donnees rencontrees. Par exemple, un message Conflicts: foo exprime de facon implicite que ce paquet est aussi en conflit avec le paquet foo de n'importe quelle autre architecture. Element de configuration : APT::Cache::ShowImplicit. -f, --full Affiche la totalite des champs d'information sur le paquet lors d'une recherche. Element de configuration : APT::Cache::ShowFull. -a, --all-versions Affiche la totalite des champs d'information pour toutes les versions disponibles : c'est la valeur par defaut. Pour la desactiver, utilisez l'option --no-all-versions. Quand l'option --no-all-versions est choisie, seuls les elements de la version choisie (celle qui serait installee) seront affiches. Cette option concerne seulement la commande show. Element de configuration : APT::Cache::AllVersions. -g, --generate Realise une mise a jour automatique du cache des paquets plutot que de se servir du cache tel qu'il est. Pour desactiver cette option (option par defaut), utilisez l'option --no-generate. Element de configuration : APT::Cache::Generate. --names-only, -n N'effectue une recherche que sur les noms de paquets et de paquets fournis, pas sur les descriptions longues. Element de configuration : APT::Cache::NamesOnly. --all-names Avec cette option, pkgnames affiche tous les noms, les noms des paquets virtuels et les dependances manquantes. Element de configuration : APT::Cache::AllNames. --recurse Avec cette option, depends et rdepends sont recursives de maniere a n'afficher qu'une seule fois les paquets mentionnes. Element de configuration : APT::Cache::RecurseDepends. --installed Cette option limite la sortie de depends et de rdepends aux paquets qui sont actuellement installes. Element de configuration : APT::Cache::Installed. --with-source nom_de_fichier Ajoute le fichier donne comme source de metadonnees. La commande peut etre repetee pour ajouter de multiples fichiers. Actuellement, les fichiers*.deb, *.dsc, *.changes, Sources et Packages, aussi bien que les repertoires de paquets source sont pris en charge. Les correspondances de fichier sont basees sur leur nom seulement et non sur leur contenu ! Les Sources et Packages peuvent etre compresses dans n'importe quel format qu'APT prend en charge a condition qu'ils portent la bonne extension. Si vous avez besoin de stocker plusieurs de ces fichiers dans un seul repertoire, vous pouvez ajouter comme prefixe le nom que vous voulez pourvu que le dernier caractere soit un tiret bas (<< _ >>). Exemple : mon.exemple_Packages.xz Veuillez noter que ces sources sont traitees comme fiables (voir apt-secure(8)). Element de configuration : APT::Sources::With. -h, --help Afficher un bref resume de l'utilisation. -v, --version Afficher la version du programme. --audit Show audit (and notice) messages. This overrides the quiet option, but only for notice messages, not progress ones. -c, --config-file Fichier de configuration ; indique le fichier de configuration a utiliser. Le programme lira le fichier de configuration par defaut puis le fichier indique ici. Si les reglages de configuration doivent etre etablis avant l'analyse des fichiers de configuration par defaut, un fichier peut etre indique avec la variable d'environnement APT_CONFIG. Veuillez consulter apt.conf(5) pour des informations sur la syntaxe d'utilisation. -o, --option Set a Configuration Option; This will set an arbitrary configuration option. The syntax is -o Foo::Bar=bar. -o and --option can be used multiple times to set different options. --no-color, --color Turn colors on or off. Colors are on by default on supported terminals for apt(8) and can also be disabled using the NO_COLOR or APT_NO_COLOR environment variables, or further configured by the APT::Color configuration option and scope, see apt.conf(5) for information on that. FICHIERS /etc/apt/sources.list Emplacement pour la recuperation des paquets. Element de configuration : Dir::Etc::SourceList. /etc/apt/sources.list.d/ Fragments de fichiers definissant les emplacements de recuperation de paquets. Element de configuration : Dir::Etc::SourceParts. /var/lib/apt/lists/ Zone de stockage pour les informations qui concernent chaque ressource de paquet specifiee dans sources.list(5) Element de configuration : Dir::State::Lists. /var/lib/apt/lists/partial/ Zone de stockage pour les informations en transit. Element de configuration : Dir::State::Lists (partial sera implicitement ajoute). VOIR AUSSI apt.conf(5), sources.list(5), apt-get(8), apt-patterns(7) DIAGNOSTICS apt-cache retourne zero apres un deroulement normal et le nombre decimal 100 en cas d'erreur. BOGUES Page des bogues d'APT[3]. Si vous souhaitez signaler un bogue a propos d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou utiliser la commande reportbug(1). TRADUCTEURS Jerome Marant, Philippe Batailler, Christian Perrier (2000, 2005, 2009, 2010), Equipe de traduction francophone de Debian Veuillez noter que cette traduction peut contenir des parties non traduites. Cela est volontaire, pour eviter de perdre du contenu quand la traduction est legerement en retard sur le contenu d'origine. AUTEURS Jason Gunthorpe Equipe de developpement d'APT NOTES 1. GraphViz https://graphviz.org/ 2. VCG tool https://www.rw.cdl.uni- saarland.de/people/sander/private/html/gsvcg1.html 3. Page des bogues d'APT https://bugs.debian.org/src:apt APT 2.9.8 14 mars 2024 APT-CACHE(8)