Pour sélectionner une version précise d'un paquet, ajoutez « =<version> » au nom du paquet : par exemple, « aptitude install apt=0.3.1 ». De la même façon, pour choisir un paquet d'une archive précise, ajoutez « /<archive> » au nom du paquet : par exemple, « aptitude install apt/experimental ». Vous ne pouvez pas préciser simultanément une archive et un numéro de version pour le même paquet.

Tous les paquets listés sur la ligne de commande ne doivent pas nécessairement être installés. Vous pouvez dire à aptitude d'agir différemment avec un paquet en ajoutant en suffixe un « attribut de surcharge » au nom du paquet. Par exemple, aptitude remove wesnoth+ installera wesnoth au lieu de le supprimer. Les attributs de surcharge suivants sont disponibles :

<paquet>+

<paquet>+M

<paquet>-

<paquet>_

<paquet>=

<paquet>:

<paquet>&M

<paquet>&m

<paquet>&BD

Cas particulier, « install » sans autre argument résoudra les commandes en suspens ou différées.

Par exemple, « aptitude remove '~ndeity' » supprimera tous les paquets dont le nom contient « deity »).

Si le paramètre en ligne de commande --arch-only est présent, seules les dépendances de construction qui dépendent de l'architecture (c'est-à-dire, pas celles indiquées dans les champs Build-Depends-Indep ou Build-Conflicts-Indep) seront satisfaites.

Pour plus d'informations sur les paquets installés automatiquement, consultez la section « Gérer les paquets automatiquement installés » dans le manuel de référence d'aptitude.

La différence entre hold et keep est qu'avec hold un paquet sera ignoré par les prochaines actions safe-upgrade ou full-upgrade, alors que keep annulera simplement toutes actions prévues sur le paquet. unhold permettra la mise à jour du paquet dès la prochaine commande safe-upgrade ou full-upgrade, sans toutefois modifier son état actuel.

Cette commande accepte des noms de paquet ou un motif comme arguments. Si la chaîne contient un tilde (« ~ ») ou un point d'interrogation (« ? »), elle sera considérée comme un motif de recherche, et tout paquet correspondant à ce motif sera pris en considération (voir la section « Motifs de recherche » dans le manuel de référence d'aptitude).

Par défaut, aptitude choisira la version interdite comme étant celle vers laquelle ce paquet aurait normalement dû être mis à jour (la version candidate). Ce choix peut être modifié en ajoutant « =<version> » au nom du paquet : par exemple, « aptitude forbid-version vim=1.2.3.broken-4 ».

Pour défaire cette action, « aptitude install <paquet> » supprimera l'interdiction. Pour supprimer l'interdiction d'une version sans installer la version candidate, la version actuelle doit être précisée dans la commande : « install<paquet>=<version> ».

Si aucun <paquet> n'est donné sur la ligne de commande, aptitude essaiera de mettre à jour tous les paquets qui le peuvent. Sinon, aptitude n'essaiera de mettre à jour que les paquets indiqués. Les <paquet>s peuvent être étendus avec des suffixes, de la même manière que les arguments de aptitude install, de sorte qu'il est possible de donner des instructions supplémentaires à aptitude. Par exemple, aptitude safe-upgrade bash dash- essaiera de mettre à jour le paquet bash et de supprimer le paquet dash.

Il est parfois nécessaire de supprimer ou d'installer un paquet afin de pouvoir en mettre un autre à jour. Utilisez la commande full-upgrade pour mettre autant de paquets à jour que possible.

Si aucun <paquet> n'est indiqué sur la ligne de commande, aptitude essaiera de mettre à jour tous les paquets susceptibles de l'être. Sinon, aptitude essaiera uniquement de mettre à jour les paquets indiqués. Le nom des <paquet>s peut être prolongé par un suffixe, de la même façon que les arguments de la commande aptitude install, afin de pouvoir donner des instructions supplémentaires à aptitude. Par exemple, aptitude full-upgrade bash dash- essaiera de mettre à jour le paquet bash et de supprimer le paquet dash.

i   apt                             - Advanced front-end for dpkg
pi  apt-build                       - frontend to apt to build, optimize and in
cp  apt-file                        - APT package searching utility -- command-
ihA raptor-utils                    - Raptor RDF Parser utilities

Les résultats sont présentés ligne par ligne. Le premier caractère de chaque ligne indique l'état courant du paquet : les états les plus courants sont p qui signifie qu'aucune trace du paquet n'est présente sur le système, c qui signifie que le paquet à été supprimé mais que ses fichiers de configuration sont toujours présents sur le système, i qui signifie que le paquet est installé et v qui signifie que le paquet est virtuel. Le second caractère indique l'action prévue (s'il y en a une, un espace sinon) sur le paquet. Les actions les plus courantes sont : i pour les paquets à installer, d pour ceux à supprimer et p pour ceux à purger (c-à-d, à supprimer ainsi que ses fichiers de configuration). Si le dernier caractère est un A, le paquet a été installé automatiquement.

Pour une liste complète des états et actions possibles, consultez la section « Accéder aux informations des paquets » dans le manuel de référence d'aptitude. Pour personnaliser la sortie de la commande search, consultez la documentation des options en ligne de commande -F et --sort.

Si le niveau de verbosité est au moins 1 (c'est-à-dire que l'option -v est présente sur la ligne de commande), les informations sur toutes les versions du paquets sont affichées. Sinon, seules les informations sur la « version installable » sont affichées (la version qui serait téléchargée par « aptitude install »).

Vous pouvez afficher les informations d'une version particulière d'un paquet en ajoutant le suffixe =<version> au nom du paquet ; vous pouvez également afficher les informations sur une version d'une archive particulière en ajoutant le suffixe /<archive> au nom du paquet, par exemple /unstable ou /sid. Si un de ces arguments est présent, seule la version demandée sera affichée, quel que soit le niveau de verbosité.

Si le niveau de verbosité est au moins 1, les champs architecture, taille compressée, nom de fichier et somme md5 du paquet sont affichés. Si le niveau de verbosité est au moins 2, la ou les versions sélectionnées seront affichées une fois pour chacune des archives dans lesquelles elles sont trouvées.

Il s'agit d'une surcouche fine au dessus de apt(8).

Il s'agit d'une surcouche fine au dessus de apt(8).

$ aptitude versions wesnoth
p   1:1.4.5-1                                                             100
p   1:1.6.5-1                                    unstable                 500
p   1:1.7.14-1                                   experimental             1

Chaque version est indiquée sur une ligne séparée. Les trois caractères les plus à gauche indiquent l'état actuel, l'état prévu (si besoin) et si le paquet a été installé automatiquement. Pour plus d'informations sur leur signification, consultez la documentation d'aptitude search. À droite du numéro de version, sont affichées les suites pour lesquelles la version est disponible et la priorité d'épinglage de cette version.

Si un nom de paquet contient un tilde (« ~ ») ou un point d'interrogation (« ? »), il sera traité comme un motif de recherche et toutes les versions correspondantes seront affichées (consultez la section « Motifs de recherche » dans le manuel de référence d'aptitude). Cela signifie que, par exemple, aptitude versions '~i' affichera toutes les versions actuellement installées sur le système, et rien d'autre, même pas les autres versions de ces mêmes paquets.

$ aptitude versions '~nexim4-daemon-light'
Paquet exim4-daemon-light :
i   4.71-3                                                                100
p   4.71-4                                       unstable                 500
Paquet exim4-daemon-light-dbg :
p   4.71-4                                       unstable                 500

Si l'entrée est un motif de recherche, ou si les versions de plus d'un paquet doivent être affichées, aptitude regroupera automatiquement la sortie par paquet, comme on peut le voir ci-dessus. Vous pouvez désactiver ce regroupement en ajoutant l'option --group-by=none. Dans ce cas, aptitude affichera une seule liste de toutes les versions qui ont été trouvées et inclura automatiquement le nom du paquet dans chaque ligne de la sortie :

$ aptitude versions --group-by=none '~nexim4-daemon-light'
i   exim4-daemon-light 4.71-3                                             100
p   exim4-daemon-light 4.71-4                    unstable                 500
p   exim4-daemon-light-dbg 4.71-4                unstable                 500

Pour désactiver le nom de paquet, utiliser --show-package-names=never :

$ aptitude versions --show-package-names=never --group-by=none '~nexim4-daemon-light'
i   4.71-3                                                                100
p   4.71-4                                       unstable                 500
p   4.71-4                                       unstable                 500

En plus des options ci-dessus, les informations affichées pour chaque version peuvent être contrôlées par l'option en ligne de commande -F. L'ordre dans lequel les versions sont affichées peut être contrôlé par l'option en ligne de commande --sort. Pour empêcher aptitude de formater la sortie en colonnes, utilisez --disable-columns.

Les étiquettes utilisateur sont des chaînes de caractères arbitraires associées à un paquet. Elles peuvent être utilisées avec le motif de recherche ?user-tag(<étiquette>), qui sélectionnera tous les paquets ayant une étiquette utilisateur correspondant à l'<étiquette>.

Cette commande cherche les paquets qui dépendent ou sont en conflit avec ce paquet. Il affiche la suite de dépendances qui s'enchaînent jusqu'au paquet visé, et une note indique l'état de chacun des paquets de la suite de dépendances.

$ aptitude why kdepim
i   nautilus-data Recommends nautilus
i A nautilus      Recommends desktop-base (>= 0.2)
i A desktop-base  Suggests   gnome | kde | xfce4 | wmaker
p   kde           Depends    kdepim (>= 4:3.4.3)

La commande why cherche la chaîne de dépendances pour l'installation du paquet indiqué sur la ligne de commande, comme ci-dessus. Sachez que les dépendances qu'indique aptitude dans ce cas de figure ne sont que des suggestions. C'est parce qu'aucun paquet installé sur cet ordinateur ne dépend ni ne recommande le paquet kdepim, car si une dépendance plus évidente était possible, aptitude l'aurait affichée.

A contrario, why-not cherche la chaîne de dépendances qui conduit au conflit avec le paquet ciblé.

$ aptitude why-not textopo
i   ocaml-core          Depends   ocamlweb
i A ocamlweb            Depends   tetex-extra | texlive-latex-extra
i A texlive-latex-extra Conflicts textopo

Si un ou plusieurs <motifs> sont présents (en plus du dernier argument qui est obligatoire, et qui doit être un nom de <paquet> valable), aptitude commencera sa recherche sur ces motifs. C'est à dire que le premier paquet affiché pour expliquer pourquoi le <paquet> est ou n'est pas installé, sera un paquet qui correspond au motif en question. Les motifs sont considérés comme des noms de paquet sauf s'ils contiennent un caractère tilde(« ~ ») ou un point d'interrogation (« ? »). Dans ce cas, ils seront alors traités comme un motif de recherche (consultez la section « Motifs de recherche » dans le manuel de référence d'aptitude).

Si aucun motif n'est présent, aptitude cherchera une chaîne de dépendances commençant par les paquets installés manuellement. Cela affiche de manière effective les paquets qui ont causé ou auraient pu avoir causé l'installation d'un paquet donné.

Si le niveau de verbosité est à 1 ou plus, alors toutes les explications qu'aptitude trouvera seront affichées, dans l'ordre de pertinence décroissante. Si le niveau de mode verbeux est de 2 ou plus, un très important niveau d'information de débogage sera affiché sur la sortie standard.

Cette commande renvoie un 0 si elle réussit, 1 si aucune explication n'a pu être fournie, et -1 si une erreur est apparue.

Par défaut, le journal correspondant à la version qui serait installée par « aptitude install » est téléchargé. Vous pouvez sélectionner une version particulière d'un paquet en ajoutant un suffixe=<version> au nom du paquet. Vous pouvez également sélectionner la version d'une archive particulière en ajoutant un suffixe /<archive> ou <suite> au nom du paquet (par exemple /unstable ou /sid).

Il s'agit d'une surcouche fine au dessus de apt(8).

Les dépendances dans les paragraphes sur les paquets binaires seront réécrites pour supprimer les références aux paquets qui n'ont pas été sélectionnés.

Par exemple, aptitude safe-upgrade --add-user-tag-to "nouvelle-installation,?action(install)" ajoutera l'étiquette nouvelle-installation à tous les paquets installés par la commande safe-upgrade.

Par exemple, les premières lignes de la sortie de la commande « aptitude search -F '%p %V' --disable-columns libedataserver » pourraient être :

libedataserver-1.2-15 3.2.2-3                  libedataserver-1.2-16 3.4.2-1libedataserver1.2-dev 3.2.2-3libedataserverui-3.0-1 3.2.2-3libedataserverui-3.0-dev 3.2.2-3

Comme dans l'exemple ci-dessus, --disable-columns est souvent utile combinée avec un format d'affichage défini en utilisant l'option en ligne de commande -F.

Directive du fichier de configuration : Aptitude::CmdLine::Disable-Columns.

Directive du fichier de configuration : Aptitude::CmdLine::Show-Deps.

Directive du fichier de configuration : Aptitude::CmdLine::Download-Only.

L'option en ligne de commande --disable-columns est souvent utilisée en combinaison avec -F.

Directives du fichier de configuration : Aptitude::CmdLine::Show-Versions pour la commande search ; Aptitude::CmdLine::Version-Display-Format pour la commande versions.

Directive du fichier de configuration : Aptitude::CmdLine::Fix-Broken.

Cette option peut être utilisée pour forcer l'utilisation du solveur complet, même lorsque Aptitude::Always-Use-Safe-Resolver est activée.

Directive du fichier de configuration : Aptitude::CmdLine::Versions-Group-By.

Cela ne concerne pas la journalisation des installations qu'aptitude a effectuées (/var/log/aptitude). La journalisation concernée par cette option contient les messages d'événements, d'erreur et de débogage. Consultez l'aide pour l'option en ligne de commande --log-level pour un meilleur contrôle sur le contenu journalisé.

Directive du fichier de configuration : Aptitude::Logging::File.

--log-level=<catégorie>:<niveau> implique la journalisation des messages de la <catégorie> seulement si leur niveau de journalisation est supérieur ou égal à <niveau>.

--log-level peut apparaître plusieurs fois sur la ligne de commande. Le réglage le plus particulier est celui qui aura un effet. Ainsi si --log-level=aptitude.resolver:fatal et --log-level=aptitude.resolver.hints.match:trace sont indiquées, les messages dans aptitude.resolver.hints.parse ne seront affichés que si leur niveau est fatal. En revanche, tous les messages dans aptitude.resolver.hints.match seront affichés. Si le niveau d'une même catégorie est déterminé plus d'une fois, le dernier réglage est celui qui aura un effet.

Cela ne concerne pas la journalisation des installations qu'aptitude a effectuées (/var/log/aptitude). La journalisation concernée par cette option contient les messages d'événements, d'erreur et de débogage. Consultez l'aide pour l'option en ligne de commande --log-file pour changer la destination de ces messages de journalisation.

Directive du fichier de configuration : Aptitude::Logging::Levels.

Cela copie le comportement historique de la commande apt-get upgrade.

Prepending the order keyword with a tilde character (~) reverses the order from ascending to descending.

L'ordre de tri par défaut est name,version.

Directive du fichier de configuration : Aptitude::CmdLine::Always-Prompt.

Directive du fichier de configuration : Aptitude::Purge-Unused.

Le paramètre optionnel =<n> peut être utilisé pour configurer directement le taux de silence (par exemple, pour surcharger un paramétrage dans /etc/apt/apt.conf) ; le programme agit alors comme si -q lui avait été passée exactement <n> fois.

Directives du fichier de configuration : APT::Install-Recommends et APT::AutoRemove::RecommendsImportant.

Directive du fichier de configuration : APT::Install-Recommends.

Par exemple, aptitude safe-upgrade --remove-user-tag-from "pas-mis-à-jour,?action(upgrade)" supprimera l'étiquette pas-mis-à-jour de tous les paquets que la commande safe-upgrade est capable de mettre à jour.

Directive du fichier de configuration : Aptitude::Simulate.

Cette option est équivalente à l'attribution de la valeur true à la variable Aptitude::Always-Use-Safe-Resolver

Par exemple, aptitude --schedule-only install evolution va programmer l'installation future du paquet evolution.

Directive du fichier de configuration : Aptitude::CmdLine::Versions-Show-Package-Names.

Lorsque la commande safe-upgrade est exécutée ou l'option --safe-resolver est présente, aptitude affichera un résumé des actions effectuées par le solveur avant d'afficher l'aperçu de l'installation. Directive du fichier de configuration : Aptitude::Safe-Resolver::Show-Resolver-Actions.

<mode> peut prendre les valeurs suivantes :

Directive du fichier de configuration : Aptitude::CmdLine::Show-Summary. Si l'option --show-summary est présente sur la ligne de commande, elle aura la priorité sur Aptitude::CmdLine::Show-Summary.

Exemple 12. Utilisation de --show-summary --show-summary utilisée avec -v pour afficher toutes les raisons pour lesquelles un paquet est installé :

$ aptitude -v --show-summary why foomatic-db
Paquets dépendants de foomatic-db :


  cupsys-driver-gutenprint


  foomatic-db-engine


  foomatic-db-gutenprint


  foomatic-db-hpijs


  foomatic-filters-ppds


  foomatic-gui


  kde


  printconf


  wine
$ aptitude -v --show-summary=first-package-and-type why foomatic-db
Paquets dépendants de foomatic-db :


  [Depends] cupsys-driver-gutenprint


  [Depends] foomatic-db-engine


  [Depends] foomatic-db-gutenprint


  [Depends] foomatic-db-hpijs


  [Depends] foomatic-filters-ppds


  [Depends] foomatic-gui


  [Depends] kde


  [Depends] printconf


  [Depends] wine
$ aptitude -v --show-summary=all-packages why foomatic-db
Paquets dépendants de foomatic-db :


  cupsys-driver-gutenprint D: cups-driver-gutenprint D: cups R: foomatic-filters R: foomatic-db-engine D: foomatic-db


  foomatic-filters-ppds D: foomatic-filters R: foomatic-db-engine D: foomatic-db


  kde D: kdeadmin R: system-config-printer-kde D: system-config-printer R: hal-cups-utils D: cups R: foomatic-filters R: foomatic-db-engine D: foomatic-db


  wine D: libwine-print D: cups-bsd R: cups R: foomatic-filters R: foomatic-db-engine D: foomatic-db


  foomatic-db-engine D: foomatic-db


  foomatic-db-gutenprint D: foomatic-db


  foomatic-db-hpijs D: foomatic-db


  foomatic-gui D: python-foomatic D: foomatic-db-engine D: foomatic-db


  printconf D: foomatic-db
$ aptitude -v --show-summary=all-packages-with-dep-versions why foomatic-db
Paquets dépendants de foomatic-db :


  cupsys-driver-gutenprint D: cups-driver-gutenprint (>= 5.0.2-4) D: cups (>= 1.3.0) R: foomatic-filters (>= 4.0) R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)


  foomatic-filters-ppds D: foomatic-filters R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)


  kde D: kdeadmin (>= 4:3.5.5) R: system-config-printer-kde (>= 4:4.2.2-1) D: system-config-printer (>= 1.0.0) R: hal-cups-utils D: cups R: foomatic-filters (>= 4.0) R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)


  wine D: libwine-print (= 1.1.15-1) D: cups-bsd R: cups R: foomatic-filters (>= 4.0) R: foomatic-db-engine (>= 4.0) D: foomatic-db (>= 20090301)


  foomatic-db-engine D: foomatic-db


  foomatic-db-gutenprint D: foomatic-db


  foomatic-db-hpijs D: foomatic-db


  foomatic-gui D: python-foomatic (>= 0.7.9.2) D: foomatic-db-engine D: foomatic-db (>= 20090301)


  printconf D: foomatic-db
	    

--show-summary utilisé pour afficher une chaîne sur une seule ligne :

$ aptitude --show-summary=all-packages why aptitude-gtk libglib2.0-data
Paquets dépendants de libglib2.0-data:


  aptitude-gtk D: libglib2.0-0 R: libglib2.0-data

Cela affectera la version candidate par défaut des paquets conformément aux règles décrites dans apt_preferences(5).

Directive du fichier de configuration : APT::Default-Release.

Directive du fichier de configuration : Aptitude::CmdLine::Show-Versions.

Directive du fichier de configuration : Aptitude::CmdLine::Verbose.

$ aptitude --show-why install mediawiki
...
Les NOUVEAUX paquets suivants vont être installés :


  libapache2-mod-php5{a} (for mediawiki)  mediawiki  php5{a} (for mediawiki)


  php5-cli{a} (for mediawiki)  php5-common{a} (for mediawiki)


  php5-mysql{a} (for mediawiki)

Lorsqu'elle est combinée avec -v ou avec une valeur non nulle de Aptitude::CmdLine::Verbose, cette option affiche la chaîne de dépendance complète qui conduit à chaque paquet sur le point d'être installé. Par exemple :

$ aptitude -v --show-why install libdb4.2-dev
Les NOUVEAUX paquets suivants vont être installés :


  libdb4.2{a} (libdb4.2-dev D: libdb4.2)  libdb4.2-dev
Les paquets suivants seront ENLEVÉS : 


  libdb4.4-dev{a} (libdb4.2-dev C: libdb-dev P<- libdb-dev)

Cette option décrira aussi pourquoi des paquets sont supprimés, comme on peut le voir ci-dessus. Dans cet exemple, libdb4.2-dev est en conflit avec libdb-dev, qui est fourni par libdb-dev.

Directive du fichier de configuration : Aptitude::CmdLine::Show-Why. Cette option affiche la même information que celle calculée par aptitude why et aptitude why-not.

Par défaut, et lorsque la sortie est vue directement dans un terminal, la largeur du terminal est utilisée. Lorsque la sortie est redirigée ou passée dans un tuyau (« pipe »), une très grande largeur (illimitée) est utilisée, et cette option est ignorée.

Directive du fichier de configuration : Aptitude::CmdLine::Package-Display-Width.

Directive du fichier de configuration : Aptitude::CmdLine::Assume-Yes.

Directive du fichier de configuration : Aptitude::CmdLine::Show-Size-Changes.