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 considr par l'utilisateur comme un gnrateur de sortie pour les
       autres outils de la bibliothque APT. Plusieurs interfaces utilisateur
       existent, comme dselect, aptitude, synaptic, gnome-apt ou wajig.

        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 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. 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 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(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 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
          les paquets requis par le(s) paquet(s) que l'on veut installer sont
          aussi rcuprs et installs. On se sert du fichier
          /etc/apt/sources.list pour localiser 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 localise 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. Il faut faire attention.

          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 argument et
          que cette expression contient l'un des caractres  . ,  ?  ou  * , on
          considre que c'est une expression rationnelle POSIX et elle est
          applique  tous les paquets de la base de donnes. Tout paquet
          correspondant est install (ou supprim). Notez que la comparaison est
          effectue par sous-chane et  lo  correspond aussi bien   how-lo  qu'
           lowest . Si vous ne le voulez pas, ancrez l'expression par un
          caractre  ^  ou un caractre  $ , ou bien crez une expression plus
          prcise.

       remove
          La commande remove est identique  la commande install ; Mais les
          paquets sont supprims et non pas installs. Quand un signe plus est
          accol (sans espace intermdiaire) au nom du paquet, le paquet est
          install au lieu d'tre supprim.

       source
          Avec la commande source, apt-get rcupre des paquets sources. APT
          examine les paquets disponibles pour choisir le paquet source
          rcuprer. Il trouve ensuite et tlcharge dans le rpertoire courant la
          version la plus rcente. Les paquets source sont grs indpendamment
          des paquets binaires, via les lignes de type deb-src dans le fichier
          sources.list(5). On n'obtiendra probablement pas les mmes sources
          que celles du paquet install ou celles du paquet qu'on pourrait
          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

       check
          La commande check est un outil de diagnostic ; il met  jour le cache
          des paquets et cherche des dpendances dfectueuses.

       clean
          La commande clean nettoie le rfrentiel local des paquets rcuprs. 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 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 grandement 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.

OPTIONS

       Toutes les options en ligne de commande peuvent tre positionnes via le
       fichier de configuration ; les descriptifs indiquent l'option de
       configuration  positionner. En ce qui concerne les options boolennes,
       on peut annuler le fichier de configuration en utilisant quelque chose
       comme -f-,--no-f, -f=no ou d'autres variantes.

       -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 ; essaye de rparer un systme dont les dpendances sont
          dfectueuses. Cette option, utilise avec install ou remove, peut
          omettre tout paquet de faon  permettre  APT de dduire une solution
          viable. Chaque paquet spcifi doit compltement corriger le problme.
          Cette option est quelquefois ncessaire lorsque l'on excute APT pour
          la premire fois ; APT lui-mme 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(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. 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
          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 excuter des actions inattendues !
          lment de configuration : quiet.

       -s, --simulate, --just-print, --dry-run, --recon, --no-act
          Simulation ; cette commande ralise une simulation des actions qui
          seraient excutes mais ne modifie pas le systme. lment de
          configuration : APT::Get::Simulate.

          La simulation affiche une srie de lignes reprsentant chacune une
          opration de dpkg, Configure (Conf),Remove (Remv),Unpack (Inst). Les
          crochets encadrent des paquets endommags et des crochets n'encadrant
          rien indiquent que les dommages n'ont aucune consquence (rare).

       -y, --yes, --assume-yes
          Rpond 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.

       --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
          indsirables. lment de configuration : APT::Ignore-Hold.

       --no-upgrade
          Aucune mise  niveau ; quand elle est utilise avec install, cette
          commande empche les paquets lists sur la ligne de commande d'tre mis
          niveau. lment 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 ralise quelque
          chose de potentiellement dommageable. Cette option ne doit tre

       --purge
          Utiliser purge  la place de remove pour supprimer tout ce qui peut
          tre supprim. Un astrisque (*) sera affich prs des paquets qui vont
          tre purgs. 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 votre 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 cr 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*' ou -t unstable. 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
          Quand des paquets doivent tre supprims, apt-get s'arrte immdiatement
          sans poser de questions. lment 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 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, --tar-only
          Ne rcuprer que le fichier diff ou tar d'une archive de source. lment
          de configuration : APT::Get::Diff-Only et APT::Get::Tar-Only.

       --arch-only
          Ne traiter que les dpendances de construction pour telle

       -c, --config-file
          Fichier de configuration ; indique quel fichier de configuration
          utiliser. Le programme lit le fichier de configuration par dfaut,
          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. lment de
          configuration : Dir::Etc::SourceList.

       /etc/apt/apt.conf
          Fichier de configuration d'APT. lment de configuration :
          Dir::Etc::Main.

       /etc/apt/apt.conf.d/
          lments 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.

       /var/cache/apt/archives/
          Zone de stockage pour les paquets rcuprs. lment de configuration :
          Dir::Cache::Archives.

       /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 des informations concernant chaque ressource
          spcifie dans sources.list(5). lment de configuration :
          Dir::State::Lists.

       /var/lib/apt/lists/partial/
          Zone de stockage pour les informations d'tat des paquets en transit.
          lment 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 zro aprs une opration normale, le dcimal 100 en cas

       APT team
          Auteur.

REFERENCES

       1. page concernant les bogues d'APT
          http://bugs.debian.org/src:apt



Linux                           29 Fvrier 2004                      APT-GET(8)