Provided by: apt_0.6.43.3ubuntu2_i386 bug

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 : -t2.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.