apt-get(8) (Français)

Nom

apt-get – Utilitaire de manipulation des paquets APT – interface de ligne de commande

Synopsis

apt-get command 

Description

apt-get est l’outil de ligne de commande pour la manipulation des paquets, et peut être considéré comme le « back-end » de l’utilisateur vers d’autres outils utilisant la bibliothèque APT. Plusieurs interfaces « frontales » existent, comme synaptic et aptitude.

Commandes

À moins que l’option -h, ou –help ne soit donnée, l’une des commandes ci-dessous doit être présente. update Utilisé pour resynchroniser les fichiers d’index des paquets à partir de leurs sources. Les index des paquets disponibles sont récupérés à partir du ou des emplacements spécifiés dans/etc/apt/sources.list(5). Une mise à jour doit toujours être effectuée avant une mise à niveau ou un dist-upgrade. upgrade Utilisé pour installer les dernières versions de tous les paquets actuellement installés sur le système à partir des sources énumérées dans /etc/apt/sources.list(5). Les paquets actuellement installés avec de nouvelles versions disponibles sont récupérés et mis à niveau ; en aucun cas les paquets actuellement installés ne sont supprimés, et les paquets qui ne sont pas déjà installés ne sont pas récupérés et installés. Les nouvelles versions des paquets actuellement installés qui ne peuvent pas être mises à niveau sans modifier l’état d’installation d’un autre paquet seront laissées à leur version actuelle. Une mise à jour doit d’abord être effectuée pour qu’apt-get sache que de nouvelles versions de paquets sont disponibles. dist-upgrade En plus d’effectuer la fonction de mise à niveau, cette option gère intelligemment les changements de dépendances avec les nouvelles versions de paquets ; apt-get a un système de résolution de conflits « intelligent », et il tentera de mettre à niveau les paquets les plus importants au détriment des moins importants, si nécessaire. Le fichier /etc/apt/sources.list(5) contient une liste d’emplacements à partir desquels récupérer les fichiers de paquets souhaités. Voir également apt_preferences(5) pour un mécanisme permettant d’outrepasser les paramètres généraux pour les paquets individuels. install pkg(s) Cette option est suivie d’un ou plusieurs paquets que l’on souhaite installer. Chaque paquetage est un nom de paquetage, et non un nom de fichier entièrement qualifié (par exemple, dans un système Fedora Core, glibc serait l’argument fourni, et non glibc-2.4.8.i686.rpm). Tous les paquets requis par le(s) paquet(s) spécifié(s) pour l’installation seront également récupérés et installés. Le fichier /etc/apt/sources.list(5) est utilisé pour localiser les dépôts des paquets souhaités. Si un trait d’union (-) est ajouté au nom du paquet (sans espace intermédiaire), le paquet identifié sera supprimé s’il est actuellement installé. De même, un signe plus (+) peut être utilisé pour désigner un paquet à installer. Ces dernières fonctionnalités peuvent être utilisées pour passer outre les décisions prises par le système de résolution des conflits d’apt-get. Une version spécifique d’un paquet peut être sélectionnée pour l’installation en faisant suivre le nom du paquet par un signe égal (=) et la version du paquet à sélectionner. Cela aura pour effet de localiser et de sélectionner cette version pour l’installation. Alternativement, une distribution spécifique peut être sélectionnée en faisant suivre le nom du paquet d’une barre oblique (/) et de la version de la distribution ou du nom de l’archive (c’est-à-dire stable, testing, unstable). Ces deux mécanismes de sélection de version peuvent déclasser des paquets et doivent être utilisés avec précaution. Enfin, le mécanisme apt_preferences(5) vous permet de créer une politique d’installation alternative pour des paquets individuels. Si aucun paquet ne correspond à l’expression donnée et que celle-ci contient l’un des éléments « . »,  » ? » ou « * », elle est considérée comme une expression régulière POSIX et appliquée à tous les noms de paquets de la base de données. Toutes les correspondances sont alors installées (ou supprimées). Notez que la correspondance est faite par sous-chaîne, donc « lo.* » correspond à « how-lo » et « lowest ». Si cela n’est pas souhaité, ancrez l’expression régulière avec un caractère « ^ » ou « $ », ou créez une expression régulière plus spécifique. remove pkg(s) Identique à install sauf que les paquets sont supprimés au lieu d’être installés. Si un signe plus (+) est ajouté au nom du paquetage (sans espace), le paquetage identifié sera installé au lieu d’être supprimé. source source_pkg Demande à apt-get de récupérer les paquets sources. APT examinera les paquets disponibles pour décider du paquet source à récupérer. Il trouvera et téléchargera ensuite dans le répertoire courant la version disponible la plus récente de ce paquet source. Les paquets sources sont suivis séparément des paquets binaires par des lignes de type viarpm-src dans le fichier sources.list(5). Cela signifie probablement que vous n’obtiendrez pas la même source que le paquet que vous avez installé, ou que vous pourriez installer. Si l’option –compile est spécifiée, le paquet sera compilé en un binaire en utilisant rpmbuild, si –download-only est spécifié, le paquet source ne sera pas décompressé. Une version spécifique de la source peut être récupérée en faisant suivre le nom de la source d’un égal (=) puis de la version à récupérer, de manière similaire au mécanisme utilisé pour les fichiers du paquet. Cela permet une correspondance exacte entre le nom du paquet source et la version, ce qui active implicitement l’option APT::Get::Only-Source. Notez que les paquets source ne sont pas suivis comme les paquets binaires, ils n’existent que dans le répertoire courant et sont similaires au téléchargement de tar balls source. build-dep source_pkg Force apt-get à installer/supprimer des paquets pour tenter de satisfaire les dépendances de construction d’un paquet source. check Outil de diagnostic ; il met à jour le cache des paquets et vérifie les dépendances brisées. clean Vide le référentiel local des fichiers de paquets récupérés. Il supprime tout sauf le fichier de verrouillage de /var/cache/apt/archives/ et/var/cache/apt/archives/partial/. autoclean Comme clean, autoclean vide le référentiel local des fichiers de paquets récupérés. La différence est qu’il ne supprime que les fichiers de paquets qui ne peuvent plus être téléchargés et qui sont largement inutiles. Cela permet de maintenir un cache sur une longue période de temps sans qu’il devienne incontrôlable. L’option de configuration APT::Clean-Installed empêchera les paquets installés d’être effacés si elle est définie sur off.

Options

Toutes les options de la ligne de commande peuvent être définies en utilisant le fichier de configuration, les descriptions indiquent l’option de configuration à définir. Pour les options booléennes, vous pouvez surcharger le fichier de configuration en utilisant quelque chose comme -f-, –no-f, -f=no ou plusieurs autres variantes.

-d, –download-only Téléchargement uniquement ; les fichiers de paquets sont seulement récupérés, pas décompressés ou installés. Élément de configuration : APT::Get::Download-Only. -f, –fix-broken Correction. Tente de corriger un système avec des dépendances cassées en place. Cette option, lorsqu’elle est utilisée avec install/remove, peut omettre tout paquet pour permettre à APT de déduire une solution probable. Tout paquet spécifié doit corriger complètement le problème. Cette option est parfois nécessaire lorsque vous exécutez APT pour la première fois ; APT lui-même ne permet pas l’existence de dépendances de paquets brisées sur un système. Il est possible que la structure de dépendance d’un système soit si corrompue qu’elle nécessite une intervention manuelle. L’utilisation de cette option conjointement avec -m peut produire une erreur dans certaines situations. Élément de configuration : APT::Get::Fix-Broken. -m, –ignore-missing, –fix-missing Ignorer les paquets manquants. Si les paquets ne peuvent pas être récupérés ou échouent au contrôle d’intégrité après la récupération (fichiers de paquets corrompus), retenez ces paquets et gérez le résultat. L’utilisation de cette option avec -f peut produire une erreur dans certaines situations. Si un paquet est sélectionné pour l’installation (particulièrement s’il est mentionné sur la ligne de commande) et qu’il n’a pas pu être téléchargé, il sera silencieusement retenu. Élément de configuration : APT::Get::Fix-Missing.–no-download Désactive le téléchargement des paquets. Il est préférable de l’utiliser avec –ignore-missing pour forcer APT à utiliser uniquement les rpms qu’il a déjà téléchargés. Élément de configuration : APT::Get::Download. -q, –quiet Silencieux. Produit une sortie adaptée à la journalisation, en omettant les indicateurs de progression. Plus de q produiront plus de silence jusqu’à un maximum de deux. Vous pouvez également utiliser-q=# pour définir le niveau de silence, en remplaçant le fichier de configuration. Notez que le niveau de silence 2 implique -y, vous ne devriez jamais utiliser -qq sans un modificateur d’action tel que -d, –print-uris ou -s car APT peut décider de faire quelque chose que vous n’attendiez pas. Élément de configuration : quiet. -s, –simulate, –just-print, –dry-run, –recon, –no-act Aucune action. Effectue une simulation d’événements qui se produiraient mais qui ne modifient pas réellement le système. Élément de configuration : APT::Get::Simulate.Simulate imprime une série de lignes, chacune représentant une opération du régime : Configure (Conf), Remove (Remv), Unpack (Inst). Les crochets indiquent les paquets cassés, un ensemble vide de crochets signifiant des cassures sans conséquence (rares). -y, –yes, –assume-yes Oui automatique aux invites. Suppose que « oui » est la réponse à toutes les invites et s’exécute de manière non interactive. Si une situation indésirable, telle que la modification d’un paquet maintenu ou la suppression d’un paquet essentiel, se produit, apt-get s’interrompt. Élément de configuration : APT::Get::Assume-Yes. -u, –show-upgraded Afficher les paquets mis à jour. Imprime une liste de tous les paquets qui doivent être mis à niveau. Élément de configuration : APT::Get::Show-Upgraded. -V, –verbose-versions Affiche les versions complètes des paquets mis à niveau et installés. Élément de configuration : APT::Get::Show-Versions. -b, –compile, –build Compile les paquets sources après les avoir téléchargés. Élément de configuration : APT::Get::Compile.–ignore-hold Ignorer les paquets maintenus. Ceci permet à apt-get d’ignorer un blocage placé sur un paquet. Cela peut être utile en conjonction avec dist-upgrade pour ignorer un grand nombre de blocages non désirés. Élément de configuration : APT::Ignore-Hold.–no-upgrade Ne pas mettre à niveau les paquets. Utilisé en conjonction avec install, no-upgrade empêchera les paquets listés d’être mis à niveau s’ils sont déjà installés. Élément de configuration : APT::Get::Upgrade.–force-yes Force yes. C’est une option dangereuse qui fera qu’apt-get continuera sans demander si elle fait quelque chose de potentiellement dangereux. Elle ne doit être utilisée que dans des situations très particulières. L’utilisation de –force-yes peut potentiellement détruire votre système ! Élément de configuration : APT::Get::force-yes.–print-uris Au lieu d’aller chercher les fichiers à installer, leurs URI sont imprimés. Chaque URI contient le chemin, le nom du fichier de destination, la taille et le md5hash attendu. Notez que le nom du fichier à écrire ne correspondra pas toujours au nom du fichier sur le site distant ! Cela fonctionne également avec les commandes source et update. Lorsqu’elle est utilisée avec la commande update, le MD5 et la taille ne sont pas inclus, et c’est à l’utilisateur de décompresser tout fichier compressé. Élément de configuration : APT::Get::Print-URIs.–reinstall Réinstalle les paquets qui sont déjà installés et dont la version est la plus récente. Élément de configuration : APT::Get::ReInstall.–list-cleanup Cette option est activée par défaut, utilisez –no-list-cleanup pour la désactiver. Lorsqu’elle est activée, apt-get gère automatiquement le contenu de/var/lib/apt/lists pour s’assurer que les fichiers obsolètes sont effacés. La seule raison de la désactiver est si vous changez fréquemment votre liste de sources. Élément de configuration : APT::Get::List-Cleanup. -t, –target-release, –default-release Cette option contrôle l’entrée par défaut du moteur de politique. Elle crée une épingle par défaut à la priorité 990 en utilisant la chaîne de libération spécifiée. Le fichier de préférences peut outrepasser ce paramètre. En bref, cette option vous permet d’avoir un contrôle simple sur la distribution à partir de laquelle les paquets seront récupérés. Les exemples les plus courants sont -t ‘2.1*’ ou -t unstable. Élément de configuration : APT::Default-Release ; voir aussi la page de manuel apt_preferences(5). –trivial-only Effectuer uniquement les opérations qui sont « triviales ». Logiquement, cela peut être considéré comme lié à –assume-yes. Alors que –assume-yes répondra oui à toute demande, –trivial-only répondra non. Élément de configuration : fIAPT::Get::Trivial-Only.–no-remove Si des paquets doivent être supprimés, apt-get abandonne immédiatement sans message d’invite. Élément de configuration : APT::Get::Remove.–only-source N’a de sens que pour la commande source. Indique que les noms de sources donnés ne doivent pas être mappés par la table binaire. Cela signifie que si cette option est spécifiée, la commande source n’acceptera que les noms de paquets sources comme arguments, plutôt que d’accepter les noms de paquets binaires et de rechercher le paquet source correspondant. Élément de configuration : APT::Get::Only-Source. -h, –help Affiche un bref résumé de l’utilisation. -v, –version Affiche la version du programme. -c, –config-file Fichier de configuration. Spécifie un fichier de configuration à utiliser. Le programme lira le fichier de configuration par défaut et ensuite ce fichier de configuration. Voirapt.conf(5) pour des informations sur la syntaxe. -o, –option Définit une option de configuration. Ceci définira une option de configuration arbitraire. La syntaxe est -o Foo::Bar=bar.

Files

/etc/apt/sources.list Emplacements à partir desquels récupérer les paquets. Élément de configuration : Dir::Etc::SourceList./etc/apt/apt.conf Fichier de configuration d’APT. Élément de configuration : Dir::Etc::Main./etc/apt/apt.conf.d/ Fragments du fichier de configuration d’APT. Élément de configuration : Dir::Etc::Parts./etc/apt/preferences Fichier de préférences de version. C’est ici que vous spécifiez le « pinning », c’est-à-dire une préférence pour obtenir certains paquets à partir d’une source distincte ou d’une version différente d’une distribution. Élément de configuration : Dir::Etc::Preferences./var/cache/apt/archives/ Zone de stockage pour les fichiers de paquets récupérés. Élément de configuration : Dir::Cache::Archives./var/cache/apt/archives/partial/ Zone de stockage pour les fichiers de paquets en transit. Élément de configuration : Dir::Cache::Archives (implicite partiel)./var/lib/apt/lists/ Zone de stockage des informations d’état pour chaque ressource de paquetage 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 d’état en transit. Élément de configuration : Dir::State::Lists (partiel implicite).

Voir aussi

apt-cache(8), apt-cdrom(8), sources.list(5),apt.conf(5),
apt-config(8), apt_preferences(5)

Diagnostics

apt-get renvoie zéro en fonctionnement normal, décimal 100 en cas d’erreur.

Bugs

La meilleure façon de signaler les bogues dans APT-RPM est de le faire dans la liste de diffusion APT-RPM à l’adressehttp://apt-rpm.org/mailinglist.shtml.

Auteur

Les informations sur les mainteneurs et les contributeurs se trouvent dans la page des créditshttp://apt-rpm.org/about.shtml d’APT-RPM.