Provided by:
apt_0.8.16~exp5ubuntu13_i386 
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] [-a= default_architecture] {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}}
DESCRIPTION
Apt-get est le programme en ligne de commande pour la gestion des
paquets. Il peut etre considere comme l'outil de base pour les autres
programmes de la bibliotheque APT. Plusieurs interfaces utilisateur
existent, comme dselect(1), aptitude(8), synaptic(8) and wajig(1).
A moins que l'option -h ou --help ne soit donnee, l'une des commandes
suivantes doit etre presente.
update
La commande update permet de resynchroniser un fichier d'index
repertoriant les paquets disponibles et sa source. Ces fichiers
sont recuperes aux endroits specifies dans /etc/apt/sources.list.
Ainsi, lorsqu'on utilise une archive Debian, cette commande
recupere les fichiers Packages.gz et les analyse de maniere a
rendre disponibles les informations concernant les nouveaux paquets
et les paquets mis a jour. On doit toujours executer une commande
update avant les commandes upgrade ou dist-upgrade. Veuillez noter
que l'indicateur de progression d'ensemble peut etre imprecis
puisque la taille de ces fichiers ne peut etre connue a l'avance.
upgrade
La commande upgrade permet d'installer les versions les plus
recentes de tous les paquets presents sur le systeme en utilisant
les sources enumerees dans /etc/apt/sources.list. Les paquets
installes dont il existe de nouvelles versions sont recuperes et
mis a niveau. En aucun cas des paquets deja installes ne sont
supprimes ; de meme, des paquets qui ne sont pas deja installes ne
sont ni recuperes ni installes. Les paquets dont de nouvelles
versions ne peuvent pas etre installees sans changer le statut
d'installation d'un autre paquet sont laisses dans leur version
courante. On doit d'abord executer la commande update pour que
apt-get connaisse l'existence de nouvelles versions des paquets.
dselect-upgrade
dselect-upgrade est utilisee 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 necessaires a la realisation de cet etat (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 dependances dans les
nouvelles versions des paquets ; apt-get possede un systeme
<< intelligent >> de resolution des conflits et il essaye, quand
c'est necessaire, de mettre a niveau les paquets les plus
importants avant les paquets les moins importants. Le fichier
/etc/apt/sources.list contient une liste de sources ou recuperer
les paquets desires. Voyez aussi apt_preferences(5) pour un
mecanisme de remplacement des parametres generaux pour certains
paquets.
install
La commande install est suivie par un ou plusieurs paquets a
installer. Chaque paquet est un nom de paquet ; ce n'est pas un nom
complet de fichier (par exemple, dans un systeme 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
recuperes et installes. Le fichier /etc/apt/sources.list est
utilise pour retrouver les paquets desires. Quand un trait d'union
est accole (sans espace intermediaire) au nom d'un paquet deja
installe, ce paquet est supprime. De meme on peut ajouter un signe
<< + >> pour designer un paquet a installer. Cette derniere
fonctionnalite peut etre utilisee pour annuler les decisions prises
par le systeme de resolution des conflits d'apt-get.
On peut choisir d'installer une version particuliere d'un paquet en
faisant suivre son nom par un signe egal et par la version. Cette
version sera recherchee et l'installation sera demandee. On peut
aussi choisir une distribution particuliere 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 possibilites de choisir la version, de vieilles versions
d'un paquet peuvent etre installees. Cette fonctionnalite est donc
a utiliser avec precaution.
Cette methode est aussi utile pour mettre a jour un ou plusieurs
paquets deja installes sans mettre a jour les autres paquets du
systeme. A la difference de la commande << upgrade >> qui
installera la derniere version disponible de tous les paquets
installes au moment de son execution, << install >> n'installera la
nouvelle version que pour le(s) paquet(s) indique(s). Il suffit de
fournir le nom du(des) paquet(s) a mettre a jour et si une nouvelle
version est disponible, cette version (et ses dependances, comme
decrit plus haut) sera recuperee et installee.
Enfin, le mecanisme d'apt_preferences(5) permet de creer d'autres
regles pour l'installation des paquets.
Quand aucun paquet ne correspond a l'expression donnee en parametre
et que cette expression contient l'un des caracteres << . >>,
<< ? >> ou << * >>, elle est consideree comme une expression
rationnelle POSIX et elle est appliquee a tous les paquets de la
base de donnees. Tout paquet correspondant est installe (ou
supprime). Veuillez noter que la comparaison est effectuee par
sous-chaine et << lo.* >> correspond aussi bien a << how-lo >> qu'a
<< lowest >>. Si ce n'est pas le comportement souhaite,
l'expression peut etre ancree avec un caractere << ^ >> ou un
caractere << $ >>, une autre possibilite etant d'utiliser une
expression plus precise.
remove
La commande remove est identique a la commande install, les paquets
etant alors supprimes et non installes. Veuillez noter que la
suppression d'un paquet en laisse les fichiers de configuration sur
le systeme. Quand un signe plus est accole (sans espace
intermediaire) au nom du paquet, le paquet est installe au lieu
d'etre supprime.
purge
La commande purge est identique a remove mais les paquets indiques
sont supprimes et purges (leurs fichiers de configuration sont
egalement effaces).
source
Avec la commande source, apt-get recupere des paquets source. APT
examine les paquets disponibles pour choisir le paquet source a
recuperer. Il telecharge ensuite dans le repertoire courant la
version la plus recente du paquet, definie par rapport a la
distribution par defaut etablie 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 parait douteux.
Les paquets source sont geres independamment des paquets binaires,
avec les lignes de type deb-src dans le fichier sources.list(5). Il
est donc necessaire d'ajouter une telle ligne pour chaque depot
pour lequel vous souhaitez pouvoir obtenir les sources. Dans le cas
contraire, vous n'obtiendrez pas les memes sources que celles du
paquet que vous avez installe ou que vous voulez installer.
If the --compile option is specified then the package will be
compiled to a binary .deb using dpkg-buildpackage for the
architecture as defined by the --host-architecture option. If
--download-only is specified then the source package will not be
unpacked.
De la meme facon qu'avec les paquets binaires, on peut recuperer
une version particuliere d'un paquet source en faisant suivre son
nom par un signe egal 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 presents que dans le
repertoire courant et sont semblables a des sources telechargees
sous forme d'archives tar.
build-dep
build-dep causes apt-get to install/remove packages in an attempt
to satisfy the build dependencies for a source package. By default
the dependencies are satisfied to build the package nativly. If
desired a host-architecture can be specified with the
--host-architecture option instead.
check
La commande check est un outil de diagnostic ; il met a jour le
cache des paquets et cherche les dependances defectueuses.
download
download will download the given binary package into the current
directory.
clean
La commande clean nettoie le referentiel local des paquets
recuperes. Elle supprime tout, excepte le fichier de verrou situe
dans /var/cache/apt/archives/ et /var/cache/apt/archives/partial/.
Quand APT est utilise comme mode de dselect(1), clean est execute
automatiquement. Quand on n'utilise pas dselect, il faut executer
apt-get clean de temps en temps si l'on veut liberer de l'espace
disque.
autoclean
Tout comme clean, autoclean nettoie le referentiel local des
paquets recuperes. La difference est qu'il supprime uniquement les
paquets qui ne peuvent plus etre telecharges et qui sont inutiles.
On peut ainsi controler la taille de ce cache sur une longue
periode. Tant qu'elle n'est pas activee, l'option de configuration
APT::Clean-Installed empeche la suppression de paquets installes.
autoremove
Avec la commande autoremove, apt-get supprime les paquets installes
dans le but de satisfaire les dependances d'un paquet donne et qui
ne sont plus necessaires.
changelog
changelog telecharge le journal des modifications d'un paquet et
l'affiche avec sensible-pager. Le nom du serveur et le repertoire
de base sont definis dans la variable APT::Changelogs::Server (p.
ex. http://packages.debian.org/changelogs pour Debian ou
http://changelogs.ubuntu.com/changelogs pour Ubuntu). Par defaut,
c'est le journal des modifications de la version installee du
paquet qui est affiche. Cependant, il est possible d'utiliser les
memes options que pour la commande install.
OPTIONS
Toutes les options de la ligne de commande peuvent etre definies dans
le fichier de configuration, les descriptions indiquant l'option de
configuration concernee. Pour les options booleennes, vous pouvez
inverser les reglages du fichiers de configuration avec -f-,--no-f,
-f=no et d'autres variantes analogues.
--no-install-recommends
Ne pas considerer les paquets recommandes comme des dependances a
installer. Element de configuration : APT::Install-Recommends.
--install-suggests
Considerer les paquets suggeres comme des dependances a installer.
Element de configuration : APT::Install-Suggests.
-d, --download-only
Recuperation seule ; les paquets sont recuperes mais ne sont ni
depaquetes ni installes. Element de configuration :
APT::Get::Download-Only.
-f, --fix-broken
Correction ; cette option demande de reparer un systeme ou existent
des dependances defectueuses. Utilisee avec install ou remove, elle
peut exclure un paquet pour permettre de deduire une solution
viable. Tout paquet specifie doit completement corriger le
probleme. Cette option est quelquefois necessaire lorsque l'on
execute APT pour la premiere fois ; APT interdit les dependances
defectueuses dans un systeme. Il est possible que la structure de
dependances d'un systeme soit tellement corrompue qu'elle requiert
une intervention manuelle (ce qui veut dire la plupart du temps
utiliser dselect(1) ou dpkg --remove pour eliminer les paquets en
cause). L'utilisation de cette option conjointement avec -m peut
produire une erreur dans certaines situations. Element de
configuration : APT::Get::Fix-Broken.
-m, --ignore-missing, --fix-missing
Ignorer les paquets manquants ; si des paquets ne peuvent etre
recuperes, ou, apres recuperation, ne satisfont pas au controle
d'integrite, cette commande met ces paquets de cote et gere le
resultat. Utiliser cette option conjointement avec -f peut produire
une erreur dans certaines situations. Quand un paquet, selectionne
pour une installation (particulierement si c'est mentionne en ligne
de commande), ne peut etre recupere, il est mis silencieusement de
cote. Element de configuration : APT::Get::Fix-Missing.
--no-download
Pas de recuperation. Le mieux est d'utiliser cette option avec
--ignore-missing pour forcer APT a n'utiliser que les .deb qu'il a
deja recuperes. Element de configuration : APT::Get::Download.
-q, --quiet
Mode silencieux ; cette commande produit une sortie destinee a
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 egal a 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
executer des actions inattendues. Element de configuration : quiet.
-s, --simulate, --just-print, --dry-run, --recon, --no-act
Pas d'action ; simule les evenements qui devraient se produire sans
effectuer de changement reel sur le systeme. Element de
configuration : APT::Get::Simulate.
Lorsque la simulation est effectuee par un utilisateur sans
privilege, le verrouillage (Debug::NoLocking) sera desactive
automatiquement. Une mention explicite indiquant qu'il s'agit d'une
simple simulation sera affichee si l'option
APT::Get::Show-User-Simulation-Note est activee (elle est active
par defaut). Ni la desactivation du verrou ni l'affichage de la
mention de simulation ne seront declenchees si la commande est
lancee par l'utilisateur root (pour qui il n'est pas juge utile
qu'apt-get envoie de telles notifications).
La simulation affiche une serie de lignes representant chacune une
operation de dpkg, Configure (Conf), Remove (Remv), Unpack (Inst).
Des crochets encadrent des paquets endommages et des crochets
n'encadrant rien indiquent que les dommages n'ont aucune
consequence (rare).
-y, --yes, --assume-yes
Repondre automatiquement oui aux questions ; presume << oui >>
comme reponse a toutes les questions et s'execute de maniere non
interactive. Dans le cas d'une situation indesirable, comme le
changement d'un paquet gele, l'installation d'un paquet non
authentifie ou la suppression d'un paquet essentiel, apt-get
s'interrompt. Element de configuration : APT::Get::Assume-Yes.
--assume-no
Automatic "no" to all prompts. Configuration Item:
APT::Get::Assume-No.
-u, --show-upgraded
Afficher les paquets mis a niveau ; affiche une liste de tous les
paquets a mettre a niveau. Element de configuration :
APT::Get::Show-Upgraded.
-V, --verbose-versions
Afficher les versions completes des paquets installes ou mis a
niveau. Element de configuration : APT::Get::Show-Versions.
-a, --host-architecture
This option controls the architecture packages are built for by
apt-get source --compile and how cross-builddependencies are
satisfied. By default is not set which means that the host
architecture is the same as the build architecture (which is
defined by APT::Architecture) Configuration Item:
APT::Get::Host-Architecture
-b, --compile, --build
Cette commande compile un paquet source apres l'avoir recupere.
Element de configuration : APT::Get::Compile.
--ignore-hold
Cette commande ignore la marque << Hold >> (<< garder >>) d'un
paquet ; par ce biais, apt-get ignore un << hold >> place sur un
paquet. cela peut etre utile avec dist-upgrade pour annuler un
grand nombre de << hold >> indesirables. Element de configuration :
APT::Ignore-Hold.
--no-upgrade
Aucune mise a niveau ; quand elle est utilisee avec install, cette
commande empeche les paquets mentionnes sur la ligne de commande
d'etre mis a niveau. Element de configuration : APT::Get::Upgrade.
--only-upgrade
N'install aucun nouveau paquet ; quand elle est utilisee avec
install, only-upgrade empeche les paquets mentionnes sur la ligne
de commande d'etre mis a niveau s'ils ne sont pas deja installes.
Element de configuration : 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 realise
quelque chose de potentiellement dommageable. Cette option ne doit
etre utilisee que dans des circonstances tres speciales. Utiliser
force-yes peut detruire le systeme... Element de configuration :
APT::Get::force-yes.
--print-uris
Au lieu de recuperer les paquets a installer, leurs URI sont
affichees. Chaque URI a un chemin, un nom de fichier destination,
une taille et une cle md5 attendue. Veuillez noter que le nom de
fichier a 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 donnees et c'est a l'utilisateur
de decompresser les fichiers compresses. Element de configuration :
APT::Get::Print-URIs.
--purge
Utiliser << purge >> a la place de << remove >> pour supprimer tout
ce qui peut etre supprime. Un asterisque (*) sera accole aux noms
des paquets qui vont etre purges. remove --purge est equivalent a
la commande purge. Element de configuration : APT::Get::Purge.
--reinstall
Reinstaller les paquets deja installes avec leur version la plus
recente. Element de configuration : APT::Get::ReInstall.
--list-cleanup
Cette option est activee par defaut ; utilisez --no-list-cleanup
pour la desactiver. Quand elle est activee, apt-get gere
automatiquement le contenu de /var/lib/apt/lists afin d'assurer que
les fichiers obsoletes soient effaces. La seule raison de la
desactiver est une modification frequente de la liste de sources.
Element de configuration : APT::Get::List-Cleanup.
-t, --target-release, --default-release
Cette option controle l'entree par defaut pour les questions de
distribution ; une etiquette (pin) par defaut dont la priorite vaut
990 est creee en utilisant la chaine specifiee. Le fichier des
preferences peut annuler cette decision. En clair, cette option
permet de controler simplement dans quelle distribution seront
recuperes les paquets. Par exemple : -t '2.1*', -t unstable ou -t
sid. Element de configuration : APT::Default-Release. Voyez aussi
la page de manuel d'apt_preferences(5).
--trivial-only
Ne realise que les operations << triviales >>. Logiquement ceci
peut etre considere comme relatif a --assume-yes. Alors que
--assume-yes repond oui a n'importe quelle question, --trivial-only
repond non. Element de configuration : APT::Get::Trivial-Only.
--no-remove
Arreter immediatement apt-get, sans poser de questions, si des
paquets doivent etre supprimes. Element de configuration :
APT::Get::Remove.
--auto-remove
Si la commande utilisee est soit install soit remove, cette option
a le meme effet qu'autoremove et supprime les paquets de dependance
inutilises. Element 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 donnes ne doivent pas etre
reperes a 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 a partir des noms de paquets binaires
correspondants. Element de configuration : APT::Get::Only-Source
--diff-only, --dsc-only, --tar-only
Ne telecharger que le fichier .diff, .dsc ou .tar d'une archive
source. Element de configuration : APT::Get::Diff-Only,
APT::Get::Dsc-Only et APT::Get::Tar-Only,
--arch-only
Ne traiter que les dependances de construction dependantes de
l'architecture. Element de configuration : APT::Get::Arch-Only.
--allow-unauthenticated
Ignorer le fait que les paquets ne peuvent pas etre authentifies ;
ne le signale pas a l'utilisateur. Cette option est tres utile pour
certains outils comme pbuilder. Element de configuration :
APT::Get::AllowUnauthenticated.
-h, --help
Afficher un bref resume de l'utilisation.
-v, --version
Afficher la version du programme.
-c, --config-file
Fichier de configuration ; indique le fichier de configuration a
utiliser. Le programme lira le fichier de configuration par defaut
puis le fichier indique ici. Si les reglages de configuration
doivent etre etablis avant l'analyse des fichiers de configuration
par defaut, un fichier peut etre indique avec la variable
d'environnement APT_CONFIG. Veuillez consulter apt.conf(5) pour des
informations sur la syntaxe d'utilisation.
-o, --option
Definir une option de configuration ; permet de regler une option
de configuration donnee. La syntaxe est -o Foo::Bar=bar. -o et
--option peuvent etre utilisees plusieurs fois pour definir des
options differentes.
FICHIERS
/etc/apt/sources.list
Emplacement pour la recuperation des paquets. Element de
configuration : Dir::Etc::SourceList.
/etc/apt/sources.list.d/
Fragments de fichiers definissant les emplacements de recuperation
de paquets. Element de configuration : Dir::Etc::SourceParts.
/etc/apt/apt.conf
Fichier de configuration d'APT. Element de configuration :
Dir::Etc::Main.
/etc/apt/apt.conf.d/
Fragments du fichier de configuration d'APT. Element de
configuration : Dir::Etc::Parts.
/etc/apt/preferences
Fichier des preferences. C'est dans ce fichier qu'on peut faire de
l'etiquetage (pinning) c'est-a-dire, choisir d'obtenir des paquets
d'une source distincte ou d'une distribution differente. Element de
configuration : Dir::Etc::Preferences.
/etc/apt/preferences.d/
Fragments de fichiers pour la preference des versions. Element de
configuration : Dir::Etc::PreferencesParts.
/var/cache/apt/archives/
Zone de stockage des fichiers recuperes. Element de configuration :
Dir::Cache::Archives.
/var/cache/apt/archives/partial/
Zone de stockage pour les paquets en transit. Element de
configuration : Dir::Cache::Archives (implicitement, partial).
/var/lib/apt/lists/
Zone de stockage pour les informations qui concernent chaque
ressource de paquet specifiee dans sources.list(5) Element de
configuration : Dir::State::Lists.
/var/lib/apt/lists/partial/
Zone de stockage pour les informations en transit. Element 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 zero apres une operation normale, le decimal 100 en cas
d'erreur.
AUTEURS D'ORIGINE
Jason Gunthorpe
AUTEURS ACTUELS
Equipe de developpement d'APT
Page qualit'e[3]
BOGUES
Page des bogues d'APT[4]. Si vous souhaitez signaler un bogue a propos
d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou
utiliser la commande reportbug(1).
TRADUCTEURS
Jerome Marant, Philippe Batailler, Christian Perrier bubulle@debian.org
(2000, 2005, 2009, 2010), Equipe 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 eviter de perdre du contenu quand
la traduction est legerement en retard sur le contenu d'origine.
AUTHORS
Jason Gunthorpe
'Equipe de d'eveloppement d'APT
NOTES
1. http://packages.debian.org/changelogs
2. http://changelogs.ubuntu.com/changelogs
3. Page qualite
http://packages.qa.debian.org/a/apt.html
4. Page des bogues d'APT
http://bugs.debian.org/src:apt