apt-cache Man page

Resume Wikipedia de Advanced Packaging Tool

Advanced Packaging Tool (outil de paquetage avancé) ou APT est un gestionnaire de paquets utilisé par Debian GNU/Linux et ses dérivés.

APT-CACHE(8) APT APT-CACHE(8)

NOM
apt-cache – recherche dans le cache d’APT

SYNOPSIS

apt-cache [-agipns] [-o=chaîne_de_configuration] [-c=fichier_de_configuration] {gencaches | showpkg paquet…
| showsrc paquet… | stats | dump | dumpavail | unmet |
search expression_régulière… |
show paquet [{=numéro_version_paquet | /publication_cible}]…
|
depends paquet [{=numéro_version_paquet | /publication_cible}]…
|
rdepends paquet [{=numéro_version_paquet | /publication_cible}]…
| pkgnames [préfixe] |
dotty paquet [{=numéro_version_paquet | /publication_cible}]…
|
xvcg paquet [{=numéro_version_paquet | /publication_cible}]…
| policy [paquet…] | madison paquet… | {-v | –version} |
{-h | –help}}

DESCRIPTION

apt-cache performs a variety of operations on APT’s package cache.
apt-cache does not manipulate the state of the system but does provide
operations to search and generate interesting output from the package
metadata. The metadata is acquired and updated via the ‘update’ command
of e.g. apt-get, so that it can be outdated if the last update is too
long ago, but in exchange apt-cache works independently of the
availability of the configured sources (e.g. offline).

À moins que l’option -h ou –help ne soit donnée, l’une des commandes
suivantes doit être présente.

gencaches
gencaches crée le cache d’APT. Cette action est faite implicitement
par toute commande qui a besoin de ce cache s’il est manquant ou
obsolète.

showpkg paquet…
La commande showpkg 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
apt-cache showpkg libreadline2 donnera ce résultat :

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, dépend de libc5 et
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.

stats
La commande stats affiche des statistiques à propos du cache. Aucun
autre argument n’est attendu. Voici les informations rapportées :

· Total package names est le nombre de paquets trouvés dans le
cache.

· Normal packages 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.

· Pure virtual packages est le nombre de paquets qui n’existent
que sous la forme d’un nom représentant un paquet virtuel ; ces
paquets « fournissent » 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
« mail-transport-agent » est un paquet virtuel pur ; plusieurs
paquets peuvent « fournir » ce nom « mail-transport-agent »,
mais il n’existe aucun paquet nommé « mail-transport-agent ».

· Single virtual packages est le nombre de paquets virtuels qui
ne peuvent être remplis que par un seul paquet. Par exemple, au
sein du système Debian, « X11-text-viewer » est un paquet
virtuel ; seul le paquet « xless » remplit « X11-text-viewer ».

· 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 système Debian,
« debconf » est un paquet réel et il est aussi fourni par
« debconf-tiny ».

· Missing 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 « Conflicts » ou « Breaks ».

· Total distinct versions is the number of package versions found
in the cache. If more than one distribution is being accessed
(for instance, “stable” and “unstable”), this value can be
considerably larger than the number of total package names.

· Total dependencies est le nombre de relations de dépendances
déclarées par tous les paquets présents dans le cache.

showsrc paquet…
showsrc displays all the source package records that match the
given package names. All versions are shown, as well as all records
that declare the name to be a binary package. Use –only-source to
display only source package names.

dump
La commande dump affiche un court résumé sur chaque paquet du
cache. Elle est d’abord destinée au débogage.

dumpavail
La commande dumpavail affiche sur la sortie standard la liste des
paquets disponibles. Elle convient à une utilisation avec dpkg
et la méthode dselect(1) s’en sert.

unmet
La commande unmet affiche un résumé concernant toutes les
dépendances absentes dans le cache de paquets.

show paquet…
La commande show est semblable à dpkg –print-avail ; elle affiche
des informations sur les paquets donnés en argument.

search expression_régulière…
search performs a full text search on all available package lists
for the POSIX regex pattern given, see regex(7). It searches the
package names and the descriptions for an occurrence of the regular
expression and prints out the package name and the short
description, including virtual package names. If –full is given
then output identical to show is produced for each matched package,
and if –names-only is given then the long description is not
searched, only the package name and provided packages are.

On peut utiliser des arguments distincts pour indiquer des
expressions rationnelles différentes sur lesquelles seront
réalisées un « et » logique.

depends paquet…
La commande depends affiche la liste de toutes les dépendances d’un
paquet et la liste de tous les paquets possibles qui satisfont ces
dépendances.

rdepends paquet…
La commande rdepends affiche la liste de toutes les dépendances
inverses d’un paquet.

pkgnames [préfixe] Cette commande affiche le nom de chaque paquet connu par APT. Un
préfixe pour filtrer la liste des noms peut être donné en
paramètre. La sortie est adapté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 –generate.

Veuillez noter qu’un paquet connu par APT n’est pas forcément
disponible, installable ou installé. Par exemple, les paquets
virtuels sont également affichés dans la liste créée.

dotty paquet…
La commande dotty prend une liste de paquets sur la ligne de
commande et affiche une sortie appropriée à une utilisation par la
commande dotty du paquet GraphViz[1]. Il en résulte un ensemble de
nœuds 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 APT::Cache::GivenOnly.

Les noeuds résultants ont plusieurs formes ; les paquets normaux
sont des boîtes, les « provides » purs sont des triangles, les
« provides » 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.

Attention, dotty ne peut pas représenter des ensembles très grands
de paquets.

xvcg paquet…
Identique à dotty, mais réservé à xvcg fourni avec VCG tool[2].

policy [paquet…] policy 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.

madison paquet…
La commande madison d’apt-cache cherche à mimer le format de sortie
propre à l’outil debian de gestion d’archives, madison, ainsi
qu’une partie de ses fonctionnalités. 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 être définies dans
le fichier de configuration, les descriptions indiquant l’option de
configuration concernée. Pour les options booléennes, vous pouvez
inverser les réglages 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 utilisé par toutes les opérations.
Élément de configuration : Dir::Cache::pkgcache.

-s, –src-cache
Indique le fichier servant de cache des sources. Ce cache n’est
utilisé que par gencaches ; une version des informations sur les
paquets, issue 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 : 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. Élément de configuration : quiet.

-i, –important
N’affiche que les dépendances importantes ; à utiliser avec les
commandes unmet et depends pour n’afficher que les relations
Depends et Pre-Depends. Élément de configuration :
APT::Cache::Important.

–no-pre-depends, –no-depends, –no-recommends, –no-suggests,
–no-conflicts, –no-breaks, –no-replaces, –no-enhances
Per default the depends and rdepends print all dependencies. This
can be tweaked with these flags which will omit the specified
dependency type. Configuration Item: APT::Cache::ShowDependencyType
e.g. APT::Cache::ShowRecommends.

–implicit
Per default depends and rdepends print only dependencies explicitly
expressed in the metadata. With this flag it will also show
dependencies implicitely added based on the encountered data. A
Conflicts: foo e.g. expresses implicitely that this package also
conflicts with the package foo from any other architecture.
Configuration Item: APT::Cache::ShowImplicit.

-f, –full
Affiche la totalité des champs d’information sur le paquet lors
d’une recherche. Élément de configuration : APT::Cache::ShowFull.

-a, –all-versions
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 –no-all-versions. Quand l’option
–no-all-versions est choisie, seuls les éléments de la version
choisie (celle qui serait installée) seront affichés. Cette option
concerne seulement la commande show. Élément de configuration :
APT::Cache::AllVersions.

-g, –generate
Réalise une mise à jour automatique du cache des paquets plutôt que
de se servir du cache tel qu’il est. Pour désactiver cette option
(option par défaut), utilisez l’option –no-generate. Élément de
configuration : APT::Cache::Generate.

–names-only, -n
Only search on the package and provided package names, not the long
descriptions. Configuration Item: APT::Cache::NamesOnly.

–all-names
Avec cette option, pkgnames affiche tous les noms, les noms des
paquets virtuels et les dépendances manquantes. Élément de
configuration : APT::Cache::AllNames.

–recurse
Avec cette option, depends et rdepends sont récursives de manière à
n’afficher qu’une seule fois les paquets mentionnés. Élément de
configuration : APT::Cache::RecurseDepends.

–installed
Cette option limite la sortie de depends et de rdepends aux paquets
qui sont actuellement installés. Élément de configuration :
APT::Cache::Installed.

-h, –help
Afficher un bref résumé de l’utilisation.

-v, –version
Afficher la version du programme.

-c, –config-file
Fichier de configuration ; indique le fichier de configuration à
utiliser. Le programme lira le fichier de configuration par défaut
puis le fichier indiqué ici. Si les réglages de configuration
doivent être établis avant l’analyse des fichiers de configuration
par défaut, un fichier peut être indiqué avec la variable
d’environnement APT_CONFIG. Veuillez consulter apt.conf(5) pour des
informations sur la syntaxe d’utilisation.

-o, –option
Définir une option de configuration ; permet de régler une option
de configuration donnée. La syntaxe est -o Foo::Bar=bar. -o et
–option peuvent être utilisées plusieurs fois pour définir des
options différentes.

FICHIERS
/etc/apt/sources.list
Emplacement pour la récupération des paquets. Élément de
configuration : Dir::Etc::SourceList.

/etc/apt/sources.list.d/
Fragments de fichiers définissant les emplacements de récupération
de paquets. Élément de configuration : Dir::Etc::SourceParts.

/var/lib/apt/lists/
Zone de stockage pour les informations qui concernent chaque
ressource de paquet spécifiée dans sources.list(5) Élément de
configuration : Dir::State::Lists.

/var/lib/apt/lists/partial/
Zone de stockage pour les informations en transit. Élément de
configuration : Dir::State::Lists (partial sera implicitement
ajouté).

VOIR AUSSI
apt.conf(5), sources.list(5), apt-get(8).

DIAGNOSTICS
apt-cache retourne zéro après un déroulement normal et le nombre
décimal 100 en cas d’erreur.

BOGUES
Page des bogues d’APT[3]. 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
Jérôme Marant, Philippe Batailler, Christian Perrier
(2000, 2005, 2009, 2010), Équipe de traduction
francophone de Debian

Veuillez noter que cette traduction peut contenir des parties non
traduites. Cela est volontaire, pour éviter de perdre du contenu quand
la traduction est légèrement en retard sur le contenu d’origine.

AUTEURS
Jason Gunthorpe

Équipe de développement d’APT

NOTES
1. GraphViz
http://www.research.att.com/sw/tools/graphviz/

2. VCG tool
http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html

3. Page des bogues d’APT
http://bugs.debian.org/src:apt

APT 1.2.15 27 octobre 2015 APT-CACHE(8)