aptitude − interface évoluée pour le gestionnaire de paquets

aptitude [<options>...] {autoclean | clean | forget−new | keep−all | update | upgrade}

aptitude [<options>...] {changelog | dist−upgrade | download | forbid−version | hold | install | keep−all | markauto | purge | reinstall | remove | show | unhold | unmarkauto} <paquets>...

aptitude [<options>...] search <motifs>...

aptitude [−S <nom−fichier>] [−u | −i]

aptitude help

aptitude est une interface en mode texte pour le gestionnaire de paquets de Debian GNU/Linux.

Elle permet à l’utilisateur de connaître la liste des paquets, et de réaliser des tâches d’administration comme l’installation, la mise à jour ou l’effacement de paquets. Ces tâches peuvent être réalisées en mode « interactif » ou à partir de la « ligne de commande ».

Le premier argument qui ne commence pas par un tiret (« \fB−\fR ») sera considéré comme étant la commande que le programme doit réaliser. Si aucune commande n’est donnée, aptitude démarrera en mode interactif.

Commandes disponibles :

\fBinstall\fR

Installe un ou plusieurs paquets. Les paquets doivent être énumérés après la commande « install » ; si le nom d’un paquet contient un tilde, il sera considéré comme un motif de recherche, et tout paquet correspondant à ce motif sera installé (voir la section « Motifs de recherche » dans le manuel de référence d’aptitude).

Pour sélectionner une version précise d’un paquet, ajoutez « \fB=<version>\fR » au nom du paquet : par exemple, « \fBaptitude install apt=0.3.1\fR ». De la même façon, pour choisir un paquet d’une archive précise, ajoutez « \fB/<archive>\fR » au nom du paquet : par exemple, « \fBaptitude install apt/experimental\fR ».

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

<paquet>\fB+\fR

Installe <paquet>.

<paquet>\fB+M\fR

Installe <paquet> et le marque comme installé automatiquement (notez que si aucun autre paquet ne dépend de <paquet>, cela entraînera sa suppression immédiate).

<paquet>\fB−\fR

Supprime <paquet>.

<paquet>\fB_\fR

Purge <paquet> : supprime le paquet ainsi que tous ses fichiers de configuration.

<paquet>\fB=\fR

Marque <package> comme étant à conserver : annule toute action d’installation, de mise à jour ou de suppression, et empêche ce paquet d’être mis à jour automatiquement dans le futur.

<paquet>\fB:\fR

Garde <paquet> à sa version actuelle : annule toute action d’installation, de mise à jour ou de suppression. Contrairement à « hold » (voir ci−dessus), cela n’empêche pas ce paquet d’être mis à jour automatiquement dans le futur.

<paquet>\fB&M\fR

Marque <paquet> comme ayant été installé automatiquement.

<paquet>\fB&m\fR

Marque <paquet> comme ayant été installé manuellement.

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

Note
Une fois que vous avez appuyé sur Y à l’invite de confirmation finale, la commande « install » modifie les informations enregistrées sur les actions qu’aptitude doit réaliser. De ce fait, si vous lancez la commande « aptitude install toto titi » puis que vous arrêtiezl’installation alors qu’aptitude a déjà commencé à télécharger et installer des paquets, vous devrez lancer « aptitude remove toto titi » pour l’annuler.

\fBremove\fR, \fBpurge\fR, \fBhold\fR, \fBunhold\fR, \fBkeep\fR, \fBreinstall\fR

Ces commandes ont le même comportement que « \fBinstall\fR », mais applique l’action à tous les paquets donnés sur la ligne de commande pour lesquels il n’y a pas de surcharge. La différence entre \fBhold\fR et \fBkeep\fR est que \fBhold\fR fera qu’un paquet sera ignoré par les prochaines actions \fBupgrade\fR, alors que \fBkeep\fR annulera simplement toutes actions prévues sur le paquet. \fBunhold\fR fera qu’un paquet sera mise à jour par les prochaines actions \fBupgrade\fR, sans pour autant modifier son état.

Par exemple, « \fBaptitude remove ’~ndeity’\fR » supprimera tous les paquets dont le nom contient « \fBdeity\fR »).

\fBmarkauto\fR, \fBunmarkauto\fR

Indique que les paquets ont été respectivement installés automatiquement, ou à la main. Vous pouvez choisir les paquets grâce à la syntaxe vue plus haut, et même indiquer les commandes à réaliser. Par exemple, « \fBaptitude markauto ’~slibs’\fR » marquera tous les paquets de la section « \fBlibs\fR » comme ayant été installés automatiquement.

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.

\fBforbid−version\fR

Empêche la mise à jour vers une version précise d’un paquet. Cette option interdit à aptitude la mise à jour automatique vers cette version, mais permettra le passage aux versions suivantes. Par défaut, aptitude choisira la version vers laquelle ce paquet aurait normalement dû être mis à jour. Vous pouvez modifier ce choix en ajoutant « =<version> » au nom du paquet : par exemple, « \fBaptitude forbid−version vim=1.2.3.broken−4\fR ».

Cette commande est pratique pour éviter les versions boguées des paquets sans avoir à définir ou supprimer des gels à la main. Si vous décidez finalement d’installer la version que vous aviez interdite, la commande « \fBinstall\fR » mettra fin à l’interdiction.

\fBupdate\fR

Met à jour la liste des paquets disponibles sur les serveurs maîtres. (C’est l’équivalent de « \fBapt−get update\fR »).

\fBupgrade\fR

Met les paquets installés à jour, avec leur version la plus récente. Les paquets installés ne seront pas retirés, sauf s’ils sont inutilisés. (voir la section « Gérer les paquets automatiquement installés » dans le manuel de référence d’aptitude). Les paquets qui ne sont pas actuellement présents ne seront pas installés.

Si un paquet ne peut être mis à jour sans enfreindre ces contraintes, il restera dans son état actuel. Utilisez la commande \fBdist−upgrade\fR pour mettre aussi ces paquets à jour.

\fBdist−upgrade\fR

Les mises à jour installent les paquets à leur plus récente version, supprimant ou installant autant de paquets que nécessaire. Cette commande est moins conservatrice que \fBupgrade\fR et donc a plus de chance de provoquer des actions inattendues. Il est recommandé soit d’utiliser \fBupgrade\fR à la place, soit de bien examiner la liste des paquets à installer et supprimer.

\fBkeep−all\fR

Annule toutes les actions prévues sur des paquets. Tout paquet dont l’état indique une action prévue d’installation, de suppression ou de mise à jour verra son état remis à zéro.

\fBforget−new\fR

Ignore les « nouveaux » paquets (équivaut à presser « f » en mode interactif).

\fBsearch\fR

Recherche les paquets qui correspondent à un ou plusieurs motifs donnés sur la ligne de commande. Tous les paquets correspondant aux expressions demandées seront affichés. Par exemple, « \fBaptitude search ’~N’\fR » affichera tous les « nouveaux » paquets. Les expressions de recherche sont expliquées en détail dans « Motifs de recherche » dans le manuel de référence d’aptitude).

À moins que vous ne passiez l’option \fB−F\fR, la sortie de la commande \fBaptitude search\fR ressemblera à quelque chose comme ceci :

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 \fBp\fR qui signifie qu’aucune trace du paquet n’est présente sur le système, \fBc\fR qui signifie que le paquet à été supprimé mais que ses fichiers de configuration sont toujours présent sur le système, \fBi\fR qui signifie que le paquet est installé et \fBv\fR 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 : \fBi\fR pour les paquets sur le point à installer, \fBd\fR pour ceux à supprimer et \fBp\fR pour ceux à purger (c−à−d, à supprimer ainsi que ses fichiers de configuration). Si le dernier caractère est un \fBA\fR, 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.

\fBshow\fR

Afficher des informations détaillées sur un ou plusieurs paquets dont les noms sont indiqués après la commande search. Si un nom de paquet contient un caractère \fBtilde\fR, il sera alors traité comme un motif de recherche, et tous les paquets correspondants seront affichés (voir la section « Motifs de recherche » dans le manuel de référence d’aptitude).

Si le niveau de verbosité est au moins 1 (c’est−à−dire que l’option \fB−v\fR 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 « \fBaptitude install\fR »).

Vous pouvez afficher les informations d’une version particulière d’un paquet en suffixant \fB=<version>\fR au nom du paquet ; vous pouvez également afficher les informations sur une version d’une archive particulière en suffixant \fB/<archive>\fR au nom du paquet. Si un des ces arguments est présent, seule la version demandée sera affichée, quelque 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.

\fBclean\fR

Supprime tous les paquets \fB.deb\fR téléchargés et enregistrés dans le répertoire cache (normalement /var/cache/apt/archives).

\fBautoclean\fR

Supprime tout paquet enregistré dans le cache et qui n’est plus proposé au téléchargement. Cela vous permet d’empêcher que le cache ne grossisse démesurément avec le temps, sans avoir à le vider complètement.

\fBchangelog\fR

Télécharge et affiche le journal des modifications pour chaque paquet source ou binaires.

Par défaut, le journal correspondant à la version qui serait installé par « \fBaptitude install\fR » est téléchargé. Vous pouvez sélectionnez un version particulière d’un paquet en suffixant \fB=<version>\fR au nom du paquet ; vous pouvez également sélectionnez la version d’une archive particulière en suffixant \fB/<archive>\fR au nom du paquet.

\fBdownload\fR

Télécharge le fichier \fB.deb\fR de la version la plus récente du paquet, et le range dans le répertoire courant.

Par défaut, le fichier correspondant à la version qui serait installé par « \fBaptitude install\fR » est téléchargé. Vous pouvez sélectionnez un version particulière d’un paquet en suffixant \fB=<version>\fR au nom du paquet ; vous pouvez également sélectionnez la version d’une archive particulière en suffixant \fB/<archive>\fR au nom du paquet.

\fBhelp\fR

Affiche un bref résumé des commandes et options disponibles.

Les options qui suivent peuvent être utilisées afin de modifier le comportement des commandes ci−dessus. Remarquez que les commandes ne vont pas toutes réagir à chaque option (en effet, certaines options n’ont aucun sens pour certaines commandes).

\fB−D\fR, \fB−−show−deps\fR

Pour les commandes qui installent ou suppriment des paquets (\fBinstall\fR, \fBupgrade\fR, etc.), affiche un bref résumé sur la raison pour laquelle des paquets vont être automatiquement installés ou supprimés.

Directive du fichier de configuration : \fBAptitude::CmdLine::Show−Deps\fR.

\fB−d\fR, \fB−−download−only\fR

N’installe ni ne supprime aucun paquet. Télécharge simplement les paquets nécessaires dans le cache.

Directive du fichier de configuration : \fBAptitude::CmdLine::Download−Only\fR.

\fB−F\fR <format>, \fB−−display−format\fR <format>

Définit le format qui sera utilisé pour afficher les résultats de la commande \fBsearch\fR. Par exemple, « \fB%p %V %v\fR » affichera le nom du paquet, suivi du numéro de la version installée, ainsi que les versions disponibles. Pour plus d’informations, consultez la section « Personnaliser la manière d’afficher les paquets » dans le manuel de référence d’aptitude.

Directive du fichier de configuration : \fBAptitude::CmdLine::Package−Display−Format\fR.

\fB−f\fR

Essaye témérairement de résoudre les dépendances des paquets cassés, même si cela implique d’ignorer des actions demandées sur la ligne de commande.

Directive du fichier de configuration : \fBAptitude::CmdLine::Fix−Broken\fR.

\fB−h\fR, \fB−−help\fR

Affiche un court message d’aide. Identique à l’action \fBhelp\fR.

\fB−−purge−unused\fR

Purge les paquets dont aucun autre paquet installé ne dépend. Cela revient à mettre le paramètre « \fB−o Aptitude::Purge−Unused=true\fR » sur la ligne de commande.

\fB−P\fR, \fB−−prompt\fR

Affiche toujours une invite de commande, même si aucune autre commande que celles explicitement demandées n’est entreprise.

Directive du fichier de configuration : \fBAptitude::CmdLine::Always−Prompt\fR.

\fB−R\fR, \fB−−without−recommends\fR

Ne gère pas les recommandations ou les suggestions comme si elles étaient des dépendances lors de l’installation de nouveaux paquets (prioritaire sur les réglages de /etc/apt/apt.conf and ~/.aptitude/config).

Directive du fichier de configuration : \fBAptitude::Recommends−Important\fR

\fB−r\fR, \fB−−with−recommends\fR

Traite les suggestions ou les recommandations en tant que dépendances lors de l’installation des nouveaux paquets. (Prioritaire sur les réglages de /etc/apt.conf et ~/.aptitude/config).

Directive du fichier de configuration : \fBAptitude::Recommends−Important\fR

\fB−s\fR, \fB−−simulate\fR

En mode ligne de commande, affiche la liste des actions qui seraient réalisées, mais ne les lance pas réellement. Il n’est pas nécessaire d’avoir les privilèges d’administration. Dans l’interface visuelle, ouvre toujours le cache en mode lecture seule que vous soyez administrateur ou non.

Directive du fichier de configuration : \fBAptitude::Simulate\fR.

\fB−−schedule−only\fR

Pour les commandes qui modifient l’état des paquets, programme les actions à faire pour plus tard, mais ne les fait pas. Vous pouvez exécuter les actions programmés en lançant \fBaptitude install\fR sans paramètre. Cela revient à faire la sélection correspondante en mode visuel, puis à quitter aptitude normalement.

Par exemple, \fBaptitude −−schedule−only install evolution\fR va programmer l’installation future du paquet \fBevolution\fR.

\fB−t\fR <version>, \fB−−target−release\fR <version>

Définit la version à partir de laquelle les paquets devront être installés. Par exemple, « \fBaptitude −t expérimental ...\fR » installera les paquets de la distribution expérimentale, si rien d’autre n’est précisé. Pour les actions de la ligne de commandes « changelog », « download » et « show », cela revient à suffixer \fB/<version>\fR au nom de chaque paquet cité sur la ligne de commandes. Pour les autres commandes, cela modifiera la version installée par défaut selon les règles décrites dans apt_preferences(5).

Directive du fichier de configuration : \fBAPT::Default−Release\fR.

\fB−O\fR <ordre>, \fB−−sort\fR <ordre>

Définit l’ordre dans lequel le résultat de la commande \fBsearch\fR doit être affiché. Par exemple, « \fBinstallsize\fR » triera les paquets dans l’ordre croissant de la taille de leur installation. Pour plus d’informations, consultez le chapitre « Personnaliser la manière de trier les paquets » dans le manuel de référence d’aptitude.

\fB−o\fR <clef>\fB=\fR<valeur>

Définit une option du fichier de configuration à la volée. Utilisez par exemple \fB−o Aptitude::Log=/tmp/mes−logs\fR afin de consigner (logs) les événements d’aptitude dans le fichier /tmp/mes−logs. Pour plus d’informations sur les options du fichier de configuration, consultez le chapitre « Référence du fichier de configuration » dans le manuel de référence d’aptitude.

\fB−q[=<n>]\fR, \fB−−quiet[=<n>]\fR

Enlève tous les indicateurs d’avancement, et rend ainsi la sortie journalisable. Cette option peut être passée plusieurs fois pour rendre le programme de plus en plus silencieux, mais contrairement à apt−get, aptitude n’ajoute pas implicitement \fB−y\fR quand \fB−q\fR est passée plus d’une fois.

Le paramètre optionnel \fB=<n>\fR 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 \fB−q\fR lui avait été passée exactement <n> fois.

\fB−V\fR, \fB−−show−versions\fR

Indique quelle versions du paquet sera installée.

Directive du fichier de configuration : \fBAptitude::CmdLine::Show−Versions\fR.

\fB−v\fR, \fB−−verbose\fR

Force quelques commandes (\fBshow\fR par exemple) à afficher des informations supplémentaires. Peut être invoqué plusieurs fois afin d’obtenir des informations de plus en plus complètes.

Directive du fichier de configuration : \fBAptitude::CmdLine::Verbose\fR.

\fB−−version\fR

Affiche la version et quelques informations sur l’environnement de compilation d’aptitude.

\fB−−visual−preview\fR

Lance l’interface visuelle et affiche l’écran d’accueil, plutôt que d’afficher l’habituelle invite de commande en ligne.

\fB−w\fR <largeur>, \fB−−width\fR <largeur>

Définit la largeur utilisée pour l’affichage du résultat de la commande \fBsearch\fR. (Par défaut, c’est la largeur du terminal).

Directive du fichier de configuration : \fBAptitude::CmdLine::Package−Display−Width\fR

\fB−y\fR, \fB−−assume−yes\fR

Répond « oui » à toute question de type oui/non. En fait, cette option supprime l’invite (le prompt) qui apparaît quand on installe, met à jour ou supprime des paquets. N’affecte pas les réponses aux questions particulièrement dangereuses, telles que la suppression des paquets essentiels. A priorité sur \fB−P\fR.

Directive du fichier de configuration : \fBAptitude::CmdLine::Assume−Yes\fR.

\fB−Z\fR

Affiche l’espace disque qui sera utilisé ou libéré par chacun des paquets à installer, mettre à jour ou supprimer.

Directive du fichier de configuration : \fBAptitude::CmdLine::Show−Size−Changes\fR.

Les options suivantes s’appliquent au mode visuel du programme. Toutefois, elles ne sont utilisées qu’en interne. Normalement, vous n’en aurez pas besoin.

\fB−S\fR <nom−fichier>

Charge les informations supplémentaires à partir de <nom−fichier> plutôt qu’à partir du fichier standard.

\fB−u\fR

Lance la mise à jour de la liste des paquets dès le démarrage du programme. On ne peut pas se servir en même temps de cette option et de \fB−i\fR.

\fB−i\fR

Affiche l’écran de téléchargement au démarrage du programme (équivalent au lancement du programme, puis à l’appui sur « g »). On ne peut pas se servir en même temps de cette option et de \fB−u\fR.

\fBHOME\fR

Si $HOME/.aptitude existe, aptitude stockera son fichier de configuration dans$HOME/.aptitude/config. Sinon, il recherchera le répertoire personnel de l’utilisateur courant, grâce à getpwuid(2) pour y placer son fichier de configuration.

\fBPAGER\fR

Quand cette variable d’environnement est paramétrée, aptitude l’utilisera pour afficher les journaux de modification à l’invocation de « \fBaptitude changelog\fR ». La valeur par défaut est \fBmore\fR.

\fBTMP\fR

Quand \fBTMPDIR\fR n’est pas paramétrée, aptitude stockera ses fichiers temporaires dans \fBTMP\fR si cette dernière variable est paramétrée. Sinon, il les stockera dans /tmp.

\fBTMPDIR\fR

aptitude stockera ses fichiers temporaires dans le répertoire spécifié par cette variable d’environnement. Si \fBTMPDIR\fR n’est pas paramétrée, alors \fBTMP\fR est utilisée. Si cette dernière ne l’est pas non plus, alors aptitude utilise /tmp.

apt−get(8), apt(8), /usr/share/doc/aptitude/html/<lang>/index.html from paquet aptitude−doc−<lang>

Daniel Burrows <dburrows@debian.org>

Auteur.

This manual page is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This manual page is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Daniel Burrows.

Cette page de man a été originellement traduite par Martin Quinson <martin.quison@ens-lyon.fr>. Les mises à jour sont de Sylvain Cherrier <sylvain.cherrier@free.fr> jusqu’en 2004. Cette page est depuis maintenue par Olivier Trichet <nive@freesurf.fr>.