6.3. Commande apt-cache

6.3. Commande `apt-cache`

La commande apt-cache permet de consulter un certain nombre d'informations stockées dans la base de données interne d'APT. Ces informations — qui constituent une sorte de cache — sont rassemblées depuis les différentes sources données dans le fichier sources.list au cours de l'opération apt update.

VOCABULAIRE Cache

Un cache (« antémémoire », en français officiel) est un système de stockage temporaire servant à accélérer des accès fréquents à des données lorsque la méthode d'accès normale est coûteuse (en termes de performances). Cette notion s'applique dans de très nombreuses situations et à différentes échelles, depuis le cœur des microprocesseurs jusqu'aux systèmes de stockage de grande capacité.

In the case of APT, the reference Packages files are those located on Debian mirrors. That said, it would be very ineffective to go through the network for every search that we might want to do in the database of available packages. That is why APT stores a copy of those files (in /var/lib/apt/lists/) and searches are done within those local files. Similarly, /var/cache/apt/archives/ contains a cache of already downloaded packages (see sidebar POUR ALLER PLUS LOIN Cache des fichiers .deb) to avoid downloading them again if you need to reinstall them after a removal.

D'autre part, il est obligatoire de lancer apt update régulièrement pour mettre à jour le cache. Sinon, vos résultats de recherche de paquets vont toujours manquer les dernières mises à jour réparties dans les miroirs Debian.

The apt-cache command can do keyword-based package searches with apt-cache search keyword. It can also display the headers of the package's available versions with apt-cache show package. This command provides the package's description, its dependencies, the name of its maintainer, etc. Note that apt search, apt show, aptitude search, and aptitude show work in the same way.

ALTERNATIVE axi-cache

apt-cache search est un outil rudimentaire, qui ne dépasse guère un grep sur les descriptions de paquets. Il renvoie fréquemment trop de résultats ou aucun lorsque de trop nombreux mots-clés lui sont fournis.

À l'opposé, axi-cache search terme, fournit de meilleurs résultats, triés par pertinence. Cet outil utilise le moteur de recherche Xapian ; il fait partie du paquet apt-xapian-index, qui indexe toutes les informations des paquets (mais pas seulement : il indexe également les fichiers .desktop, par exemple). Il sait gérer les étiquettes (voir la POUR ALLER PLUS LOIN Le champ Tag) et son temps de réponse est souvent de l'ordre de quelques millisecondes.

$ axi-cache search package use::searching
axi-cache search package use::searching
30 results found.
Results 1-20:
100% packagesearch - GUI for searching packages and viewing package information
94% mlocate - transitional dummy package
87% cruft - transitional package
86% debtags - Debian Package Tags support tools
85% whohas - query multiple distributions' package archives
84% recoll - Personal full text search package
81% apt-forktracer - utility for tracking non-official package versions
[..]
68% wajig - unified package management front-end for Debian/Ubuntu
More terms: debian dctrl packagesearch information aptitude manager dpkg
More tags: admin::package-management works-with::software:package role::program suite::debian interface::commandline scope::application scope::utility
`axi-cache more' will give more results

Some features are more rarely used. For instance, apt-cache dumpavail displays the headers of all available versions of all packages. apt-cache pkgnames displays the list of all the packages which appear at least once in the cache.

L’une des fonctionnalités qui peut s’avérer très souvent utile est apt-cache policy, décrite dans la section suivante.

6.3.1. The `apt-cache policy` Command

The apt-cache policy command displays the pinning priorities and distribution properties of each package source as explained in Section 6.2.5, « Gérer les priorités associées aux paquets ». It can also show the pinning priorities for all available versions and sources of a package. For the sources.list example used in Exemple 6.2, « Fichier /etc/apt/sources.list pour les utilisateurs de Debian Stable » and APT::Default-Release set to "/^bookworm(|-security|-updates)$/", the output will look like this:

$ apt-cache policy
Package files:
 100 /var/lib/dpkg/status
     release a=now
 990 http://deb.debian.org/debian bookworm-updates/non-free-firmware amd64 Packages
     release v=12-updates,o=Debian,a=stable-updates,n=bookworm-updates,l=Debian,c=non-free-firmware,b=amd64
     origin deb.debian.org
 990 http://deb.debian.org/debian bookworm-updates/main amd64 Packages
     release v=12-updates,o=Debian,a=stable-updates,n=bookworm-updates,l=Debian,c=main,b=amd64
     origin deb.debian.org
 990 http://security.debian.org/debian-security bookworm-security/non-free-firmware amd64 Packages
     release v=12,o=Debian,a=stable-security,n=bookworm-security,l=Debian-Security,c=non-free-firmware,b=amd64
     origin security.debian.org
 990 http://security.debian.org/debian-security bookworm-security/main amd64 Packages
     release v=12,o=Debian,a=stable-security,n=bookworm-security,l=Debian-Security,c=main,b=amd64
     origin security.debian.org
 990 http://deb.debian.org/debian bookworm/non-free-firmware amd64 Packages
     release v=12.5,o=Debian,a=stable,n=bookworm,l=Debian,c=non-free-firmware,b=amd64
     origin deb.debian.org
 990 http://deb.debian.org/debian bookworm/main amd64 Packages
     release v=12.5,o=Debian,a=stable,n=bookworm,l=Debian,c=main,b=amd64
     origin deb.debian.org
Pinned packages:

apt-cache policy peut également afficher les priorités d'épinglage pour toutes les versions et sources disponibles d'un paquet donné.

$ apt-cache policy adb
adb:
  Installed: 1:29.0.6-28
  Candidate: 1:29.0.6-28
  Version table:
     1:33.0.3-2~bpo12+1 100
        100 http://deb.debian.org/debian bookworm-backports/main amd64 Packages
 *** 1:29.0.6-28 990
        990 http://deb.debian.org/debian bookworm/main amd64 Packages
        100 /var/lib/dpkg/status

Although there is a newer version of adb in the bookworm-backports repository, APT will not install it automatically based on the priority. One would have to use apt install adb/bookworm-backports or add a higher pinning priority to /etc/apt/preferences.d/adb.pref:

Package: adb
Pin: release o=Debian Backports,n=bookworm-backports
Pin-Priority: 1001

$ apt-cache policy limnoria
adb:
  Installed: 1:29.0.6-28
  Candidate: 1:33.0.3-2~bpo12+1
  Version table:
     1:33.0.3-2~bpo12+1 1001
        100 http://deb.debian.org/debian bookworm-backports/main amd64 Packages
 *** 1:29.0.6-28 990
        990 http://deb.debian.org/debian bookworm/main amd64 Packages
        100 /var/lib/dpkg/status