NAME
apt-get - Utilitaire APT pour la gestion des paquets -- interface en
ligne de commande.
SYNOPSIS
apt-get [-sqdyfmubV] [-o= config_string ] [-c= config_file ]
[-t= target_release] {update | upgrade | dselect-upgrade |
dist-upgrade |
install pkg [ { =pkg_version_number | /target_release } ] ...
| remove pkg... | purge pkg... |
source pkg [ { =pkg_version_number | /target_release } ] ... |
build-dep pkg... | check | clean | autoclean | autoremove |
{-v | --version} | {-h | --help}}
apt-get is the command-line tool for handling packages, and may be
considered the user's "back-end" to other tools using the APT library.
Several "front-end" interfaces exist, such as dselect(1), aptitude(8),
synaptic(8) and wajig(1).
moins que l'option -h ou --help ne soit donne, l'une des commandes
suivantes doit tre prsente.
update
La commande update permet de resynchroniser un fichier d'index
rpertoriant les paquets disponibles et sa source. Ces fichiers sont
rcuprs aux endroits spcifis dans /etc/apt/sources.list. Ainsi,
lorsqu'on utilise une archive Debian, cette commande rcupre les
fichiers Packages.gz et les analyse de manire rendre disponibles
les informations concernant les nouveaux paquets et les paquets mis
jour. On doit toujours excuter une commande update avant les
commandes upgrade ou dist-upgrade. Veuillez noter que l'indicateur
de progression d'ensemble peut tre imprcis puisque la taille de ces
fichiers ne peut tre connue l'avance.
upgrade
La commande upgrade permet d'installer les versions les plus
rcentes de tous les paquets prsents sur le systme en utilisant les
sources numres dans /etc/apt/sources.list. Les paquets installs
dont il existe de nouvelles versions sont rcuprs et mis niveau. En
aucun cas des paquets dj installs ne sont supprims ; de mme, des
paquets qui ne sont pas dj installs ne sont ni rcuprs ni installs.
Les paquets dont de nouvelles versions ne peuvent pas tre installes
sans changer le statut d'installation d'un autre paquet sont laisss
dans leur version courante. On doit d'abord excuter la commande
update pour que apt-get connaisse l'existence de nouvelles versions
des paquets.
dselect-upgrade
dselect-upgrade est utilise conjointement avec dselect(1), la plus
ancienne interface du projet Debian pour la gestion des paquets. La
commande dselect-upgrade suit les modifications faites par
dselect(1) dans le champ Status des paquets disponibles, et
effectue les actions ncessaires la ralisation de cet tat (par
exemple, suppression d'anciens paquets, installation de nouveaux
paquets).
dist-upgrade
La commande dist-upgrade effectue la fonction upgrade en y ajoutant
une gestion intelligente des changements de dpendances dans les
nouvelles versions des paquets ; apt-get possde un systme
<< intelligent >> de rsolution des conflits et il essaye, quand
c'est ncessaire, de mettre niveau les paquets les plus importants
avant les paquets les moins importants. Le fichier
/etc/apt/sources.list contient une liste de sources o rcuprer les
paquets dsirs. Voyez aussi apt_preferences(5) pour un mcanisme de
remplacement des paramtres gnraux pour certains paquets.
install
La commande install est suivie par un ou plusieurs paquets
installer. Chaque paquet est un nom de paquet ; ce n'est pas un nom
complet de fichier (par exemple, dans un systme Debian GNU/Linux,
on indiquera libc6 et non pas libc6_1.9.6-2.deb). Tous les paquets
requis par le(s) paquet(s) que l'on veut installer sont aussi
rcuprs et installs. Le fichier /etc/apt/sources.list est utilis
pour retrouver les paquets dsirs. Quand un trait d'union est accol
(sans espace intermdiaire) au nom d'un paquet dj install, ce paquet
est supprim. De mme on peut ajouter un signe << + >> pour dsigner
un paquet installer. Cette dernire fonctionnalit peut tre utilise
pour annuler les dcisions prises par le systme de rsolution des
conflits d'apt-get.
On peut choisir d'installer une version particulire d'un paquet en
faisant suivre son nom par un signe gal et par la version. Cette
version sera recherche et l'installation sera demande. On peut
aussi choisir une distribution particulire en faisant suivre le nom
du paquet par une barre oblique et par le nom de la distribution ou
de l'archive (stable, testing, unstable).
Avec ces possibilits de choisir la version, de vieilles versions
d'un paquet peuvent tre installes. Cette fonctionnalit est donc
utiliser avec prcaution.
Cette mthode est aussi utile pour mettre jour un ou plusieurs
paquets dj installs sans mettre jour les autres paquets du systme.
la diffrence de la commande << upgrade >> qui installera la dernire
version disponible de tous les paquets installs au moment de son
excution, << install >> n'installera la nouvelle version que pour
le(s) paquet(s) indiqu(s). Il suffit de fournir le nom du(des)
paquet(s) mettre jour et si une nouvelle version est disponible,
cette version (et ses dpendances, comme dcrit plus haut) sera
rcupre et installe.
Enfin, le mcanisme d'apt_preferences(5) permet de crer d'autres
rgles pour l'installation des paquets.
Quand aucun paquet ne correspond l'expression donne en paramtre et
que cette expression contient l'un des caractres << . >>, << ? >>
ou << * >>, elle est considre comme une expression rationnelle
POSIX et elle est applique tous les paquets de la base de donnes.
Tout paquet correspondant est install (ou supprim). Veuillez noter
que la comparaison est effectue par sous-chane et << lo.* >>
correspond aussi bien << how-lo >> qu' << lowest >>. Si ce n'est
pas le comportement souhait, l'expression peut tre ancre avec un
caractre << ^ >> ou un caractre << $ >>, une autre possibilit tant
d'utiliser une expression plus prcise.
remove
La commande remove est identique la commande install, les paquets
tant alors supprims et non installs. Veuillez noter que la
suppression d'un paquet en laisse les fichiers de configuration sur
le systme. Quand un signe plus est accol (sans espace intermdiaire)
au nom du paquet, le paquet est install au lieu d'tre supprim.
purge
La commande purge est identique remove mais les paquets indiqus
sont supprims et purgs (leurs fichiers de configuration sont
galement effacs).
source
Avec la commande source, apt-get rcupre des paquets source. APT
examine les paquets disponibles pour choisir le paquet source
rcuprer. Il tlcharge ensuite dans le rpertoire courant la version
la plus rcente du paquet, dfinie par rapport la distribution par
dfaut tablie soit avec l'option APT::Default-Release, soit avec
l'option -t ou soit par paquet avec la syntaxe paquet/version
"""while respect the default release""" me parat douteux.
Les paquets source sont grs indpendamment des paquets binaires,
avec les lignes de type deb-src dans le fichier sources.list(5). Il
est donc ncessaire d'ajouter une telle ligne pour chaque dpt pour
lequel vous souhaitez pouvoir obtenir les sources. Dans le cas
contraire, vous n'obtiendrez pas les mmes sources que celles du
paquet que vous avez install ou que vous voulez installer.
Si l'option --compile est spcifie, le paquet est compil en un
binaire .deb avec dpkg-buildpackage. Si --download-only est spcifi,
le source n'est pas dcompact.
De la mme faon qu'avec les paquets binaires, on peut rcuprer une
version particulire d'un paquet source en faisant suivre son nom
par un signe gal et par la version. Cela permet une comparaison
exacte entre le nom du paquet source et la version ; l'option
correspondante est : APT::Get::Only-Source.
Veuillez noter que les paquets source ne sont pas suivis comme le
sont les paquets binaires. Ils ne sont prsents que dans le
rpertoire courant et sont semblables des sources tlcharges sous
forme d'archives tar.
build-dep
Avec la commande build-dep, apt-get installe ou supprime des
paquets dans le but de satisfaire les dpendances de construction
d'un paquet source.
check
La commande check est un outil de diagnostic ; il met jour le
cache des paquets et cherche les dpendances dfectueuses.
clean
La commande clean nettoie le rfrentiel local des paquets rcuprs.
Elle supprime tout, except le fichier de verrou situ dans
/var/cache/apt/archives/ et /var/cache/apt/archives/partial/. Quand
APT est utilis comme mode de dselect(1), clean est excut
automatiquement. Quand on n'utilise pas dselect, il faut excuter
apt-get clean de temps en temps si l'on veut librer de l'espace
disque.
autoclean
Tout comme clean, autoclean nettoie le rfrentiel local des paquets
rcuprs. La diffrence est qu'il supprime uniquement les paquets qui
ne peuvent plus tre tlchargs et qui sont inutiles. On peut ainsi
contrler la taille de ce cache sur une longue priode. Tant qu'elle
n'est pas active, l'option de configuration APT::Clean-Installed
empche la suppression de paquets installs.
autoremove
Avec la commande autoremove, apt-get supprime les paquets installs
dans le but de satisfaire les dpendances d'un paquet donn et qui ne
sont plus ncessaires.
OPTIONS
Toutes les options de la ligne de commande peuvent tre dfinies dans le
fichier de configuration, les descriptions indiquant l'option de
configuration concerne. Pour les options boolennes, vous pouvez
inverser les rglages du fichiers de configuration avec -f-,--no-f,
-f=no et d'autres variantes analogues.
--no-install-recommends
Ne pas considrer les paquets recommands comme des dpendances
installer. lment de configuration : APT::Install-Recommends.
-d, --download-only
Rcupration seule ; les paquets sont rcuprs mais ne sont ni dpaquets
ni installs. lment de configuration : APT::Get::Download-Only.
-f, --fix-broken
Correction ; cette option demande de rparer un systme o existent
des dpendances dfectueuses. Utilise avec install ou remove, elle
peut exclure un paquet pour permettre de dduire une solution
viable. Tout paquet spcifi doit compltement corriger le problme.
Cette option est quelquefois ncessaire lorsque l'on excute APT pour
la premire fois ; APT interdit les dpendances dfectueuses dans un
systme. Il est possible que la structure de dpendances d'un systme
soit tellement corrompue qu'elle requiert une intervention manuelle
(ce qui veut dire la plupart du temps utiliser dselect(1) ou dpkg
--remove pour liminer les paquets en cause). L'utilisation de cette
option conjointement avec -m peut produire une erreur dans
certaines situations. lment de configuration :
APT::Get::Fix-Broken.
-m, --ignore-missing, --fix-missing
Ignorer les paquets manquants ; si des paquets ne peuvent tre
rcuprs, ou, aprs rcupration, ne satisfont pas au contrle d'intgrit,
cette commande met ces paquets de ct et gre le rsultat. Utiliser
cette option conjointement avec -f peut produire une erreur dans
certaines situations. Quand un paquet, slectionn pour une
installation (particulirement si c'est mentionn en ligne de
commande), ne peut tre rcupr, il est mis silencieusement de ct.
lment de configuration : APT::Get::Fix-Missing.
--no-download
Pas de rcupration. Le mieux est d'utiliser cette option avec
--ignore-missing pour forcer APT n'utiliser que les .deb qu'il a
dj rcuprs. lment de configuration : APT::Get::Download.
-q, --quiet
Mode silencieux ; cette commande produit une sortie destine
l'enregistrement dans un fichier-journal en omettant les
indicateurs de progression. Un plus grand nombre de << q >> (2 au
plus) produit un plus grand silence. On peut aussi utiliser -q=#
pour positionner le niveau de silence, et annuler le fichier de
configuration. Notez qu'un niveau de silence gal 2 implique -y et
vous ne devez jamais utiliser -qq sans l'accompagner d'un
modificateur tel que -d, --print-uris ou -s : APT pourrait alors
excuter des actions inattendues. lment de configuration : quiet.
-s, --simulate, --just-print, --dry-run, --recon, --no-act
Pas d'action ; simule les vnements qui devraient se produire sans
effectuer de changement rel sur le systme. lment de configuration :
APT::Get::Simulate.
Lorsque la simulation est effectue par un utilisateur sans
privilge, le verrouillage (Debug::NoLocking) sera dsactiv
automatiquement. Une mention explicite indiquant qu'il s'agit d'une
simple simulation sera affiche si l'option
APT::Get::Show-User-Simulation-Note est active (elle est active par
dfaut). Ni la dsactivation du verrou ni l'affichage de la mention
de simulation ne seront dclenches si la commande est lance par
l'utilisateur root (pour qui il n'est pas jug utile qu'apt-get
envoie de telles notifications).
La simulation affiche une srie de lignes reprsentant chacune une
opration de dpkg, Configure (Conf), Remove (Remv), Unpack (Inst).
Des crochets encadrent des paquets endommags et des crochets
n'encadrant rien indiquent que les dommages n'ont aucune consquence
(rare).
-y, --yes, --assume-yes
Rpondre automatiquement oui aux questions ; prsume << oui >> comme
rponse toutes les questions et s'excute de manire non interactive.
Dans le cas d'une situation indsirable, comme le changement d'un
paquet gel, l'installation d'un paquet non authentifi ou la
suppression d'un paquet essentiel, apt-get s'interrompt. lment de
configuration : APT::Get::Assume-Yes.
-u, --show-upgraded
Afficher les paquets mis niveau ; affiche une liste de tous les
paquets mettre niveau. lment de configuration :
APT::Get::Show-Upgraded.
-V, --verbose-versions
Afficher les versions compltes des paquets installs ou mis niveau.
lment de configuration : APT::Get::Show-Versions.
-b, --compile, --build
Cette commande compile un paquet source aprs l'avoir rcupr. lment
de configuration : APT::Get::Compile.
--install-recommends
Installer galement les paquets recommands.
--no-install-recommends
Ne pas installer les paquets recommands.
--ignore-hold
Cette commande ignore la marque << Hold >> (<< garder >>) d'un
paquet ; par ce biais, apt-get ignore un << hold >> plac sur un
paquet. cela peut tre utile avec dist-upgrade pour annuler un grand
nombre de << hold >> indsirables. lment de configuration :
APT::Ignore-Hold.
--no-upgrade
Aucune mise niveau ; quand elle est utilise avec install, cette
commande empche les paquets mentionns sur la ligne de commande
d'tre mis niveau. lment de configuration : APT::Get::Upgrade.
--only-upgrade
Do not install new packages; When used in conjunction with install,
only-upgrade will prevent packages on the command line from being
upgraded if they are not already installed. Configuration Item:
APT::Get::Only-Upgrade.
--force-yes
Forcer l'acceptation ; cette option est dangereuse parce qu'elle
laisse APT continuer sans poser de questions quand il ralise
quelque chose de potentiellement dommageable. Cette option ne doit
tre utilise que dans des circonstances trs spciales. Utiliser
force-yes peut dtruire le systme... lment de configuration :
APT::Get::force-yes.
--print-uris
Au lieu de rcuprer les paquets installer, leurs URI sont affiches.
Chaque URI a un chemin, un nom de fichier destination, une taille
et une cl md5 attendue. Veuillez noter que le nom de fichier
afficher ne correspond pas toujours au nom de fichier sur le site
distant. Cette option fonctionne aussi avec la commande source et
avec la commande update. Avec la commande update, la somme MD5 et
la taille ne sont pas donnes et c'est l'utilisateur de dcompresser
les fichiers compresss. lment de configuration :
APT::Get::Print-URIs.
--purge
Utiliser << purge >> la place de << remove >> pour supprimer tout
ce qui peut tre supprim. Un astrisque (*) sera accol aux noms des
paquets qui vont tre purgs. remove --purge est quivalent la
commande purge. lment de configuration : APT::Get::Purge.
--reinstall
Rinstaller les paquets dj installs avec leur version la plus
rcente. lment de configuration : APT::Get::ReInstall.
--list-cleanup
Cette option est active par dfaut ; utilisez --no-list-cleanup pour
la dsactiver. Quand elle est active, apt-get gre automatiquement le
contenu de /var/lib/apt/lists afin d'assurer que les fichiers
obsoltes soient effacs. La seule raison de la dsactiver est une
modification frquente de la liste de sources. lment de
configuration : APT::Get::List-Cleanup.
-t, --target-release, --default-release
Cette option contrle l'entre par dfaut pour les questions de
distribution ; une tiquette (pin) par dfaut dont la priorit vaut
990 est cre en utilisant la chane spcifie. Le fichier des prfrences
peut annuler cette dcision. En clair, cette option permet de
contrler simplement dans quelle distribution seront rcuprs les
paquets. Par exemple : -t '2.1*', -t unstable ou -t sid. lment de
configuration : APT::Default-Release. Voyez aussi la page de manuel
d'apt_preferences(5).
--trivial-only
Ne ralise que les oprations << triviales >>. Logiquement ceci peut
tre considr comme relatif --assume-yes. Alors que --assume-yes
rpond oui n'importe quelle question, --trivial-only rpond non.
lment de configuration : APT::Get::Trivial-Only.
--no-remove
Arrter immdiatement apt-get, sans poser de questions, si des
paquets doivent tre supprims. lment de configuration :
APT::Get::Remove.
--auto-remove
Si la commande utilise est soit install soit remove, cette option a
le mme effet qu'autoremove et supprime les paquets de dpendance
inutiliss. lment de configuration : APT::Get::Upgrade.
--only-source
Cette option n'a de sens qu'avec les commandes source et build-dep.
Elle indique que les noms de sources donns ne doivent pas tre reprs
travers le tableau des binaires. Cela signifie que si cette option
est choisie, la commande source acceptera seulement des noms de
paquets source comme argument ; elle n'acceptera pas de les
rechercher partir des noms de paquets binaires correspondants.
lment de configuration : APT::Get::Only-Source
--diff-only, --dsc-only, --tar-only
Ne tlcharger que le fichier .diff, .dsc ou .tar d'une archive
source. lment de configuration : APT::Get::Diff-Only,
APT::Get::Dsc-Only et APT::Get::Tar-Only,
--arch-only
Ne traiter que les dpendances de construction dpendantes de
l'architecture. lment de configuration : APT::Get::Arch-Only.
--allow-unauthenticated
Ignorer le fait que les paquets ne peuvent pas tre authentifis ; ne
le signale pas l'utilisateur. Cette option est trs utile pour
certains outils comme pbuilder. lment de configuration :
APT::Get::AllowUnauthenticated.
-h, --help
Afficher un bref rsum de l'utilisation.
-v, --version
Afficher la version du programme.
-c, --config-file
Configuration File; Specify a configuration file to use. The
program will read the default configuration file and then this
configuration file. If configuration settings need to be set before
the default configuration files are parsed specify a file with the
APT_CONFIG environment variable. See apt.conf(5) for syntax
information.
-o, --option
Dfinir une option de configuration ; permet de rgler une option de
configuration donne. La syntaxe est -o Foo::Bar=bar. -o et
--option peuvent tre utilises plusieurs fois pour dfinir des
options diffrentes.
FICHIERS
/etc/apt/sources.list
Emplacement pour la rcupration des paquets. lment de
configuration : Dir::Etc::SourceList.
/etc/apt/sources.list.d/
Fragments de fichiers dfinissant les emplacements de rcupration de
paquets. lment de configuration : Dir::Etc::SourceParts.
/etc/apt/apt.conf
Fichier de configuration d'APT. lment de configuration :
Dir::Etc::Main.
/etc/apt/apt.conf.D/
Fragments du fichier de configuration d'APT. lment de
configuration : Dir::Etc::Parts.
/etc/apt/preferences
Fichier des prfrences. C'est dans ce fichier qu'on peut faire de
l'tiquetage (pinning) c'est--dire, choisir d'obtenir des paquets
d'une source distincte ou d'une distribution diffrente. lment de
configuration : Dir::Etc::Preferences.
/etc/apt/preferences.d/
Fragments de fichiers pour la prfrence des versions. lment de
configuration : Dir::Etc::PreferencesParts.
/var/cache/apt/archives/
Zone de stockage des fichiers rcuprs. lment de configuration :
Dir::Cache::Archives.
Z .PP /var/cache/apt/archives/partial/
Zone de stockage pour les paquets en transit. lment de
configuration : Dir::Cache::Archives (implicitement, partial).
/var/lib/apt/lists/
Zone de stockage pour les informations qui concernent chaque
ressource de paquet spcifie dans sources.list(5) lment de
configuration : Dir::State::Lists.
/var/lib/apt/lists/partial/
Zone de stockage pour les informations en transit. lment de
configuration : Dir::State::Lists (implicit partial).
VOIR AUSSI
apt-cache(8), apt-cdrom(8), dpkg(1), dselect(1), sources.list(5),
apt.conf(5), apt-config(8), le guide d'APT dans
/usr/share/doc/apt-doc/, apt_preferences(5), le << HOWTO >> d'APT.
DIAGNOSTICS
apt-get renvoie zro aprs une opration normale, le dcimal 100 en cas
d'erreur.
AUTEURS D'ORIGINE
Jason Gunthorpe
AUTEURS ACTUELS
quipe de dveloppement d'APT
Page qualit[1]
BOGUES
Page des bogues d'APT[2]. 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
Jrme Marant, Philippe Batailler, Christian Perrier bubulle@debian.org
(2000, 2005, 2009, 2010), quipe de traduction francophone de Debian
debian-l10n-french@lists.debian.org
Veuillez noter que cette traduction peut contenir des parties non
traduites Cela est volontaire, pour viter de perdre du contenu quand la
traduction est lgrement en retard sur le contenu d'origine.
AUTHORS
Jason Gunthorpe
quipe de dveloppement d'APT
NOTES
1. Page qualit
http://packages.qa.debian.org/a/apt.html
2. Page des bogues d'APT
http://bugs.debian.org/src:apt