Provided by: apt_0.7.9ubuntu17_i386 bug

NOM

       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 gérés
           indépendamment des 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 dAPT[1]. 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
           Auteur.

       APT team
           Auteur.

NOTES

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