<!-- -*- mode: sgml; mode: fold -*- --> <!-- translation of version 1.12 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> %aptent; ]> <refentry lang=fr> &apt-docinfo; <refmeta> <refentrytitle>apt-get</> <manvolnum>8</> </refmeta> <!-- Man page title --> <refnamediv> <refname>apt-get</> <refpurpose>Utilitaire d'APT pour la manipulation de paquets -- interface en ligne de commande.</> </refnamediv> <!-- Arguments --> <refsynopsisdiv> <cmdsynopsis> <command>apt-get</> <arg><option>-hvs</></arg> <arg><option>-o=<replaceable/option de configuration/</></arg> <arg><option>-c=<replaceable/fichier/</></arg> <group choice=req> <arg>update</> <arg>upgrade</> <arg>dselect-upgrade</> <arg>install <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>remove <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>source <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>build-dep <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>check</> <arg>clean</> <arg>autoclean</> </group> </cmdsynopsis> </refsynopsisdiv> <RefSect1><Title>Description</> <para> <command/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. <para> � moins que l'option <option/-h/, ou <option/--help/ ne soit donn�e, l'une des commandes suivantes doit �tre pr�sente. <VariableList> <VarListEntry><Term>update</Term> <ListItem><Para> La commande <literal/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 <filename>/etc/apt/sources.list</>. Ainsi, lorsqu'on utilise une archive Debian, cette commande r�cup�re les fichiers <filename>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 <literal/update/ avant les commandes <literal/upgrade/ ou <literal/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. </VarListEntry> <VarListEntry><Term>upgrade</Term> <ListItem><Para> La commande <literal/upgrade/ permet d'installer les versions les plus r�centes de tous les paquets pr�sents sur le syt�me en utilisant les sources �num�r�es dans <filename>/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 <literal/update/ pour que <command/apt-get/ connaisse l'existence de nouvelles versions des paquets. </VarListEntry> <VarListEntry><Term>dselect-upgrade</Term> <ListItem><Para> Cette commande est utilis�e conjointement avec &dselect;, l'interface traditionnelle Debian GNU/Linux pour la gestion des paquets. La commande <literal/dselect-upgrade/ suit les modifications faites par &dselect; dans le champ <literal/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). </VarListEntry> <VarListEntry><Term>dist-upgrade</Term> <ListItem><Para> La commande <literal/dist-upgrade/ effectue la fonction <literal/upgrade/ en y ajoutant une gestion intelligente des changements de d�pendances dans les nouvelles versions des paquets ; <command/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 <filename>/etc/apt/sources.list</> contient une liste de sources o� r�cup�rer les paquets d�sir�s. </VarListEntry> <VarListEntry><Term>install</Term> <ListItem><Para> La commande <literal/install/ est suivie par un ou plusieurs paquets � installer. Chaque paquet est un nom de paquet ; ce n'est pas un nom de fichier pleinement d�termin� (par exemple, dans un syst�me Debian GNU/Linux, on indiquera libc6 et non pas <filename>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 <filename>/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. <para> 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, frozen, unstable). <para> Avec ces possibilit�s de choisir la version, de vieilles versions d'un paquet peuvent �tre install�es. Il faut faire attention. <para> 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 �. Pr�fixez l'expression par un caract�re � ^ � si vous ne le voulez pas. </VarListEntry> <VarListEntry><Term>remove</Term> <ListItem><Para> La commande <literal/remove/ est identique � la commande <literal/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�. </VarListEntry> <VarListEntry><Term>source</Term> <ListItem><Para> Avec la commande <literal/source/, <command/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 <literal/deb-src/ dans le fichier &sources-list;. 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 <option>--compile</> est sp�cifi�e, le paquet est compil� en un binaire .deb avec <command>dpkg-buildpackage</>. Si <option>--download-only</> est sp�cifi�, le source n'est pas d�compact�. <para> 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 <literal/APT::Get::Only-Source/. <para> 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. </VarListEntry> <VarListEntry><Term>build-dep</Term> <ListItem><Para> Avec la commande <literal/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. </VarListEntry> <VarListEntry><Term>check</Term> <ListItem><Para> La commande <literal/check/ est un outil de diagnostic ; il met � jour le cache des paquets et cherche des d�pendances d�fectueuses. </VarListEntry> <VarListEntry><Term>clean</Term> <ListItem><Para> La commande <literal/clean/ nettoie le r�f�rentiel local des paquets r�cup�r�s. Il supprime tout, except� le fichier lock situ� dans <filename>&cachedir;/archives/</> et <filename>&cachedir;/archive/partial/</>. Quand APT est utilis� comme mode de &dselect;, <literal/clean/ est effectu� automatiquement. Quand on n'utilise pas &dselect;, il faut ex�cuter <literal/apt-get clean/ de temps en temps si l'on veut lib�rer de l'espace disque. </VarListEntry> <VarListEntry><Term>autoclean</Term> <ListItem><Para> Tout comme <literal/clean/, <literal/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 <literal/APT::Clean-Installed/ emp�che la suppression de paquets install�s. </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>Options</> &apt-cmdblurb; <VariableList> <VarListEntry><term><option/-d/</><term><option/--download-only/</> <ListItem><Para> R�cup�ration seule ; les paquets sont ramen�s mais ne sont ni d�paquet�s ni install�s. �l�ment de configuration : <literal/APT::Get::Download-Only/. </VarListEntry> <VarListEntry><term><option/-f/</><term><option/--fix-broken/</> <ListItem><Para> 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; ou <command/dpkg --remove/ pour �liminer les paquets en cause). L'utilisation de cette option conjointement avec <option>-m</> peut produire une erreur dans certaines situations. �l�ment de configuration : <literal/APT::Get::Fix-Broken/. </VarListEntry> <VarListEntry><term><option/-m/</><term><option/--ignore-missing/</> <term><option/--fix-missing/</> <ListItem><Para> 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 <option>-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 : <literal/APT::Get::Fix-Missing/. </VarListEntry> <VarListEntry><term><option/--no-download/</> <ListItem><Para> Pas de r�cup�ration. Le mieux est d'utiliser cette option avec <option/--ignore-missing/ pour forcer APT � n'utiliser que les .deb qu'il a d�j� r�cup�r�s. �l�ment de configuration : <literal/APT::Get::Download/. </VarListEntry> <VarListEntry><term><option/-q/</><term><option/--quiet/</> <ListItem><Para> 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 <option/-q=#/ pour positionner le niveau de silence, et annuler le fichier de configuration. Notez qu'un niveau de silence �gal � 2 implique <option>-y</> et vous ne devez jamais utiliser <option>-qq</> sans l'accompagner d'un modificateur tel que <option>-d</>, <option>--print-uris</> ou <option>-s</> : APT pourrait ex�cuter des actions inattendues ! �l�ment de configuration : <literal/quiet/. </VarListEntry> <VarListEntry><term><option/-s/</> <term><option/--simulate/</> <term><option/--just-print/</> <term><option/--dry-run/</> <term><option/--recon/</> <term><option/--no-act/</> <ListItem><Para> 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 : <literal/APT::Get::Simulate/. <para> 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). </VarListEntry> <VarListEntry><term><option/-y/</><term><option/--yes/</> <term><option/--assume-yes/</> <ListItem><Para> 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� ou la suppression d'un paquet essentiel, <literal/apt-get/ s'interrompt. �l�ment de configuration : <literal/APT::Get::Assume-Yes/. </VarListEntry> <VarListEntry><term><option/-u/</><term><option/--show-upgraded/</> <ListItem><Para> Afficher les paquets mis � niveau ; affiche une liste de tous les paquets � mettre � niveau. �l�ment de configuration : <literal/APT::Get::Show-Upgraded/. </VarListEntry> <VarListEntry><term><option/-b/</><term><option/--compile/</> <term><option/--build/</> <ListItem><Para> Cette commande compile un paquet source apr�s l'avoir r�cup�r�. �l�ment de configuration : <literal/APT::Get::Compile/. </VarListEntry> <VarListEntry><term><option/--ignore-hold/</> <ListItem><Para> Cette commande ignore la marque � Hold � d'un paquet ; par ce biais, <command/apt-get/ ignore un � hold � plac� sur un paquet. cela peut �tre utile avec <literal/dist-upgrade/ pour annuler un grand nombre de � hold � ind�sirables. �l�ment de configuration : <literal/APT::Ignore-Hold/. </VarListEntry> <VarListEntry><term><option/--no-upgrade/</> <ListItem><Para> Aucune mise � niveau ; quand elle est utilis�e avec <literal/install/, cette commande emp�che les paquets list�s et d�ja install�s d'�tre mis � niveau. �l�ment de configuration : <literal/APT::Get::Upgrade/. </VarListEntry> <VarListEntry><term><option/--force-yes/</> <ListItem><Para> 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 <literal/force-yes/ peut d�truire le syst�me ! �l�ment de configuration : <literal/APT::Get::force-yes/. </VarListEntry> <VarListEntry><term><option/--print-uris/</> <ListItem><Para> 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 marche aussi avec la commande <literal/source/. �l�ment de configuration : <literal/APT::Get::Print-URIs/. </VarListEntry> <VarListEntry><term><option/--purge/</> <ListItem><Para> Utiliser purge � la place de remove pour supprimer tout ce qui peut �tre supprim�. �l�ment de configuration : <literal/APT::Get::Purge/. </VarListEntry> <VarListEntry><term><option/--reinstall/</> <ListItem><Para> R�installer les paquets d�j� install�s avec leur version la plus r�cente. �l�ment de configuration : <literal/APT::Get::ReInstall/. </VarListEntry> <VarListEntry><term><option/--list-cleanup/</> <ListItem><Para> Cette option est activ�e par d�faut ; utilisez <literal/--no-list-cleanup/ pour la d�sactiver. Quand elle est activ�e, <command/apt-get/ g�re automatiquement le contenu de <filename>&statedir;/lists</> afin d'assurer que les fichiers obsol�tes sont effac�s. La seule raison de la d�sactiver est une modification fr�quente de votre liste de sources. �l�ment de configuration : <literal/APT::Get::List-Cleanup/. </VarListEntry> <VarListEntry><term><option/-t/</> <term><option/--target-release/</> <term><option/--default-release/</> <ListItem><Para> 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�e 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 : <option>-t '2.1*'</> ou <option>-t unstable</>. �l�ment de configuration : <literal/APT::Default-Release/. </VarListEntry> <VarListEntry><term><option/--trivial-only/</> <ListItem><Para> Ne r�alise que les op�rations � triviales �. Logiquement ceci peut �tre consid�r� comme relatif � <option>--assume-yes</>. Alors que <option>--assume-yes</> r�pond oui � n'importe quelle question, <option>--trivial-only</> r�pond non. �l�ment de configuration : <literal/APT::Get::Trivial-Only/. </VarListEntry> <VarListEntry><term><option/--no-remove/</> <ListItem><Para> Quand des paquets doivent �tre supprim�s, apt-get s'arr�te imm�diatement sans poser de questions. �l�ment de configuration : <literal/APT::Get::Remove/. </VarListEntry> <VarListEntry><term><option/--only-source/</> <ListItem><Para> Cette option n'a de sens qu'avec la commande <literal/source/. Elle indique que les noms de sources donn�s ne doivent pas �tre rep�r�s � travers la table binaire. �l�ment de configuration : <literal/APT::Get::Only-Source/ </VarListEntry> <VarListEntry><term><option/--diff-only/</><term><option/--tar-only/</> <ListItem><Para> Ne r�cup�rer que le fichier diff ou tar d'une archive de source. �l�ment de configuration : <literal/APT::Get::Diff-Only/ et <literal/APT::Get::Tar-Only/. </VarListEntry> <VarListEntry><term><option/--arch-only/</> <ListItem><Para> Ne traiter que les d�pendances de construction pour telle architecture. �l�ment de configuration : <literal/APT::Get::Arch-Only/ </VarListEntry> &apt-commonoptions; </VariableList> </RefSect1> <RefSect1><Title>Fichiers</> <variablelist> <VarListEntry><term><filename>/etc/apt/sources.list</></term> <ListItem><Para> Liste les emplacements o� aller chercher les paquets. �l�ment de configuration : <literal/Dir::Etc::SourceList/. </VarListEntry> <VarListEntry><term><filename>/etc/apt/apt.conf</></term> <ListItem><Para> Fichier de configuration d'APT. �l�ment de configuration : <literal/Dir::Etc::Main/. </VarListEntry> <VarListEntry><term><filename>/etc/apt/apt.conf.d/</></term> <ListItem><Para> �l�ments du fichier de configuration d'APT. �l�ment de configuration : <literal/Dir::Etc::Parts/. </VarListEntry> <VarListEntry><term><filename>/etc/apt/preferences</></term> <ListItem><Para> Fichier des pr�f�rences. �l�ment de configuration : <literal/Dir::Etc::Preferences/. </VarListEntry> <VarListEntry><term><filename>&cachedir;/archives/</></term> <ListItem><Para> Zone de stockage pour les paquets r�cup�r�s. �l�ment de configuration : <literal/Dir::Cache::Archives/. </VarListEntry> <VarListEntry><term><filename>&cachedir;/archives/partial/</></term> <ListItem><Para> Zone de stockage pour les paquets en transit. �l�ment de configuration : <literal/Dir::Cache::Archives/ (implicitement, partial). </VarListEntry> <VarListEntry><term><filename>&statedir;/lists/</></term> <ListItem><Para> Zone de stockage des informations concernant chaque ressource sp�cifi�e dans &sources-list;. �l�ment de configuration : <literal/Dir::State::Lists/. </VarListEntry> <VarListEntry><term><filename>&statedir;/lists/partial/</></term> <ListItem><Para> Zone de stockage pour les informations d'�tat des paquets en transit. �l�ment de configuration : <literal/Dir::State::Lists/ (implicit partial). </VarListEntry> </variablelist> </RefSect1> <RefSect1><Title>Voir aussi</> <para> &apt-cache;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, Le guide � APT users guide � dans &docdir;, &apt-preferences;. </RefSect1> <RefSect1><Title>Diagnostics</> <para> <command/apt-get/ retourne z�ro apr�s un d�roulement normal, et le nombre d�cimal 100 en cas d'erreur. </RefSect1> &manbugs; &manauthor; &deux-traducteurs; </refentry>