Ubuntu Manpage: apt-get - Utilitaire d’APT pour la manipulation de paquets -- interface

Provided by: apt_0.6.43.3ubuntu2_i386

NAME

       apt-get - Utilitaire d’APT pour la manipulation de paquets -- interface
       en ligne de commande.

SYNOPSIS

       apt-get [-hvs] [-o=option de configuration] [-c=fichier] {update |
               upgrade | dselect-upgrade | install paquet... |
               remove paquet... | source paquet... | build-dep paquet... |
               check | clean | autoclean}

DESCRIPTION

        Apt-get  est  l’outil en ligne de commande pour manipuler les paquets.
       Il peut être considéré par l’utilisateur comme un générateur de  sortie
       pour  les  autres  outils  de la bibliothèque APT. Plusieurs interfaces
       utilisateur existent, comme dselect, aptitude, synaptic,  gnome-apt  ou
       wajig.

       À  moins que l’option -h, ou --help ne soit donnée, l’une des commandes
       suivantes doit être présente.

       update La  commande  update  permet  de   resynchroniser   un   fichier
              répertoriant  les paquets disponibles et sa source. Ces fichiers
              sont     récupérés     aux     endroits      spécifiés      dans
              /etc/apt/sources.list.  Ainsi,  lorsqu’on  utilise  une  archive
              Debian, cette commande récupère les fichiers Packages.gz et  les
              analyse   de  manière  à  rendre  disponibles  les  informations
              concernant les nouveaux paquets et les paquets mis  à  jour.  On
              doit  toujours  exécuter une commande update avant les commandes
              upgrade ou dist-upgrade. Il  faut  savoir  que  l’indicateur  de
              progression  d’ensemble  n’est  pas correct puisque la taille de
              ces fichiers ne peut être connue à l’avance.

       upgrade
              La commande upgrade permet d’installer  les  versions  les  plus
              récentes  de  tous  les  paquets  présents  sur  le  système  en
              utilisant les sources énumérées dans /etc/apt/sources.list.  Les
              paquets  installés  dont  il  existe  de nouvelles versions sont
              récupérés et mis  à  niveau.  En  aucun  cas  des  paquets  déjà
              installés  ne  sont supprimés ; de même, des paquets qui ne sont
              pas déjà installés  ne  sont  ni  récupérés  ni  installés.  Les
              paquets   dont   de  nouvelles  versions  ne  peuvent  pas  être
              installées sans changer  le  statut  d’installation  d’un  autre
              paquet  sont laissés dans leur version courante. On doit d’abord
              exécuter  la  commande  update  pour   que   apt-get   connaisse
              l’existence de nouvelles versions des paquets.

       dselect-upgrade
               dselect-upgrade  est  utilisée  conjointement  avec dselect(8),
              l’interface traditionnelle Debian pour la gestion  des  paquets.
              La  commande  dselect-upgrade  suit les modifications faites par
              dselect(8) dans le champ  Status  des  paquets  disponibles,  et
              effectue  les  actions  nécessaires à la réalisation 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 dépendances
              dans  les  nouvelles  versions  des paquets ; apt-get possède un
              système « intelligent » de résolution des conflits et il essaye,
              quand  c’est nécessaire, de mettre à niveau les paquets les plus
              importants aux dépens  des  paquets  les  moins  importants.  Le
              fichier  /etc/apt/sources.list  contient une liste de sources où
              récupérer les paquets désirés.  Voyez  aussi  apt_preferences(5)
              pour  un  mécanisme de remplacement des paramètres généraux 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 de fichier entièrement défini (par exemple, dans un  système
              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 récupérés et installés. On se
              sert du fichier /etc/apt/sources.list pour localiser les paquets
              désirés.   Quand  un  trait  d’union  est  accolé  (sans  espace
              intermédiaire) au nom d’un paquet déjà installé, ce  paquet  est
              supprimé.  De  même on peut ajouter un signe « + » pour désigner
              un paquet à installer. Cette dernière fonctionnalité  peut  être
              utilisée  pour  annuler  les  décisions prises par le système de
              résolution des conflits d’apt-get.

              On peut choisir d’installer une version particulière d’un paquet
              en  faisant  suivre son nom par un signe égal et par la version.
              Cette version sera localisée et l’installation sera demandée. On
              peut  aussi  choisir  une  distribution  particulière 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  possibilités  de  choisir  la  version,  de  vieilles
              versions d’un paquet peuvent  être  installées.  Il  faut  faire
              attention.

              Enfin,   le   mécanisme  d’apt_preferences(5)  permet  de  créer
              d’autres règles pour l’installation des paquets.

              Quand aucun  paquet  ne  correspond  à  l’expression  donnée  en
              argument  et  que  cette expression contient l’un des caractères
              « . », « ? » ou « * », on considère  que  c’est  une  expression
              rationnelle POSIX et elle est appliquée à tous les paquets de la
              base de données. Tout  paquet  correspondant  est  installé  (ou
              supprimé).   Notez   que   la   comparaison  est  effectuée  par
              sous-chaîne et « lo » correspond aussi bien à «  how-lo  »  qu’à
              « lowest ». Si vous ne le voulez pas, ancrez l’expression par un
              caractère « ^ » ou un  caractère  «  $  »,  ou  bien  créez  une
              expression plus précise.

       remove La  commande  remove  est identique à la commande install ; Mais
              les paquets sont supprimés et non pas installés. Quand un  signe
              plus est accolé (sans espace intermédiaire) au nom du paquet, le
              paquet est installé au lieu d’être supprimé.

       source Avec la commande source, apt-get récupère des  paquets  sources.
              APT  examine  les  paquets  disponibles  pour  choisir le paquet
              source à récupérer. Il trouve  ensuite  et  télécharge  dans  le
              répertoire  courant  la  version  la  plus  récente. Les paquets
              source sont suivis différemment que les  paquets  binaires,  via
              les lignes de type deb-src dans le fichier sources.list(5)  . On
              n’obtiendra probablement pas les mêmes  sources  que  celles  du
              paquet installé ou celles du paquet qu’on pourrait installer. Si
              l’option --compile est spécifiée, le paquet est  compilé  en  un
              binaire  .deb  avec  dpkg-buildpackage.  Si  --download-only est
              spécifié, le source n’est pas décompacté.

              De la même façon qu’avec les paquets binaires, on peut récupérer
              une  version  particulière  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 ;
              cela lance implicitement la commande APT::Get::Only-Source.

              Notez que les paquets sources ne sont pas suivis comme  le  sont
              les   paquets  binaires.  Ils  ne  sont  présents  que  dans  le
              répertoire courant et sont semblables à des sources  téléchargés
              sous forme de tarball.

       build-dep
              Avec  la  commande  build-dep,  apt-get installe ou supprime des
              paquets  dans  le  but  de   satisfaire   les   dépendances   de
              construction  d’un  paquet  source.  Pour l’instant, dans la cas
              d’un paquet virtuel, un paquet est choisi au hasard.

       check  La commande check est un outil de diagnostic ; il met à jour  le
              cache des paquets et cherche des dépendances défectueuses.

       clean  La  commande  clean  nettoie  le  référentiel  local des paquets
              récupérés. Il supprime tout, excepté le fichier lock situé  dans
              /var/cache/apt/archives/   et  /var/cache/apt/archives/partial/.
              Quand APT est  utilisé  comme  mode  de  dselect(8),  clean  est
              effectué  automatiquement.  Quand  on  n’utilise pas dselect, il
              faut exécuter apt-get clean de  temps  en  temps  si  l’on  veut
              libérer de l’espace disque.

       autoclean
              Tout  comme  clean,  autoclean  nettoie le référentiel local des
              paquets récupérés. La différence est qu’il  supprime  uniquement
              les  paquets  qui  ne  peuvent plus être téléchargés et qui sont
              grandement inutiles. On peut ainsi contrôler  la  taille  de  ce
              cache  sur  une  longue période. Tant qu’elle n’est pas activée,
              l’option  de  configuration  APT::Clean-Installed   empêche   la
              suppression de paquets installés.

OPTIONS

Toutes les options en ligne de commande peuvent être positionnées via
le fichier de configuration ; les descriptifs indiquent l’option de
configuration à positionner. En ce qui concerne les options booléennes,
on peut annuler le fichier de configuration en utilisant quelque chose
comme -f-,--no-f, -f=no ou d’autres variantes.

-d, --download-only
Récupération seule ; les paquets sont récupérés mais ne sont ni
dépaquetés ni installés. Élément de configuration :
APT::Get::Download-Only.

-f, --fix-broken
Correction ; essaye de réparer un système dont les dépendances
sont défectueuses. Cette option, utilisée avec install ou
remove, peut omettre tout paquet de façon à permettre à APT de
déduire une solution viable. Chaque paquet spécifié doit
complètement corriger le problème. Cette option est quelquefois
nécessaire lorsque l’on exécute APT pour la première fois ; APT
lui-même interdit les dépendances défectueuses dans un système.
Il est possible que la structure de dépendances d’un système
soit tellement corrompue qu’elle requiert une intervention
manuelle (ce qui veut dire la plupart du temps utiliser
dselect(8) ou dpkg --remove pour éliminer les paquets en cause).
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 des paquets ne peuvent être
récupérés, ou, après récupération, ne satisfont pas au contrôle
d’intégrité, cette commande met ces paquets de côté et gère le
résultat. Utiliser cette option conjointement avec -f peut
produire une erreur dans certaines situations. Quand un paquet,
sélectionné pour une installation (particulièrement si c’est
mentionné en ligne de commande), ne peut être récupéré, il est
mis silencieusement de côté. Élément de configuration :
APT::Get::Fix-Missing.

--no-download
Pas de récupération. Le mieux est d’utiliser cette option avec
--ignore-missing pour forcer APT à n’utiliser que les .deb qu’il
a déjà récupérés. Élément de configuration : APT::Get::Download.

-q, --quiet
Mode silencieux ; cette commande produit une sortie destinée à
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
exécuter des actions inattendues ! Élément de configuration :
quiet.

-s, --simulate, --just-print, --dry-run, --recon, --no-act
Simulation ; cette commande réalise une simulation des actions
qui seraient exécutées mais ne modifie pas le système. Élément
de configuration : APT::Get::Simulate.

La simulation affiche une série de lignes représentant chacune
une opération de dpkg, Configure (Conf),Remove (Remv),Unpack
(Inst). Les crochets encadrent des paquets endommagés et des
crochets n’encadrant rien indiquent que les dommages n’ont
aucune conséquence (rare).

-y, --yes, --assume-yes
Répond automatiquement oui aux questions ; présume « oui » comme
réponse à toutes les questions et s’exécute de manière non
interactive. Dans le cas d’une situation indésirable, 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. Élément de configuration : APT::Get::Assume-Yes.

-u, --show-upgraded
Afficher les paquets mis à niveau ; affiche une liste de tous
les paquets à mettre à niveau. Élément de configuration :
APT::Get::Show-Upgraded.

-V, --verbose-versions
Afficher les versions complètes des paquets installés ou mis à
niveau. Élément de configuration : APT::Get::Show-Versions.

-b, --compile, --build
Cette commande compile un paquet source après l’avoir récupéré.
Élément de configuration : APT::Get::Compile.

--ignore-hold
Cette commande ignore la marque « Hold » 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 » indésirables. Élément de configuration :
APT::Ignore-Hold.

--no-upgrade
Aucune mise à niveau ; quand elle est utilisée avec install,
cette commande empêche les paquets listés sur la ligne de
commande d’être mis à niveau. Élément de configuration :
APT::Get::Upgrade.

--force-yes
Forcer l’acceptation ; cette option est dangereuse parce qu’elle
laisse APT continuer sans poser de questions quand il réalise
quelque chose de potentiellement dommageable. Cette option ne
doit être utilisée que dans des circonstances très spéciales.
Utiliser force-yes peut détruire le système ! Élément de
configuration : APT::Get::force-yes.

--print-uris
Au lieu d’aller chercher les paquets à installer, leurs URI sont
affichées. Chaque URI a un chemin, un nom de fichier
destination, une taille et une clé md5 attendue. Notez 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 données et c’est à
l’utilisateur de décompresser les fichiers compressés. Élément
de configuration : APT::Get::Print-URIs.

--purge
Utiliser purge à la place de remove pour supprimer tout ce qui
peut être supprimé. Un astérisque (*) sera affiché près des
paquets qui vont être purgés. Élément de configuration :
APT::Get::Purge.

--reinstall
Réinstaller les paquets déjà installés avec leur version 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. Quand elle est activée, apt-get gère
automatiquement le contenu de /var/lib/apt/lists afin d’assurer
que les fichiers obsolètes soient effacés. La seule raison de la
désactiver est une modification fréquente de 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 pour les questions de
distribution ; une étiquette (pin) par défaut dont la priorité
vaut 990 est créé en utilisant la chaîne spécifiée. Le fichier
des préférences peut annuler cette décision. En clair, cette
option permet de contrôler simplement dans quelle distribution
seront récupérés les paquets. Par exemple : -t �’2.1*�’ ou -t
unstable. Élément de configuration : APT::Default-Release. Voyez
aussi la page de manuel d’apt_preferences(5).

--trivial-only
Ne réalise que les opérations « triviales ». Logiquement ceci
peut être considéré comme relatif à --assume-yes. Alors que
--assume-yes répond oui à n’importe quelle question,
--trivial-only répond non. Élément de configuration :
APT::Get::Trivial-Only.

--no-remove
Quand des paquets doivent être supprimés, apt-get s’arrête
immédiatement sans poser de questions. Élément de
configuration : APT::Get::Remove.

--only-source
Cette option n’a de sens qu’avec les commandes source et
build-dep. Elle indique que les noms de sources donnés ne
doivent pas être repérés à 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. Élément de configuration :
APT::Get::Only-Source

--diff-only, --tar-only
Ne récupérer que le fichier diff ou tar d’une archive de source.
Élément de configuration : APT::Get::Diff-Only et
APT::Get::Tar-Only.

--arch-only
Ne traiter que les dépendances de construction pour telle
architecture. Élément de configuration : APT::Get::Arch-Only

--allow-unauthenticated
Ignorer le fait que les paquets ne peuvent pas être authentifiés
; pas d’interrogation de l’utilisateur. C’est très utile pour
certains outils comme pbuilder Élément de configuration :
APT::Get::AllowUnauthenticated.

-h, --help
Affiche un mode d’emploi succinct.

-v, --version
Affiche la version du programme.

-c, --config-file
Fichier de configuration ; indique quel fichier de configuration
utiliser. Le programme lit le fichier de configuration par
défaut, puis celui-ci. Voyez apt.conf(5) pour la syntaxe.

-o, --option
Donne une option de configuration ; cela fixe une option de
configuration arbitraire. La syntaxe est : -o Foo::Bar=bar.

FICHIERS

       /etc/apt/sources.list
              Liste les emplacements où aller chercher 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/
              Éléments   du   fichier   de  configuration  d’APT.  Élément  de
              configuration : Dir::Etc::Parts.

       /etc/apt/preferences
              Fichier des préférences. 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 différente.
              Élément de configuration : Dir::Etc::Preferences.

       /var/cache/apt/archives/
              Zone   de  stockage  pour  les  paquets  récupérés.  Élément  de
              configuration : Dir::Cache::Archives.

       /var/cache/apt/archives/partial/
              Zone de  stockage  pour  les  paquets  en  transit.  Élément  de
              configuration : Dir::Cache::Archives (implicitement, partial).

       /var/lib/apt/lists/
              Zone  de  stockage  des informations concernant chaque ressource
              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 des paquets en
              transit. Élément de configuration : Dir::State::Lists  (implicit
              partial).

VOIR AUSSI

        apt-cache(8),  apt-cdrom(8),  dpkg(8),  dselect(8), sources.list(5)  ,
       apt.conf(5),  apt-config(8),  le  guide  «  APT  users  guide  »   dans
       /usr/share/doc/apt/, apt_preferences(5), le guide APT.

DIAGNOSTIC

       apt-get renvoie zéro après une opération normale, le décimal 100 en cas
       d’erreur.

BOGUES

       Voyez     la      page      concernant      les      bogues      d’APT:
       http://bugs.debian.org/src:apt.  Si  vous  voulez  signaler  un  bogue,
       consultez le texte /usr/share/doc/debian/bug-reporting.txt ou  utilisez
       la commande reportbug(1).

TRADUCTION

       Jérôme  Marant.  2000  ;  mise  à  jour  :  Philippe  Batailler.  2005.
       <debian-l10n-french@lists.debian.org>.

AUTHORS

       Jason Gunthorpe, APT team.

Ubuntu manuals