diff options
author | Arch Librarian <arch@canonical.com> | 2004-09-20 16:57:42 +0000 |
---|---|---|
committer | Arch Librarian <arch@canonical.com> | 2004-09-20 16:57:42 +0000 |
commit | 135442b85cdd0ab62a4b45be588d7be5107f20bc (patch) | |
tree | f4199da4a58c9a0c8f64d543dace27fc06500ee5 /doc/fr | |
parent | 70949daf17f9e63a4f7d40dcc07bec6755025c0b (diff) |
FR man pages
Author: jgg
Date: 2001-04-27 03:29:33 GMT
FR man pages
Diffstat (limited to 'doc/fr')
-rw-r--r-- | doc/fr/apt-cache.8.fr.sgml | 377 | ||||
-rw-r--r-- | doc/fr/apt-cdrom.8.fr.sgml | 150 | ||||
-rw-r--r-- | doc/fr/apt-config.8.fr.sgml | 113 | ||||
-rw-r--r-- | doc/fr/apt-extracttemplates.1.fr.sgml | 83 | ||||
-rw-r--r-- | doc/fr/apt-ftparchive.1.fr.sgml | 517 | ||||
-rw-r--r-- | doc/fr/apt-sortpkgs.1.fr.sgml | 75 | ||||
-rw-r--r-- | doc/fr/apt.conf.5.fr.sgml | 436 | ||||
-rw-r--r-- | doc/fr/apt.ent.fr | 173 | ||||
-rw-r--r-- | doc/fr/apt_preferences.5.fr.sgml | 243 | ||||
-rw-r--r-- | doc/fr/sources.list.5.fr.sgml | 207 |
10 files changed, 2374 insertions, 0 deletions
diff --git a/doc/fr/apt-cache.8.fr.sgml b/doc/fr/apt-cache.8.fr.sgml new file mode 100644 index 000000000..6670127bb --- /dev/null +++ b/doc/fr/apt-cache.8.fr.sgml @@ -0,0 +1,377 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.4 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-cache</> + <manvolnum>8</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt-cache</> + <refpurpose>Gestion des paquets et manipulation du cache par APT</> + </refnamediv> + + <!-- Arguments --> + <refsynopsisdiv> + <cmdsynopsis> + <command>apt-cache</> + <arg><option>-hvs</></arg> + <arg><option>-o=<replaceable/option de configuration/</></arg> + <arg><option>-c=<replaceable/fichier/</></arg> + <group choice=req> + <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg> + <arg>gencaches</> + <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + <arg>stats</> + <arg>dump</> + <arg>dumpavail</> + <arg>unmet</> + <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg> + <arg>show <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + <arg>depends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg> + <arg>dotty <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <RefSect1><Title>Description</> + <para> +<command/apt-cache/ r�alise diff�rentes op�rations sur le cache de paquet d' +APT. <command/apt-cache/ ne manipule pas l'�tat du syst�me mais fournit des +moyens de recherche dans les m�tadonn�es d'un paquet desquelles il extrait +d'int�ressantes informations. + + <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>add</Term> + <ListItem><Para> +La commande <literal/add/ ajoute les fichiers donn�s en argument au cache des +paquets. + </VarListEntry> + + <VarListEntry><Term>gencaches</Term> + <ListItem><Para> +La commande <literal/gencaches/ fait la m�me chose que +<command/apt-get check/. Elle construit les caches de source et de paquet � +partir des sources r�pertori�es dans &sources-list; et dans +<filename>/var/lib/dpkg/status</>. + </VarListEntry> + + <VarListEntry><Term>showpkg</Term> + <ListItem><Para> +La commande <literal/showpkg/ affiche des informations sur les paquets donn�s +en argument. Les arguments restants sont les noms de paquets. Les versions +disponibles et les d�pendances inverses de chaque paquet r�pertori� sont +list�es, ainsi que les d�pendances normales pour chaque version. Les d�pendances +normales d'un paquet sont constitu�es par les paquets dont il d�pend ; les +d�pendances inverses sont les paquets qui d�pendent du paquet en question. +Les d�pendances normales doivent donc �tre satisfaites et les d�pendances +inverses n'ont pas besoin de l'�tre. Ainsi, la commande +<command>apt-cache showpkg libreadline2</> donnerait ce r�sultat : + +<informalexample><programlisting> +Package: libreadline2 +Versions: 2.1-12(/var/state/apt/lists/foo_Packages), +Reverse Depends: + libreadlineg2,libreadline2 + libreadline2-altdev,libreadline2 +Dependencies: +2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null)) +Provides: +2.1-12 - +Reverse Provides: +</programlisting></informalexample> + + <para> +On peut voir que libreadline2, version 2.1-8, d�pend de libc5, ncurses3.0, et +ldso ; ces paquets doivent �tre install�s au pr�alable pour que libreadline2 +fonctionne. � leur tour, libreadlineg2 et libreadline2-altdev d�pendent de +libreadline2. Si libreadline2 est install�, libc5, ncurses3.0 et ldso doivent +�tre install�s ; libreadlineg2 et libreadline2-altdev n'ont pas � l'�tre. Pour conna�tre le sens de la fin de cha�ne, il est pr�f�rable de consulter le code +source d'APT. + </VarListEntry> + + <VarListEntry><Term>stats</Term> + <ListItem><Para> +La commande <literal/stats/ affiche des statistiques � propos du cache. Aucun +autre argument n'est attendu. Voici les informations rapport�es : + <itemizedlist> + <listitem><para> +<literal/Total package names/ est le nombre de paquets trouv�s dans le cache. + </listitem> + + <listitem><para> +<literal/Normal packages/ est le nombre de paquets simples, ordinaires ; ces +paquets tol�rent une correspondance bijective entre leur nom et le nom utilis� +par d'autres paquets pour les qualifier comme d�pendance. La majorit� des +paquets appartient � cette cat�gorie. + </listitem> + + <listitem><para> +<literal/Pure virtual packages/ est le nombre des paquets qui n'existent que +sous la forme d'un nom repr�sentant un paquet virtuel ; ces paquets +� fournissent � seulement un nom de paquet virtuel et aucun paquet +n'utilise v�ritablement ce nom. Par exemple, au sein du syst�me Debian +GNU-Linux, le nom � mail-transport-agent � est un paquet virtuel pur ; +plusieurs paquets peuvent � remplir � ce nom � mail-transport-agent �, mais il +n'existe aucun paquet nomm� � mail-transport-agent �. + </listitem> + + <listitem><para> +<literal/Single virtual packages/ est le nombre de paquets virtuels qui ne +peuvent �tre remplis que par un seul paquet. Par exemple, au sein du syst�me +Debian GNU-Linux, � X11-text-viewer � est un paquet virtuel ; seul le paquet +� xless � remplit � X11-text-viewer �. + </listitem> + + <listitem><para> +<literal/Mixed virtual packages/ est le nombre des paquets qui remplissent un +paquet virtuel particulier et/ou dont le nom est un nom de paquet virtuel. +Par exemple, au sein du syst�me Debian GNU-Linux, � debconf � est +un paquet r�el et il est aussi rempli par � debconf-tiny �. + </listitem> + + <listitem><para> +<literal/Missing/ est le nombre de paquets r�f�renc�s dans une +d�pendance mais qui ne sont fournis par aucun paquet. Les paquets manquants +peuvent �tre mis en �vidence quand on n'acc�de pas � une distribution compl�te +ou si un paquet (r�el ou virtuel) a �t� abandonn� par une distribution. +Habituellement on les trouve dans les champs � Conflicts �. + </listitem> + + <listitem><para> +<literal/Total distinct/ versions est le nombre de versions de paquets trouv�es +dans le cache ; cette valeur est par cons�quent au moins �gale au nombre total +de paquets. Quand on acc�de � plus d'une distribution (� stable � et +� unstable �, par exemple), cette valeur peut �tre consid�rablement plus +grande que le nombre total de paquets. + </listitem> + + <listitem><para> +<literal/Total dependencies/ est le nombre de relations de d�pendances +d�clar�es par tous les paquets pr�sents dans le cache. + </listitem> + </itemizedlist> + </VarListEntry> + + <VarListEntry><Term>dump</Term> + <ListItem><Para> +La commande <literal/dump/ affiche un court r�sum� sur chaque paquet du cache. +Elle est d'abord destin�e au d�bogage. + </VarListEntry> + + <VarListEntry><Term>dumpavail</Term> + <ListItem><Para> +La commande <literal/dumpavail/ affiche sur la sortie standard une liste des +paquets disponibles. Elle convient � une utilisation avec &dpkg; et la +m�thode &dselect; s'en sert. + </VarListEntry> + + <VarListEntry><Term>unmet</Term> + <ListItem><Para> +La commande <literal/unmet/ affiche un r�sum� concernant toutes les +d�pendances absentes dans le cache de paquets. + </VarListEntry> + + <VarListEntry><Term>show</Term> + <ListItem><Para> +La commande <literal/show/ est semblable � <literal/dpkg --print-avail/ ; +elle affiche des informations sur les paquets donn�s en argument. + </VarListEntry> + + <VarListEntry><Term>search</Term> + <ListItem><Para> +La commande <literal/search/ recherche l'expression r�guli�re donn�e en +argument sur tous les paquets disponibles. Elle cherche une occurrence de la +cha�ne dans les noms de paquets et dans les descriptions puis elle affiche +le nom du paquet et sa description courte. Quand on donne l'option +<option/--full/, la sortie est identique � <literal/show/ pour chaque +paquet ; l'option <option/--names-only/ ne recherche pas la cha�ne +dans les descriptions longues mais seulement dans les noms de paquets. +<para> +On peut utiliser des arguments distincts pour indiquer des expressions +r�guli�res diff�rentes sur lesquelles sera r�alis� un � et � logique. + </VarListEntry> + + <VarListEntry><Term>depends</Term> + <ListItem><Para> +La commande <literal/depends/ affiche la liste de toutes les d�pendances +d'un paquet et la liste de tous les paquets possibles qui satisfont ces +d�pendances. + </VarListEntry> + + <VarListEntry><Term>pkgnames</Term> + <ListItem><Para> +Cette commande affiche le nom de chaque paquet du syst�me. Un pr�fixe pour +filtrer la liste des noms peut �tre donn� en argument. La sortie est +appropri�e � une utilisation au sein d'une fonction compl�te de shell ; elle +est produite tr�s rapidement. On utilise au mieux cette commande avec +l'option <option/--generate/. + </VarListEntry> + + <VarListEntry><Term>dotty</Term> + <ListItem><Para> +La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande +et affiche une sortie appropri�e � une utilisation par dotty avec le paquet +<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphVis</>. +Il en r�sulte un ensemble de noeuds et d'arcs repr�sentant les relations +entre les paquets. Par d�faut les paquets donn�s en argument suivent toutes +leurs d�pendances, ce qui peut produire un graphe tr�s volumineux. On peut +d�sactiver ce comportement en positionnant l'option +<literal>APT::Cache::GivenOnly</literal>. + </para> +<para> +Les noeuds r�sultants ont plusieurs formes ; les paquets normaux sont +des bo�tes, les � provides � purs sont des triangles, +les � provides � mixtes sont des diamants et les paquets manquants +sont des hexagones. Les bo�tes oranges expriment un arr�t de la r�cursivit� +[paquet feuille], les lignes bleues repr�sentent des pr�d�pendances et les +lignes vertes repr�sentent des conflits. + </para> + <para> +Attention, dotty ne peut pas repr�senter des ensembles de paquets +plus volumineux. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><Title>Options</> + &apt-cmdblurb; + + <VariableList> + <VarListEntry><term><option/-p/</><term><option/--pkg-cache/</> + <ListItem><Para> +Indique le fichier servant de cache des paquets. Le cache des paquets est +le cache primaire utilis� par toutes les op�rations. +�l�ment de configuration : <literal/Dir::Cache::pkgcache/. + </VarListEntry> + + <VarListEntry><term><option/-s/</><term><option/--src-cache/</> + <ListItem><Para> +Indique le fichier servant de cache des sources. Ce cache n'est utilis� que +par <literal/gencaches/ ; une version des informations sur les paquets, +faite � partir d'une analyse de sources distantes, est conserv�e. Quand le +cache des paquets est cr�e, le cache de sources est utilis� afin d'�viter +d'analyser � nouveau tous les paquets. +�l�ment de configuration : <literal/Dir::Cache::srcpkgcache/. + </VarListEntry> + + <VarListEntry><term><option/-q/</><term><option/--quiet/</> + <ListItem><Para> +Mode silencieux ; produit une sortie pertinente pour l'enregistrement dans un +fichier journal, sans afficher d'indicateur de progression. Un plus grand +nombre de q produira un plus grand silence, avec un maximum de 2. Vous pouvez +aussi utiliser <option/-q=#/ pour positionner le niveau de silence, annulant +le fichier de configuration. +�l�ment de configuration : <literal/quiet/. + </VarListEntry> + + <VarListEntry><term><option/-i/</><term><option/--important/</> + <ListItem><Para> +N'affiche que les d�pendances importantes ; � utiliser avec la commande +unmet pour n'afficher que les relations Depends et Pre-Depends. +�l�ment de configuration : <literal/APT::Cache::Important/. + </VarListEntry> + + <VarListEntry><term><option/-f/</><term><option/--full/</> + <ListItem><Para> +Affiche la totalit� des champs d'information sur le paquet lors d'une +recherche. +�l�ment de configuration : <literal/APT::Cache::ShowFull/. + </VarListEntry> + + <VarListEntry><term><option/-a/</><term><option/--all-versions/</> + <ListItem><Para> +Affiche la totalit� des champs d'information pour toutes les versions +disponibles : cette option concerne seulement la commande show. +�l�ment de configuration : <literal/APT::Cache::AllVersions/. + </VarListEntry> + + <VarListEntry><term><option/-g/</><term><option/--generate/</> + <ListItem><Para> +R�alise une mise � jour automatique du cache des paquets plut�t que de se +servir du cache actuel. +Pour d�sactiver cette option (option par d�faut), utiliser l'option +<option/--no-generate/. +�l�ment de configuration : <literal/APT::Cache::Generate/. + </VarListEntry> + + <VarListEntry><term><option/--names-only/</> + <ListItem><Para> +N'effectue une recherche que sur les noms de paquets et non sur les +descriptions longues. +�l�ment de configuration : <literal/APT::Cache::NamesOnly/. + </VarListEntry> + + <VarListEntry><term><option/--all-names/</> + <ListItem><Para> +Avec cette option <literal/pkgnames/ affiche tous les noms, les noms des +paquets virtuels et les d�pendances manquantes. +�l�ment de configuration : <literal/APT::Cache::AllNames/. + </VarListEntry> + + <VarListEntry><term><option/--recurse/</> + <ListItem><Para> +Avec cette option <literal/depends/ est r�cursive de mani�re � n'afficher +qu'une seule fois les paquets mentionn�s. +�l�ment de configuration : <literal/APT::Cache::RecurseDepends/. + </VarListEntry> + + &apt-commonoptions; + + </VariableList> + </RefSect1> + + <RefSect1><Title>Fichiers</> + <variablelist> + <VarListEntry><term><filename>/etc/apt/sources.list</></term> + <ListItem><Para> +Emplacements o� aller chercher les paquets. +�l�ment de configuration : <literal/Dir::Etc::SourceList/. + </VarListEntry> + + <VarListEntry><term><filename>&statedir;/lists/</></term> + <ListItem><Para> +Zone de stockage pour les informations qui concernent chaque ressource de +paquet 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 en transit. +�l�ment de configuration : <literal/Dir::State::Lists/ (partial est implicite). + </VarListEntry> + </variablelist> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-conf;, &sources-list;, &apt-get; + </RefSect1> + + <RefSect1><Title>Diagnostics</> + <para> +<command/apt-cache/ 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>
\ No newline at end of file diff --git a/doc/fr/apt-cdrom.8.fr.sgml b/doc/fr/apt-cdrom.8.fr.sgml new file mode 100644 index 000000000..11ba0ec63 --- /dev/null +++ b/doc/fr/apt-cdrom.8.fr.sgml @@ -0,0 +1,150 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.3 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-cdrom</> + <manvolnum>8</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt-cdrom</> + <refpurpose>Gestion des c�d�roms par APT</> + </refnamediv> + + <!-- Arguments --> + <refsynopsisdiv> + <cmdsynopsis> + <command>apt-cdrom</> + <arg><option>-hvrmfan</></arg> + <arg><option>-d=<replaceable/point de montage du c�d�rom/</></arg> + <arg><option>-o=<replaceable/option de configuration/</></arg> + <arg><option>-c=<replaceable/fichier/</></arg> + <group choice=req> + <arg>add</> + <arg>ident</> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <RefSect1><Title>Description</> + <para> +<command/apt-cdrom/ est utilis� pour ajouter un nouveau c�d�rom � la liste des +sources disponibles. <command/apt-cdrom/ prend soin de d�terminer la structure +du disque, de corriger de possibles erreurs de gravure et de v�rifier les +fichiers d'index. + <para> +Il est n�cessaire d'utiliser <command/apt-cdrom/ pour ajouter des c�d�roms au +syst�me APT, cela ne peut �tre r�alis� � � la main �. Par ailleurs, +chaque disque d'un ensemble de c�d�roms doit �tre s�par�ment ins�r� et +parcouru pour prendre en compte de possibles erreurs de gravure. + + <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>add</Term> + <ListItem><Para> +La commande <literal/add/ est utilis�e pour ajouter un nouveau disque � la +liste des sources. Elle d�monte le c�d�rom, r�clame l'insertion d'un disque, +parcourt ensuite le disque et copie les fichiers d'index. Si le disque ne +poss�de pas de r�pertoire <filename>.disk/</> correct, un titre descriptif +est demand�. + <para> +APT utilise un identifiant de c�d�rom pour reconna�tre le disque qui +se trouve actuellement dans le lecteur et maintient une base de donn�es de +ces identifiants dans <filename>&statedir;/cdroms.list</>. + </VarListEntry> + + <VarListEntry><Term>ident</Term> + <ListItem><Para> +Un outil de d�bogage pour rapporter l'identifiant du disque actuel ainsi +que le nom du fichier stock�. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><Title>Options</> + &apt-cmdblurb; + + <VariableList> + <VarListEntry><term><option/-d/</><term><option/--cdrom/</> + <ListItem><Para> +Point de montage ; sp�cifie l'emplacement de montage du c�d�rom. Ce +point de montage doit �tre sp�cifi� dans <filename>/etc/fstab</> et +correctement configur�. +�l�ment de configuration : <literal/Acquire::cdrom::mount/. + </VarListEntry> + + <VarListEntry><term><option/-r/</><term><option/--rename/</> + <ListItem><Para> +Change le nom d'un disque ; change le nom d'un disque ou annule le nom +donn� aux disques. Cette option oblige <command/apt-cdrom/ � demander un +nouveau nom � l'utilisateur. +�l�ment de configuration : <literal/APT::CDROM::Rename/. + </VarListEntry> + + <VarListEntry><term><option/-m/</><term><option/--no-mount/</> + <ListItem><Para> +Pas de montage ; emp�che <command/apt-cdrom/ de monter ou d�monter le +point de montage. �l�ment de configuration : <literal/APT::CDROM::NoMount/. + </VarListEntry> + + <VarListEntry><term><option/-f/</><term><option/--fast/</> + <ListItem><Para> +Copie rapide ; suppose que les paquets sont valides et ne v�rifie pas +chaque paquet. Cette option ne devrait �tre utilis�e que si <command/apt-cdrom/ +a pr�alablement utilis� ce disque et n'a trouv� aucune erreur. +�l�ment de configuration : <literal/APT::CDROM::Fast/. + </VarListEntry> + + <VarListEntry><term><option/-a/</><term><option/--thorough/</> + <ListItem><Para> +Parcours minutieux des paquets ; cette option peut �tre n�cessaire avec +de vieux c�d�roms de syst�mes Debian 1.1 ou 1.2 dont les fichiers Packages +sont situ�s dans des endroits �tranges. Il faudra plus de temps pour +parcourir le CD mais tous les paquets seront rep�r�s. + </VarListEntry> + + <VarListEntry><term><option/-n/</> + <term><option/--just-print/</> + <term><option/--recon/</> + <term><option/--no-act/</> + <ListItem><Para> +Aucune modification ; ne pas modifier le fichier &sources-list; ni les +fichiers d'index. Cependant, tout est v�rifi�. +�l�ment de configuration : <literal/APT::CDROM::NoAct/. + </VarListEntry> + + &apt-commonoptions; + + </VariableList> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-conf;, &apt-get;, &sources-list; + </RefSect1> + + <RefSect1><Title>Diagnostics</> + <para> +<command/apt-cdrom/ 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> + diff --git a/doc/fr/apt-config.8.fr.sgml b/doc/fr/apt-config.8.fr.sgml new file mode 100644 index 000000000..788bed89f --- /dev/null +++ b/doc/fr/apt-config.8.fr.sgml @@ -0,0 +1,113 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.3 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-config</> + <manvolnum>8</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt-config</> + <refpurpose>Programme pour interroger la configuration de APT</> + </refnamediv> + + <!-- Arguments --> + <refsynopsisdiv> + <cmdsynopsis> + <command>apt-config</> + <arg><option>-hv</></arg> + <arg><option>-o=<replaceable/option de configuration/</></arg> + <arg><option>-c=<replaceable/fichier/</></arg> + <group choice=req> + <arg>shell</> + <arg>dump</> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <RefSect1><Title>Description</> + <para> +<command/apt-config/ est un programme interne utilis� par diff�rentes +composantes d'APT ; il offre la possibilit� d'une configuration +coh�rente et permet aux applications con�ues sous forme de scripts une +utilisation simple du fichier de configuration principal +<filename>/etc/apt/apt.conf</>. + <para> +� moins que l'option <option>-h</> ou <option>--help</> ne soit donn�e, l'une +des commandes suivantes doit �tre pr�sente. + </para> + + <VariableList> + <VarListEntry><Term>shell</Term> + <ListItem><Para> +Le terme shell est utilis� pour acc�der aux informations de configuration +depuis un script shell. Deux arguments doivent lui �tre donn�s ; le +premier est une variable de shell et le second une valeur de configuration � +demander. +La sortie standard consiste en une liste de commandes d'assignation de shell +pour chaque valeur pr�sente. Dans un script shell, cette commande devrait +�tre utilis�e comme suit : + + </para> + +<informalexample><programlisting> +OPTS="-f" +RES=`apt-config shell OPTS MyApp::Options` +eval $RES +</programlisting></informalexample> + + <para> +La variable d'environnement de shell $OPTS sera d�finie par la valeur de +MyApp::Options ou, par d�faut, la valeur -f. + + <para> +L'�l�ment de configuration peut �tre suivi par /[fdbi]. � f � +renvoie un nom de fichier, � d � un nom de r�pertoire, +� b � renvoie � true � ou � false � et +� i � renvoie un entier. Chacune de ses valeurs est normalis�e et v�rifi�e. + </VarListEntry> + + <VarListEntry><Term>dump</Term> + <ListItem><Para> +Affiche seulement le contenu de l'espace de configuration. + </VarListEntry> + + </VariableList> + </RefSect1> + + <RefSect1><Title>Options</> + &apt-cmdblurb; + + <VariableList> + + &apt-commonoptions; + + </VariableList> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-conf; + </RefSect1> + + <RefSect1><Title>Diagnostics</> + <para> +<command/apt-config/ retourne z�ro apr�s un d�roulement normal, et le nombre +100 en cas d'erreur. + </RefSect1> + + &manbugs; + &manauthor; + &deux-traducteurs; + +</refentry> diff --git a/doc/fr/apt-extracttemplates.1.fr.sgml b/doc/fr/apt-extracttemplates.1.fr.sgml new file mode 100644 index 000000000..25f375106 --- /dev/null +++ b/doc/fr/apt-extracttemplates.1.fr.sgml @@ -0,0 +1,83 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.4 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-extracttemplates</> + <manvolnum>1</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt-extracttemplates</> +<refpurpose>Un outil pour extraire d'un paquet Debian les textes de configuration pour DebConf. + </refnamediv> + + <!-- Arguments --> + <refsynopsisdiv> + <cmdsynopsis> + <command>apt-extracttemplate</> + <arg><option>-hv</></arg> + <arg><option>-t=<replaceable/r�pertoire temporaire/</></arg> + <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <RefSect1><Title>Description</> + <para> +<command/apt-extracttemplates/ prend un ou plusieurs paquets Debian en +argument et renvoie (dans un r�pertoire temporaire) tous les scripts et +guides de configuration associ�s. Pour chaque paquet trait� contenant des +scripts et guides de configuration, une ligne est affich�e au format +suivant : + <para> + paquet version guide-de-configuration script-de-configuration + <para> +Les scripts et guides de configuration sont �crits dans le r�pertoire +temporaire indiqu� par l'option <option>-t</option> ou +<option>--tempdir</option> (<literal/APT::ExtractTemplates::TempDir/>) ; les noms de fichier sont de la +forme <filename>template.XXXX</> ou <filename>config.XXXX</>. + </RefSect1> + + <RefSect1><Title>Options</> + &apt-cmdblurb; + + <VariableList> + <VarListEntry><term><option/-t/</><term><option/--tempdir/</> + <ListItem><Para> +R�pertoire temporaire dans lequel �crire les scripts et guides de +configuration pour Debconf. +�l�ment de configuration : <literal/APT::ExtractTemplates::TempDir/. + </VarListEntry> + + &apt-commonoptions; + + </VariableList> + + + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-conf; + </RefSect1> + + <RefSect1><Title>Diagnostics</> + <para> +<command/apt-extracttemplates/ retourne z�ro si tout se passe bien, le nombre +100 en cas d'erreur. + </RefSect1> + + &manbugs; + &manauthor; +&traducteur; + +</refentry> diff --git a/doc/fr/apt-ftparchive.1.fr.sgml b/doc/fr/apt-ftparchive.1.fr.sgml new file mode 100644 index 000000000..98fc5ac83 --- /dev/null +++ b/doc/fr/apt-ftparchive.1.fr.sgml @@ -0,0 +1,517 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.4 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-ftparchive</> + <manvolnum>1</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt-ftparchive</> + <refpurpose>Un outil pour cr�er des index + </refnamediv> + + <!-- Arguments --> + <refsynopsisdiv> + <cmdsynopsis> + <command>apt-ftparchive</> + <arg><option>-hvdsq</></arg> + <arg><option>--md5</></arg> + <arg><option>--delink</></arg> + <arg><option>--readonly</></arg> + <arg><option>--contents</></arg> + <arg><option>-o=<replaceable/option de configuration/</></arg> + <arg><option>-c=<replaceable/fichier/</></arg> + <group choice=req> + <arg>packages<arg choice="plain" rep="repeat"><replaceable>chemin</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pr�fixe-de-chemin</replaceable></arg></arg></arg> + <arg>sources<arg choice="plain" rep="repeat"><replaceable>chemin</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pr�fixe-de-chemin</replaceable></arg></arg></arg> + <arg>contents <arg choice="plain"><replaceable>chemin</replaceable></arg></arg> + <arg>generate <arg choice="plain"><replaceable>fichier-de-configuration</replaceable></arg> <arg choice="plain" rep="repeat"><replaceable>section</replaceable></arg></arg> + <arg>clean <arg choice="plain"><replaceable>fichier-de-configuration</replaceable></arg></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <RefSect1><Title>Description</> + <para> +<command/apt-ftparchive/ est l'outil en ligne de commande qui cr�e les index +dont APT se sert pour acc�der aux sources des distributions. Un index doit +�tre cr�� pour un site et bas� sur le contenu de ce site. + + <para> +<command/apt-ftparchive/ est un ensemble comprenant le programme +&dpkg-scanpackages; et toutes ses fonctionnalit�s via la commande +<literal/directory/ ; il comprend aussi un g�n�rateur de fichier � Contents �, +la commande <literal/contents/, et une technique �labor�e pour � scripter � +le processus de cr�ation d'une archive compl�te. + + <para> +<command/apt-ftparchive/ peut utiliser lui-m�me des bases de donn�es binaires +pour � cacher � le contenu d'un fichier .deb ; il n'a pas besoin de programmes +ext�rieurs, sauf &gzip;. Lors d'une ex�cution, il v�rifie les changements dans +les fichiers et cr�e les fichiers compress�s voulus. + + <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>packages</term> + <ListItem><Para> +La commande <literal/packages/ cr�e un fichier � Packages � � partir d'une +arborescence. Elle recherche r�cursivement � travers le r�pertoire donn� +les fichiers .deb et, pour chaque fichier trouv�, envoie l'enregistrement +du paquet sur la sortie standard. Cette commande est approximativement +�quivalente � &dpkg-scanpackages;. + <para> +On peut se servir de l'option <option/--db/ pour demander un cache binaire. + </VarListEntry> + + <VarListEntry><term>sources</term> + <ListItem><Para> +La commande <literal/sources/ cr�e un index des sources � partir d'une +arborescence. Elle recherche r�cursivement � travers le r�pertoire donn� +les fichiers .dsc et, pour chaque fichier trouv�, envoie l'enregistrement +du paquet sur la sortie standard. Cette commande est approximativement +�quivalente � &dpkg-scansources;. + <para> +Quand on pr�cise un fichier � override �, c'est un fichier source avec une +extension .src qui est recherch�. On peut se servir de l'option +<option/--source-override/ pour changer de fichier source d'� override �. + </VarListEntry> + + <VarListEntry><term>contents</term> + <ListItem><Para> +La commande <literal/contents/ cr�e un fichier � Contents � � partir d'une +arborescence. Elle recherche r�cursivement � travers le r�pertoire donn� +les fichiers .deb et, pour chaque fichier trouv�, lit la liste des +fichiers. Elle trie la liste des fichiers correspondant � des paquets et +l'envoie sur la sortie standard. Les r�pertoires ne font pas partie du +r�sultat. Quand un fichier appartient � plusieurs paquets, une virgule +s�pare les paquets. + <para> +On peut se servir de l'option <option/--db/ pour demander un cache binaire. + </VarListEntry> + + <VarListEntry><term>generate</term> + <ListItem><Para> +La commande <literal/generate/ est con�ue pour �tre ex�cutable par le +programme cron et elle cr�e un index en suivant le fichier de configuration +donn�. Le langage de configuration fournit un moyen souple de pr�ciser +index et r�pertoires aussi bien que les param�tres requis. + </VarListEntry> + + <VarListEntry><term>clean</term> + <ListItem><Para> +La commande <literal/clean/ range les bases de donn�es utilis�es par le +fichier de configuration en supprimant les enregistrements qui ne sont +plus n�cessaires. + </VarListEntry> + </VariableList> + + </RefSect1> + + <RefSect1><Title>Configuration de la commande generate</> + <para> +La commande <literal/generate/ utilise un fichier de configuration pour +d�crire l'archive qui va �tre cr��e. Le format de ce fichier est le format +ISC classique utilis� par des outils ISC comme bind 8 et dhcpd. &apt-conf; +d�crit ce format. Il faut noter que l'analyse de ce fichier se fait +par section tandis que celle d'&apt-conf; se fait par arborescence. Cela +n'affecte que l'usage de l'�tiquette de vis�e (scope tag). + + <para> +Ce fichier de configuration poss�de quatre sections, d�crites ci-dessous. + + <refsect2><title>La section Dir</> + <Para> +La section <literal/Dir/ d�finit les r�pertoires standards o� situer les +fichiers n�cessaires au processus de cr�ation. Ces r�pertoires sont +pr�c�d�s de chemins relatifs d�finis dans les sections suivantes de mani�re +� produire un chemin absolu et complet. + <VariableList> + <VarListEntry><term>ArchiveDir</term> + <ListItem><Para> +Indique la racine de l'archive FTP ; Pour une configuration Debian classique, +c'est le r�pertoire qui contient le fichier <filename/ls-LR/, et les noeuds +des distributions. + </VarListEntry> + + <VarListEntry><term>OverrideDir</term> + <ListItem><Para> +Indique l'emplacement des fichiers d'� override �. + </VarListEntry> + + <VarListEntry><term>CacheDir</term> + <ListItem><Para> +Indique l'emplacement des fichiers de cache. + </VarListEntry> + + <VarListEntry><term>FileListDir</term> + <ListItem><Para> +Indique l'emplacement des fichiers contenant la liste des fichiers (si on se +sert de la valeur <literal/FileList/ d�finie plus bas). + </VarListEntry> + </VariableList> + </refsect2> + + <refsect2><title>La section Default</> + <para> +La section <literal/Default/ pr�cise les valeurs par d�faut et les param�tres +qui contr�lent la marche du g�n�rateur. Ces valeurs peuvent �tre annul�es dans +d'autres sections (param�trage par section). + <VariableList> + <VarListEntry><term>Packages::Compress</term> + <ListItem><Para> +Indique comment sont compress�s les fichiers d'index. C'est une cha�ne qui +contient des valeurs s�par�es par des espaces ; elle contient au moins l'une +des valeurs suivantes : � . � (pas de compression), � gzip �, � bzip2 �. +Par d�faut, c'est la cha�ne � . gzip �. + </VarListEntry> + + <VarListEntry><term>Packages::Extensions</term> + <ListItem><Para> +Indique la liste par d�faut des extensions de fichier qui constituent des +fichiers-paquets. Par d�faut, c'est � .deb �. + </VarListEntry> + + <VarListEntry><term>Sources::Compress</term> + <ListItem><Para> +Identique � <literal/Packages::Compress/ mais pr�cise comment sont compress�s +les fichiers sources. + </VarListEntry> + + <VarListEntry><term>Sources::Extensions</term> + <ListItem><Para> +Indique la liste par d�faut des extensions de fichier qui constituent des +fichiers sources. Par d�faut, c'est � .dsc �. + </VarListEntry> + + <VarListEntry><term>Contents::Compress</term> + <ListItem><Para> +Identique � <literal/Packages::Compress/ mais pr�cise comment sont compress�s +les fichiers � Contents �. + </VarListEntry> + + <VarListEntry><term>DeLinkLimit</term> + <ListItem><Para> +Indique le nombre de kilooctets � d�lier (et � remplacer par des liens en dur) +pour chaque ex�cution. On s'en sert, pour chaque section, avec le param�tre +<literal/External-Links/. + </VarListEntry> + + <VarListEntry><term>FileMode</term> + <ListItem><Para> +Indique le syst�me de permissions des fichiers d'index cr��s. Par d�faut, +c'est le mode 0644. Tous les fichiers d'index ont ce mode et le masque +utilisateur (umasq) est ignor�. + </VarListEntry> + </VariableList> + </refsect2> + + <refsect2><title>La section TreeDefault</> + <para> +On indique les valeurs par d�faut particuli�res � la section � Tree �. Toutes +ces variables sont des variables de substitution ; les cha�nes $(DIST), +$(SECTION) et $(ARCH) sont remplac�es par leur valeur respective. + + <VariableList> + <VarListEntry><term>MaxContentsChange</term> + <ListItem><Para> +Indique le nombre de kilooctets de fichiers � Contents � qui sont +cr�es chaque jour. Les fichiers � Contents � sont tir�s au sort +selon le syst�me <emphasis>round-robin</emphasis> de mani�re que, sur +plusieurs jours, tous soient reconstruits. + </VarListEntry> + + <VarListEntry><term>ContentsAge</term> + <ListItem><Para> +Contr�le le nombre de jours pendant lequel un fichier � Contents � peut �tre +utilis� sans actualisation. Quand cette limite est franchie, le � mtime � +du fichier � Contents � est mis � jour. Cela peut arriver quand un fichier +est modifi� sans que cela modifie le fichier � Contents � (modification +par � override � par exemple). Un d�lai est permis dans l'espoir que de +nouveaux � .deb � seront install�s, exigeant un nouveau � Contents �. Par +d�faut ce nombre vaut 10, l'unit� �tant le jour. + </VarListEntry> + + <VarListEntry><term>Directory</term> + <ListItem><Para> +Indique la racine de l'arborescence des � .deb �. Par d�faut, c'est +<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</>. + </VarListEntry> + + <VarListEntry><term>Packages</term> + <ListItem><Para> +Indique le fichier � Packages � cr�e. Par d�faut, c'est +<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</>. + </VarListEntry> + + <VarListEntry><term>Sources</term> + <ListItem><Para> +Indique le fichier � Packages � cr�e. Par d�faut, c'est +<filename>$(DIST)/$(SECTION)/source/Sources</>. + </VarListEntry> + + <VarListEntry><term>InternalPrefix</term> + <ListItem><Para> +Indique un pr�fixe de chemin ; ce pr�fixe fait qu'un lien symbolique sera +consid�r� comme un lien interne plut�t que comme un lien externe. Par d�faut, +c'est <filename>$(DIST)/$(SECTION)/</>. + </VarListEntry> + + <VarListEntry><term>Contents</term> + <ListItem><Para> +Indique le fichier � Contents � cr�e. Par d�faut, c'est +<filename>$(DIST)/Contents-$(ARCH)</>. Quand le param�trage fait que +diff�rents fichiers � Packages � se r�f�rent � un seul fichier � Contents �, +<command/apt-ftparchive/ les int�gre automatiquement. + </VarListEntry> + + <VarListEntry><term>Contents::Header</term> + <ListItem><Para> +Indique l'en-t�te � pr�fixer au fichier � Contents � cr�e. + </VarListEntry> + + <VarListEntry><term>BinCacheDB</term> + <ListItem><Para> +Indique la base de donn�e binaire servant de cache pour cette section. +Diff�rentes sections peuvent partager cette base de donn�es. + </VarListEntry> + + <VarListEntry><term>FileList</term> + <ListItem><Para> +Indique qu'au lieu de lire l'arborescence, <command/apt-ftparchive/ doit lire +la liste de fichiers dans le fichier donn� en argument. Les noms relatifs +sont pr�fix�s par le r�pertoire de l'archive. + </VarListEntry> + + <VarListEntry><term>SourceFileList</term> + <ListItem><Para> +Indique qu'au lieu de lire l'arborescence, <command/apt-ftparchive/ doit lire +la liste de fichiers dans le fichier donn� en argument. Les noms relatifs +sont pr�fix�s par le r�pertoire de l'archive. On s'en sert pour cr�er des +index de sources. + </VarListEntry> + </VariableList> + </refsect2> + + <refsect2><title>La section Tree</> + <para> +La section <literal/Tree/ d�finit une arborescence debian classique avec +un r�pertoire de base, diff�rentes sections dans ce r�pertoire et +diff�rentes architectures dans chaque section. Le chemin exact est d�fini +par la variable de substitution <literal/Directory/. + <para> +La section <literal/Tree/ accepte une �tiquette de vis�e (scope tag) qui +d�termine la variable <literal/$(DIST)/ et la racine de l'arborescence +(le chemin est pr�fix� par <literal/ArchiveDir/). C'est par exemple : +<filename>dists/woody</>. + <para> +Tous les param�tres d�finis dans la section <literal/TreeDefault/ peuvent +s'utiliser dans la section <literal/Tree/ ainsi que les trois nouvelles +variables suivantes. + <para> +Quand il ex�cute la section <literal/Tree/, <command/apt-ftparchive/ +agit ainsi : +<informalexample><programlisting> +for i in Sections do + for j in Architectures do + Generate for DIST=scope SECTION=i ARCH=j +</programlisting></informalexample> + + <VariableList> + <VarListEntry><term>Sections</term> + <ListItem><Para> +C'est une liste de sections s�par�es par des espaces qui appartiennent � une +distribution ; classiquement, on trouve <literal/main contrib non-free/. + </VarListEntry> + + <VarListEntry><term>Architectures</term> + <ListItem><Para> +C'est une liste de toutes les architectures qui appartiennent � chaque +section. L'architecture sp�ciale � source � indique que l'arborescence +est une arborescence de sources. + </VarListEntry> + + <VarListEntry><term>BinOverride</term> + <ListItem><Para> +Indique le fichier binaire d'� override �. le fichier d'� override � contient +des informations sur la section, la priorit� et le responsable de paquet. + </VarListEntry> + + <VarListEntry><term>SrcOverride</term> + <ListItem><Para> +Indique le fichier source d'� override �. Le fichier d'� override � contient +des informations sur la section. + </VarListEntry> + </VariableList> + </refsect2> + + <refsect2><title>La section BinDirectory</> + <para> +La section <literal/bindirectory/ d�finit une arborescence binaire sans +structure particuli�re. L'�tiquette de vis�e (scope tag) indique l'emplacement +du r�pertoire binaire et le param�trage est identique � celui pour la +section <literal/Tree/ sans substitution de variables ou au param�trage de +<literal>Section</><literal>Architecture</>. + <VariableList> + <VarListEntry><term>Packages</term> + <ListItem><Para> +Indique le fichier � Packages � cr�e. + </VarListEntry> + + <VarListEntry><term>SrcPackages</term> + <ListItem><Para> +Indique le fichier � Sources � cr�e. L'un des deux fichiers, +<literal/Packages/ ou <literal/SrcPackages/ est n�cessaire. + </VarListEntry> + + <VarListEntry><term>Contents</term> + <ListItem><Para> +Indique le fichier � Contents � cr�e. + </VarListEntry> + + <VarListEntry><term>Binoverride</term> + <ListItem><Para> +Indique le fichier binaire d'� override �. + </VarListEntry> + + <VarListEntry><term>SrcOverride</term> + <ListItem><Para> +Indique le fichier source d'� override �. + </VarListEntry> + + <VarListEntry><term>BinCacheDB</term> + <ListItem><Para> +Indique une base de donn�es cache. + </VarListEntry> + + <VarListEntry><term>PathPrefix</term> + <ListItem><Para> +Ajoute un chemin � tous les chemins cr��s. + </VarListEntry> + + <VarListEntry><term>FileList, SourceFileList</term> + <ListItem><Para> +Indique le fichier contenant la liste des fichiers. + </VarListEntry> + </VariableList> + </refsect2> + </RefSect1> + + <RefSect1><Title>Le fichier binaire � Override �</> + <para> +Le fichier binaire � Override � est pleinement compatible avec +&dpkg-scanpackages;. Il contient quatre champs s�par�s par des espaces. Le +premier est le nom du paquet ; le deuxi�me est la priorit� � donner � ce +paquet ; le troisi�me est sa section et le dernier champ est un champ pour +une permutation du responsable du paquet. + <para> +Le champ du responsable est de cette forme : + <literallayout>old [// oldn]* => new</literallayout> + ou simplement, + <literallayout>new</literallayout> +La premi�re forme permet de sp�cifier de vieilles adresses dans une liste (le +s�parateur est la double barre oblique). Si l'une de ces deux formes est +rencontr�e, la valeur de new remplace la valeur du champ. La deuxi�me forme +remplace inconditionnellement le champ. + </RefSect1> + + <RefSect1><title>Le fichier Source � Override �</> + <para> +Le fichier Source � Override � est pleinement compatible avec +&dpkg-scansources;. Il contient deux champs. Le premier est le nom du paquet +source; le second, sa section. + </RefSect1> + + <RefSect1><Title>Les options</> + &apt-cmdblurb; + + <VariableList> + <VarListEntry><term><option/--md5/</> + <ListItem><Para> +Cr�er la somme de contr�le MD5. Cette option est activ�e par d�faut. Quand +elle est d�sactiv�e, les fichiers d'index n'ont pas les champs MD5Sum l� o� +c'est possible. +�l�ment de configuration : <literal/APT::FTPArchive::MD5/. + </VarListEntry> + + <VarListEntry><term><option/-d/</><term><option/--db/</> + <ListItem><Para> +Utiliser une base de donn�es binaire pour cache. Cela n'a aucun effet sur la +commande generate. +�l�ment de configuration : <literal/APT::FTPArchive::DB/. + </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. +�l�ment de configuration : <literal/quiet/. + </VarListEntry> + + <VarListEntry><term><option/--delink/</> + <ListItem><Para> +Faire une d�liaison. Si <literal/External-Links/ est activ�, cette option +permet r�ellement la d�liaison des fichiers. Par d�faut, elle est activ�e mais +elle peut �tre d�sactiv�e avec l'option <option/--no-delink/. +�l�ment de configuration : <literal/APT::FTPArchive::DeLinkAct/. + </VarListEntry> + + <VarListEntry><term><option/--contents/</> + <ListItem><Para> +Permettre la cr�ation d'un fichier � Contents �. Quand cette option est +activ�e et que les index sont cr��s sous forme de base de donn�es binaire, +la liste des fichiers est aussi extraite et conserv�e dans la base de donn�es +pour un usage futur. Avec la commande generate, cette option permet la +cr�ation de fichiers � Contents �. Par d�faut, elle est activ�e. +�l�ment de configuration : <literal/APT::FTPArchive::Contents/. + </VarListEntry> + + <VarListEntry><term><option/-s/</><term><option/--source-override/</> + <ListItem><Para> +Indique le fichier source d'� override � � utiliser avec la commande +<literal/sources/. +�l�ment de configuration : <literal/APT::FTPArchive::SourceOverride/. + </VarListEntry> + + <VarListEntry><term><option/--readonly/</> + <ListItem><Para> +N'autoriser que la lecture pour les bases de donn�es de cache. +�l�ment de configuration : <literal/APT::FTPArchive::ReadOnlyDB/. + </VarListEntry> + + &apt-commonoptions; + + </VariableList> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-conf; + </RefSect1> + + <RefSect1><Title>Diagnostics</> + <para> +<command/apt-ftparchive/ retourne z�ro si tout se passe bien, le nombre +d�cimal 100 en cas d'erreur. + </RefSect1> + + &manbugs; + &manauthor; + &traducteur; +</refentry> diff --git a/doc/fr/apt-sortpkgs.1.fr.sgml b/doc/fr/apt-sortpkgs.1.fr.sgml new file mode 100644 index 000000000..8e964f6b8 --- /dev/null +++ b/doc/fr/apt-sortpkgs.1.fr.sgml @@ -0,0 +1,75 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.3 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-sortpkgs</> + <manvolnum>1</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt-sortpkgs</> + <refpurpose>Un outil pour trier les index de paquets. + </refnamediv> + + <!-- Arguments --> + <refsynopsisdiv> + <cmdsynopsis> + <command>apt-sortpkgs</> + <arg><option>-hvs</></arg> + <arg><option>-o=<replaceable/option de configuration/</></arg> + <arg><option>-c=<replaceable/fichier/</></arg> + <arg choice="plain" rep="repeat"><replaceable/fichier/</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <RefSect1><Title>Description</> + <para> +<command/apt-sortpkgs/ prend un index (un index de Source ou un index de +paquet) et trie leurs enregistrements selon le nom de paquet. Un tri des +champs de chaque enregistrement est r�alis� selon des r�gles internes. + + <para> +Le r�sultat est envoy� sur la sortie standard ; l'entr�e doit �tre un +fichier analysable. + </RefSect1> + + <RefSect1><Title>Options</> + &apt-cmdblurb; + + <VariableList> + <VarListEntry><term><option/-s/</><term><option/--source/</> + <ListItem><Para> +Se servir d'un index de sources pour le tri des champs. +�l�ment de configuration : <literal/APT::SortPkgs::Source/. + </VarListEntry> + + &apt-commonoptions; + + </VariableList> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-conf; + </RefSect1> + + <RefSect1><Title>Diagnostics</> + <para> +<command/apt-sortpkgs/ retourne z�ro si tout se passe bien ou 100 en cas +d'erreur. + </RefSect1> + + &manbugs; + &manauthor; + &traducteur; +</refentry> diff --git a/doc/fr/apt.conf.5.fr.sgml b/doc/fr/apt.conf.5.fr.sgml new file mode 100644 index 000000000..3e104203e --- /dev/null +++ b/doc/fr/apt.conf.5.fr.sgml @@ -0,0 +1,436 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.5 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt.conf</> + <manvolnum>5</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt.conf</> + <refpurpose>Fichier de configuration pour APT</> + </refnamediv> + + <RefSect1><Title>Description</> + <para> + <filename/apt.conf/ est le principal fichier de configuration de la +collection d'outils que constitue APT ; tous les outils font appel � ce +fichier de configuration et utilisent un analyseur syntaxique de ligne de +commande commun afin de fournir un environnement uniforme. Quand un outil +d'APT d�marre, il lit (si elle existe) la variable d'environnement +<envar/APT_CONFIG/ ; puis il lit les fichiers situ�s dans +<literal/Dir::Etc::Parts/ ainsi que le principal fichier de configuration +indiqu� par <literal/Dir::Etc::main/ ; enfin il applique les options de la ligne de commande qui annulent les directives de configuration, chargeant, +si n�cessaire, d'autres fichiers de configuration. + <para> +Le fichier de configuration est construit comme un arbre d'options +organis�es en groupes fonctionnels. On se sert du double deux points (� :: �) pour indiquer une option ; par exemple, <literal/APT::Get::Assume-Yes/ est +une option pour le groupe d'outils APT, destin�e � l'outil Get. Les options +n'h�ritent pas des groupes de leurs parents. + <para> +Syntaxiquement, le langage de configuration est con�u sur le m�me mod�le +que les langages utilis�s par des outils ISC tels que bind et dhcp. Chaque +ligne est de la forme : + <literallayout>APT::Get::Assume-Yes "true";</literallayout> +Le point-virgule final est obligatoire et les guillemets sont optionnels. +On peut d�clarer un nouveau champ d'action avec des accolades, comme +suit : +<informalexample><programlisting> +APT { + Get { + Assume-Yes "true"; + Fix-Broken "true"; + }; +}; +</programlisting></informalexample> +avec des retours � la ligne pour faciliter la lecture. On peut cr�er des +listes en ouvrant un champ d'action et en mettant un seul mot entre +apostrophes suivi d'un point-virgule. On peut mettre plusieurs entr�es, +s�par�es par un point-virgule. +<informalexample><programlisting> +DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; +</programlisting></informalexample> + <para> +Les mod�les <filename>&docdir;examples/apt.conf</> &configureindex; +montrent � quoi devrait ressembler le fichier de configuration. + <para> +Deux �l�ments sp�ciaux sont autoris�s : <literal/#include/ et +<literal/#clear/. <literal/#include/ inclut le fichier donn� en argument, � +moins que le nom se termine par une barre oblique. <literal/#clear/ sert � +effacer une liste de noms. + <para> +Tous les outils d'APT poss�dent une option <option>-o</> qui permet de +sp�cifier une configuration arbitraire depuis la ligne de commande. La +syntaxe consiste en un nom complet d'option (par exemple +<literal/APT::Get::Assume-Yes/) suivi par un signe �gal, puis par la nouvelle +valeur de l'option. On peut compl�ter une liste en ajoutant un � :: � au nom +de la liste. + </RefSect1> + + <RefSect1><Title>Le groupe APT</> + <para> +Ce groupe d'options contr�le aussi bien le comportement global d' APT que +la prise en compte des options pour chaque outil. + + <VariableList> + <VarListEntry><Term>Architecture</Term> + <ListItem><Para> +L'architecture du syst�me ; cette option positionne l'architecture � utiliser +pour r�cup�rer des fichiers et analyser des listes de paquets. L'architecture +interne par d�faut est celle pour laquelle APT a �t� compil�. + </VarListEntry> + + <VarListEntry><Term>Ignore-Hold</Term> + <ListItem><Para> +Ignore les paquets � suspendus � ; cette option globale indique au syst�me de +r�solution de ne pas tenir compte des paquets � suspendus � dans sa prise de +d�cision. + </VarListEntry> + + <VarListEntry><Term>Clean-Installed</Term> + <ListItem><Para> +Avec cette option qui est activ�e par d�faut, la fonctionnalit� � autoclean � +supprime tout paquet qui ne peut plus �tre r�cup�r� dans le cache. +Quand cette option est d�sactiv�e, les paquets qui sont install�s localement +sont aussi exclus du nettoyage - mais notez que APT ne fournit aucun moyen +direct pour les r�installer. + </VarListEntry> + + <VarListEntry><Term>Immediate-Configure</Term> + <ListItem><Para> +D�sactive la configuration imm�diate ; cette dangereuse option d�sactive +une partie du code de mise en ordre de APT pour que ce dernier effectue le +moins d'appels possible � Dpkg. C'est peut �tre n�cessaire sur des syst�mes +lents � un seul utilisateur mais c'est extr�mement dangereux et cela peut +faire �chouer les scripts d'installation, voire pire. +Utilisez-la � vos risques et p�rils. + </VarListEntry> + + <VarListEntry><Term>Force-LoopBreak</Term> + <ListItem><Para> +Ne jamais activer cette option � moins que vous ne sachiez -r�ellement- ce que +vous faites. Elle autorise APT � supprimer temporairement un paquet +essentiel pour mettre fin � une boucle Conflicts / Conflicts ou +Conflicts / Pre-Depends entre deux paquets essentiels. UNE TELLE BOUCLE +NE DOIT JAMAIS SE PRODUIRE : C'EST UN BOGUE S�RIEUX. Cette option fonctionne +si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, bash ou tous +les paquets dont ces paquets d�pendent. + </VarListEntry> + + <VarListEntry><Term>Cache-Limit</Term> + <ListItem><Para> +APT utilise un fichier cache d'une taille m�moire fixe pour ranger les +informations du fichier � available �. Cette option fixe la taille de ce cache. + </VarListEntry> + + <VarListEntry><Term>Get</Term> + <ListItem><Para> +La sous-section <literal/Get/ contr�le l'outil &apt-get;, veuillez consulter +sa documentation pour avoir plus d'informations sur les options en question. + </VarListEntry> + + <VarListEntry><Term>Cache</Term> + <ListItem><Para> +La sous-section <literal/Cache/ contr�le l'outil &apt-cache;, veuillez +consulter sa documentation pour avoir plus d'informations sur les options en +question. + </VarListEntry> + + <VarListEntry><Term>CDROM</Term> + <ListItem><Para> +La sous-section <literal/CDROM/ contr�le l'outil &apt-cdrom;, veuillez +consulter sa documentation pour avoir plus d'informations sur les options en +question. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><Title>Le groupe Acquire</> + <para> +Le groupe d'options <literal/Acquire/ contr�le le t�l�chargement des paquets et +les gestionnaires d'URI. + + <VariableList> + <VarListEntry><Term>Queue-Mode</Term> + <ListItem><Para> +Le mode file d'attente ; <literal/Queue-Mode/ peut prendre une valeur parmi +<literal/host/ ou <literal/access/ et cela d�termine comment APT parall�lise +les connexions sortantes. <literal/host/ signifie qu'une connexion par cible +sera initi�e, tandis que <literal/access/ signifie qu'une connexion par type +d'URI sera initi�e. + </VarListEntry> + + <VarListEntry><Term>Retries</Term> + <ListItem><Para> +Nombre d'essais � effectuer. Si ce nombre n'est pas nul, APT essaie de +r�cup�rer, le nombre donn� de fois, les fichiers dont le rapatriement a �chou�. + </VarListEntry> + + <VarListEntry><Term>Source-Symlinks</Term> + <ListItem><Para> +Utilise des liens symboliques pour les archives de sources. Positionn�e � +� true �, cette option cr�e si possible des liens symboliques vers les +archives de sources au lieu de les copier. +Par d�faut � � true �. + </VarListEntry> + + <VarListEntry><Term>http</Term> + <ListItem><Para> +HTTP URIs; http::Proxy est le mandataire (proxy) http � utiliser par d�faut. +Il se pr�sente sous la forme standard : +<literal>http://[[user][:pass]@]host[:port]/</>. En utilisant la syntaxe : +<literal/http::Proxy::<host>/, o� le mot-cl� sp�cial <literal/DIRECT/ +indique de n'utiliser aucun mandataire, on peut sp�cifier un mandataire +pour chaque machine distante. La variable d'environnement <envar/http_proxy/ +remplace tous ces param�tres. + <para> +Trois options de configuration sont fournies pour le contr�le des caches qui +sont compatibles avec HTTP/1.1. <literal/No-Cache/ signifie que le mandataire +ne doit pas du tout utiliser les r�ponses qu'il a stock�es ; <literal/Max-Age/ +sert uniquement pour les fichiers d'index : cela demande au cache de les +mettre � jour quand leur anciennet� est sup�rieure au nombre de secondes +donn�. Debian met � jour son fichier d'index de mani�re journali�re, la +valeur par d�faut est donc de 1 jour. <literal/No-Store/ sert uniquement +pour les fichiers d'archive : cela demande au cache de ne jamais garder +la requ�te. Cela peut �viter de polluer un cache mandataire avec des +fichiers .deb tr�s grands. Note : Squid 2.0.2 ne prend en compte aucune de +ces options. + <para> +L'option <literal/timeout/ positionne le compteur de temps mort (timeout) +utilis� par la m�thode : cela vaut pour tout (connexion, donn�es). + <para> +Une option de configuration est fournie pour contr�ler la profondeur du tube +pour le cas o� un serveur distant n'est pas conforme � la RFC ou est bogu� +(comme Squid 2.0.2). Acquire::http::Pipeline-Depth a une valeur +comprise entre 0 et 5 : elle indique le nombre de requ�tes en attente qui +peuvent �tre �mises. Quand la machine distante ne conserve pas correctement +les connexions TCP, on DOIT donner une valeur �gale � 0 -- sinon des +donn�es seront corrompues. Les machines qui ont besoin de cette option +ne respectent pas la RFC 2068. + </VarListEntry> + + <VarListEntry><Term>ftp</Term> + <ListItem><Para> +FTP URIs ; ftp::Proxy est le serveur mandataire par d�faut � utiliser. Il se +pr�sente sous la forme standard : +<literal>ftp://[[user][:pass]@]host[:port]/</> ; il est remplac� par la +variable d'environnement <envar/ftp_proxy/. Pour utiliser un mandataire ftp, +vous devez renseigner l'entr�e <literal/ftp::ProxyLogin/ dans le fichier de +configuration. Cette entr�e sp�cifie les commandes qui disent au serveur +mandataire comment se connecter. Voyez &configureindex; pour savoir +comment faire. Les variables de substitution disponibles sont : +<literal/$(PROXY_USER)/, <literal/$(PROXY_PASS)/, <literal/$(SITE_USER)/, +<literal/$(SITE_PASS)/, <literal/$(SITE)/, et <literal/$(SITE_PORT)/. +Chacune correspond � un �l�ment de l'URI. + <para> +L'option <literal/timeout/ positionne le compteur de temps mort (timeout) +utilis� par la m�thode : cela vaut pour tout (connexion, donn�es). + <para> +Plusieurs options de configuration sont fournies pour contr�ler le mode +passif. G�n�ralement, c'est plus s�r d'activer le mode passif ; cela marche +dans presque tous les environnements. Cependant, certaines situations +n�cessitent que le mode passif soit d�sactiv� et que le mode � port � de ftp +soit utilis� � la place. On peut le faire globalement, pour des +connexions qui passent par un mandataire ou pour une machine +sp�cifique (examinez le mod�le de fichier de configuration). + <para> +On peut utiliser un mandataire FTP pour atteindre une cible HTTP en +positionnant la variable d'environnement <envar/ftp_proxy/ � une url http -- +consultez la m�thode http ci-dessus pour la syntaxe. On ne peut pas fixer +cette variable dans le fichier de configuration et il n'est pas recommand� +d'utiliser HTTP par FTP � cause de son peu d'efficacit�. + <para> +L'option <literal/ForceExtended/ contr�le l'utilisation des commandes li�es +� la RFC 2428, <literal/EPSV/ et <literal/EPRT/. Par d�faut, elle vaut +� false � ; ce qui signifie que ces commandes ne sont utilis�es que pour une +connexion de type IPv6. Quand elle vaut � true �, on les utilise m�me si +la connexion est de type IPv4. La plupart des serveurs FTP ne suivent pas +la RFC 2428. + </VarListEntry> + + <VarListEntry><Term>cdrom</Term> + <ListItem><Para> +CDROM URIs ; la seule option de configuration pour les URIs de CDROM +est le point de montage : <literal/cdrom::Mount/ ; il doit repr�senter le +point de montage du lecteur de c�d�rom indiqu� dans <filename>/etc/fstab</>. +On peut fournir d'autres commandes de montage et de d�montage quand le +point de montage ne peut �tre list� dans le fichier <filename>/etc/fstab</> +(par exemple, un montage SMB ou ...). Syntaxiquement, il faut placer +<literallayout>"/cdrom/"::Mount "foo";</literallayout> dans le bloc cdrom. +La barre oblique finale est importante. Les commandes de d�montage +peuvent �tre sp�cifi�es en utilisant <literal/UMount/. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><Title>Les r�pertoires</> + <para> +Les r�pertoires de la section <literal/Dir::State/ concernent le syst�me +local. <literal/lists/ est le r�pertoire o� placer les listes de paquets +t�l�charg�s et <literal/status/ est le nom du fichier d'�tat de Dpkg. +<literal/preferences/ concerne APT : c'est le nom du fichier de pr�f�rence. +<literal/Dir::State/ contient le r�pertoire par d�faut pr�fix� � tous les +sous-�l�ments, quand ceux-ci ne commencent pas par <filename>/</> +ou <filename>./</>. + <para> +<literal/Dir::Cache/ contient les emplacements qui renseignent sur le +cache local : par exemple, les deux caches de paquets <literal/srcpkgcache/ +et <literal/pkgcache/ et aussi l'endroit o� sont plac�es les archives +t�l�charg�es, <literal/Dir::Cache::archives/. On peut emp�cher la cr�ation +des caches en laissant leur nom en blanc. Cela ralentit le d�marrage mais +cela sauve de l'espace disque. Il vaut mieux se passer du cache +<literal/pkgcache/ plut�t que celui de <literal/srcpkgcache/. Comme pour +<literal/Dir::State/, le r�pertoire par d�faut est contenu dans +<literal/Dir::Cache/. + <para> +<literal/Dir::Etc/ contient l'emplacement des fichiers de configuration, +<literal/sourcelist/ indique l'emplacement de la liste de sources et +<literal/main/ est le fichier de configuration par d�faut (le modifier +n'a aucun effet, � moins qu'on ne le modifie avec le fichier de +configuration indiqu� par la variable <envar/APT_CONFIG/). + <para> +<literal/Dir::Parts/ lit, par ordre d'entr�e, tous les fragments de +configuration dans le r�pertoire indiqu�. Ensuite, le fichier principal +de configuration est charg�. + <para> +Les programmes binaires sont point�s par <literal/Dir::Bin/. +L'emplacement des gestionnaires de m�thodes est indiqu� par +<literal/methods/ ; <literal/gzip/, <literal/Dpkg/, <literal/apt-get/, +<literal/dpkg-source/, <literal/dpkg-buildpackage/ et <literal/apt-cache/ +indiquent l'emplacement des programmes correspondants. + </RefSect1> + + <RefSect1><Title>APT et DSelect</> + <para> +Quand APT est utilis� comme une m�thode de &dselect;, plusieurs directives +contr�lent le comportement par d�faut. On les trouve dans la section +<literal/DSelect/. + + <VariableList> + <VarListEntry><Term>Clean</Term> + <ListItem><Para> +Mode de nettoyage du cache ; cette variable peut prendre l'une des valeurs +suivantes : � always �, � prompt �, � auto �, � pre-auto � et � never �. +� always � et � prompt � suppriment tous les paquets du cache apr�s la mise � +niveau ; � prompt � (valeur par d�faut) les supprime apr�s une demande et +� auto � ne supprime que les archives qui ne peuvent plus �tre t�l�charg�es +(remplac�es, par exemple, par une nouvelle version). � pre-auto � les +supprime avant de r�cup�rer de nouveaux paquets. + </VarListEntry> + + <VarListEntry><Term>Options</Term> + <ListItem><Para> +Le contenu de cette variable est pass� � &apt-get; avec les options de la ligne +de commande quand ce programme est utilis� dans la phase d'installation. + </VarListEntry> + + <VarListEntry><Term>UpdateOptions</Term> + <ListItem><Para> +Le contenu de cette variable est pass� � &apt-get; avec les options de la +ligne de commande quand ce programme est utilis� dans la phase de mise � jour. + </VarListEntry> + + <VarListEntry><Term>PromptAfterUpdate</Term> + <ListItem><Para> +Si cette option est � vraie �, l'op�ration [U]pdate de &dselect; interroge +toujours l'utilisateur avant de continuer. Par d�faut, ce n'est qu'en cas +d'erreur que l'on propose � l'utilisateur d'intervenir. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><Title>Comment APT appelle Dpkg</> + <para> +Plusieurs directives de configuration contr�lent la mani�re dont APT +invoque &dpkg; : elles figurent dans la section <literal/DPkg/. + + <VariableList> + <VarListEntry><Term>Options</Term> + <ListItem><Para> +Il s'agit d'une liste d'options � passer � Dpkg. Les options doivent �tre +d�clar�es en utilisant la notation de liste et chaque �l�ment de liste est +pass� comme un seul argument � Dpkg. + </VarListEntry> + + <VarListEntry><Term>Pre-Invoke</Term><Term>Post-Invoke</Term> + <ListItem><Para> +Il s'agit d'une liste de commandes shell � ex�cuter avant ou apr�s l'appel de +&dpkg;. Tout comme pour <literal/Options/, on doit utiliser la notation de +liste. Les commandes sont appel�es dans l'ordre en utilisant /bin/sh : APT +s'arr�te d�s que l'une d'elles �choue. + </VarListEntry> + + <VarListEntry><Term>Pre-Install-Pkgs</Term> + <ListItem><Para> +Il s'agit d'une liste de commandes shell � ex�cuter avant d'appeler Dpkg. +Tout comme pour <literal/Options/, on doit utiliser la notation de liste. +Les commandes sont appel�es dans l'ordre en utilisant /bin/sh : APT s'arr�te +d�s que l'une d'elles �choue. Sur l'entr�e standard, APT transmet aux +commandes les noms de tous les fichiers .deb qu'il va installer, � raison d'un +par ligne. + <para> +La deuxi�me version de ce protocole donne plus de renseignements : on obtient +la version du protocole, la configuration de APT et les paquets, fichiers +ou versions qui ont chang�s. On autorise cette version en positionnant +<literal/DPkg::Tools::Options::cmd::Version/ � 2. <literal/cmd/ est une +commande pass�e � <literal/Pre-Install-Pkgs/. + </VarListEntry> + + <VarListEntry><Term>Run-Directory</Term> + <ListItem><Para> +APT se place dans ce r�pertoire avant d'appeler Dpkg ; par d�faut c'est le +r�pertoire <filename>/</>. + </VarListEntry> + + <VarListEntry><Term>Build-Options</Term> + <ListItem><Para> +Ces options sont pass�es � &dpkg-buildpackage; lors de la compilation des +paquets ; par d�faut la signature est d�sactiv�e et tous les binaires sont +cr��s. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><Title>Les options de d�bogage</> + <para> +La plupart des options de la section <literal/debug/ n'ont aucun int�r�t +pour le simple utilisateur ; cependant, <literal/Debug::pkgProblemResolver/ +affiche d'int�ressantes informations sur les d�cisions que prend la +commande dist-upgrade. <literal/Debug::NoLocking/ d�sactive le verrouillage +de fichier de mani�re � ce que APT puisse effectuer quelques op�rations sans +�tre � root � et <literal/Debug::pkgDPkgPM/ affiche la ligne de commande � +chaque appel de Dpkg. <literal/Debug::IdentCdrom/ d�sactive l'inclusion de +donn�es statfs dans les IDs de CDROM. + </RefSect1> + + <RefSect1><Title>Exemples</> + <para> + &configureindex; contient un mod�le de fichier montrant les valeurs par +d�faut de toutes les options possibles. + </RefSect1> + + <RefSect1><Title>Fichiers</> + <para> + <filename>/etc/apt/apt.conf</> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-cache;, &apt-config;, &apt-preferences;. + </RefSect1> + + &manbugs; + &manauthor; + &deux-traducteurs; + +</refentry> diff --git a/doc/fr/apt.ent.fr b/doc/fr/apt.ent.fr new file mode 100644 index 000000000..f11b97537 --- /dev/null +++ b/doc/fr/apt.ent.fr @@ -0,0 +1,173 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.7 --> +<!-- Some common paths.. --> +<!ENTITY docdir "/usr/share/doc/apt/"> +<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</>"> +<!ENTITY aptconfdir "<filename>/etc/apt.conf</>"> +<!ENTITY statedir "/var/lib/apt"> +<!ENTITY cachedir "/var/cache/apt"> + +<!-- Cross references to other man pages --> +<!ENTITY apt-conf "<CiteRefEntry> + <RefEntryTitle><filename/apt.conf/</RefEntryTitle> + <ManVolNum/5/ + </CiteRefEntry> +"> + +<!ENTITY apt-get "<CiteRefEntry> + <RefEntryTitle><command/apt-get/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry> +"> + +<!ENTITY apt-config "<CiteRefEntry> + <RefEntryTitle><command/apt-config/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry>"> + +<!ENTITY apt-cdrom "<CiteRefEntry> + <RefEntryTitle><command/apt-cdrom/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry> +"> + +<!ENTITY apt-cache "<CiteRefEntry> + <RefEntryTitle><command/apt-cache/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry> +"> + +<!ENTITY apt-preferences "<CiteRefEntry> + <RefEntryTitle><command/apt_preferences/</RefEntryTitle> + <ManVolNum/5/ + </CiteRefEntry>"> + +<!ENTITY sources-list "<CiteRefEntry> + <RefEntryTitle><filename/sources.list/</RefEntryTitle> + <ManVolNum/5/ + </CiteRefEntry> +"> + +<!ENTITY bug "<CiteRefEntry> + <RefEntryTitle><command/bug/</RefEntryTitle> + <ManVolNum/1/ + </CiteRefEntry> +"> + +<!ENTITY dpkg "<CiteRefEntry> + <RefEntryTitle><command/dpkg/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry> +"> + +<!ENTITY dpkg-buildpackage "<CiteRefEntry> + <RefEntryTitle><command/dpkg-buildpackage/</RefEntryTitle> + <ManVolNum/1/ + </CiteRefEntry> +"> + +<!ENTITY gzip "<CiteRefEntry> + <RefEntryTitle><command/gzip/</RefEntryTitle> + <ManVolNum/1/ + </CiteRefEntry> +"> + +<!ENTITY dpkg-scanpackages "<CiteRefEntry> + <RefEntryTitle><command/dpkg-scanpackages/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry> +"> + +<!ENTITY dpkg-scansources "<CiteRefEntry> + <RefEntryTitle><command/dpkg-scansources/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry> +"> + +<!ENTITY dselect "<CiteRefEntry> + <RefEntryTitle><command/dselect/</RefEntryTitle> + <ManVolNum/8/ + </CiteRefEntry>"> + +<!-- Boiler plate docinfo section --> +<!ENTITY apt-docinfo " + <docinfo> + <address><email>apt@packages.debian.org</></address> + <author><firstname>Jason</> <surname>Gunthorpe</></> + <copyright><year>1998-2001</> <holder>Jason Gunthorpe</></> + <date>12 March 2001</> + </docinfo> +"> + +<!-- Boiler plate Bug reporting section --> +<!ENTITY manbugs " + <RefSect1><Title>Bogues</> + <para> +Voyez la <ulink url='http://bugs.debian.org/apt'> page concernant les bogues de APT</>. + Si vous voulez rapporter un bogue, consultez le texte + <filename>/usr/share/doc/debian/bug-reporting.txt</> ou utilisez la +commande &bug;. + </RefSect1> +"> + +<!-- Boiler plate Author section --> +<!ENTITY manauthor " + <RefSect1><Title>Auteur</> + <para> + APT a �t� �crit par l'�quipe APT <email>apt@packages.debian.org</>. + </RefSect1> +"> + +<!-- Section traduction --> +<!ENTITY deux-traducteurs " +<RefSect1><Title>Traduction</> +<para> +J�r�me Marant. 2000 ; mise � jour : Philippe Batailler. 2001. +</RefSect1> +"> + +<!ENTITY traducteur " +<RefSect1><Title>Traduction</> +<para> +Philippe Batailler. 2001. +</RefSect1> +"> + +<!-- Should be used within the option section of the text to + put in the blurb about -h, -v, -c and -o --> +<!ENTITY apt-commonoptions " + <VarListEntry><term><option/-h/</><term><option/--help/</> + <ListItem><Para> +Affiche un mode d'emploi succinct. + </VarListEntry> + + <VarListEntry><term><option/-v/</><term><option/--version/</> + <ListItem><Para> +Affiche la version du programme. + </VarListEntry> + + <VarListEntry><term><option/-c/</><term><option/--config-file/</> + <ListItem><Para> +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; pour la syntaxe. + </VarListEntry> + + <VarListEntry><term><option/-o/</><term><option/--option/</> + <ListItem><Para> +Donne une option de configuration ; cela fixe une option de configuration +arbitraire. La syntaxe est : <option>-o Foo::Bar=bar</>. + </VarListEntry> +"> + +<!-- Should be used within the option section of the text to + put in the blurb about -h, -v, -c and -o --> +<!ENTITY apt-cmdblurb " + <para> +Toutes les options de 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 +<option/-f-/,<option/--no-f/, <option/-f=no/ ou d'autres variantes. + </para> +"> diff --git a/doc/fr/apt_preferences.5.fr.sgml b/doc/fr/apt_preferences.5.fr.sgml new file mode 100644 index 000000000..f910ef4f1 --- /dev/null +++ b/doc/fr/apt_preferences.5.fr.sgml @@ -0,0 +1,243 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.3 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt_preferences</> + <manvolnum>5</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt_preferences</> + <refpurpose>Un fichier de contr�le, utilis� par APT, indiquant des pr�f�rences</> + </refnamediv> + + <RefSect1><Title>Description</> + <para> +Le fichier des pr�f�rences contr�le diff�rents aspects du syst�me APT. Il est +con�u pour �tre modifiable par l'utilisateur et manipulable de fa�on +logicielle. Il comprend des enregistrements form�s sur le mod�le du fichier +<filename/status/ de Dpkg : des sections s�par�es par des espaces et des lignes +commen�ant par une �tiquette suivie d'un � : �. Il se trouve dans +<filename>/etc/apt/preferences</>. + </RefSect1> + + <RefSect1><Title>Questions de version</> + <para> +L'un des buts de ce fichier est de permettre � l'utilisateur de choisir +quelle version d'un paquet il veut installer. On peut faire ce choix de +plusieurs fa�ons mais il est bas� sur trois crit�res : la version, +l'�dition et l'origine. + <para> +Choisir la version peut se faire avec une recherche de correspondance sur une +cha�ne exacte ou bien sur une cha�ne pr�fix�e. Le format est : <literal/2.1.2/ +pour la premi�re et <literal/2.2*/ pour la seconde. L'utilisation d'un pr�fixe +permet d'ignorer le <literal/r/ du syst�me d'ordonnancement des �ditions +(<literal/2.1r*/), ou bien d'ignorer les r�visions propres � Debian +(<literal/1.1-*/). Quand on compare des versions en se servant d'un pr�fixe, +la version poss�dant le num�ro le plus �lev� est toujours choisie. + <para> +Choisir une �dition de la distribution est plus compliqu� et poss�de trois +formes. Le but principal du choix d'une �dition est d'identifier un ensemble de +paquets qui corresponde � un vendeur particulier ou � une �dition de la +distribution (p.ex. Debian 2.1). Les deux premi�res formes sont des raccourcis +pour une utilisation rapide en ligne de commande. Si le premier caract�re de +la cha�ne est un chiffre, c'est une recherche fond�e sur la version d'une +�dition ; sinon, c'est une recherche sur le nom d'une �dition. Quand la +cha�ne comporte des signes �gal, c'est une recherche fond�e sur une +description compl�te de l'�dition ; cette cha�ne est une liste de cl�s +(une seule lettre) suivies d'un mot et s�par�es par une virgule. Exemples : +<informalexample><programlisting> +v=2.1*,o=Debian,c=main +l=Debian +a=stable +</programlisting></informalexample> + <para> +Ces recherches utilisent des donn�es prises dans les fichiers +<filename/Release/ r�cup�r�s par APT pendant une mise � jour. Voici les +cl�s disponibles : + <VariableList> + <VarListEntry><term>a= Archive</term> + <ListItem><Para> +C'est le nom habituel donn� � nos archives, comme <literal/stable/ ou +<literal/unstable/. Le nom sp�cial <literal/now/ d�signe l'ensemble des +paquets install�s. + </VarListEntry> + + <VarListEntry><term>c= Composant</term> + <ListItem><Para> +Indique un sous-composant de l'archive, tel que <literal/main/, +<literal/contrib/, etc. Quand il n'y a pas de composant dans telle archive, +on peut l'omettre. + </VarListEntry> + + <VarListEntry><term>v= Version</term> + <ListItem><Para> +C'est la cha�ne repr�sentant la version ; elle poss�de les m�mes +caract�ristiques que celle du fichier <filename/Packages/. C'est le niveau +�dition de l'archive. Les num�ros d'une �dition classique de la distribution +Debian ressemblent � <literal/2.1r2/ o� le r d�signe une �dition (release) de +la distribution 2.1. Les nouvelles �ditions sont limit�es � des mises � +jour concernant la s�curit�. + </VarListEntry> + + <VarListEntry><term>o= Origine</term> + <ListItem><Para> +Ce terme indique qui a fourni l'archive. Pour Debian, c'est <literal/Debian/. +Les autres fournisseurs peuvent utiliser leur propre nom. + </VarListEntry> + + <VarListEntry><term><term>l= Label</term> + <ListItem><Para> +Cela donne le nom g�n�ral de la distribution. Pour Debian, c'est +<literal/Debian/. Pour des distributions d�riv�es, ce terme doit �tre leur +propre nom. + </VarListEntry> + </VariableList> + <para> +La derni�re m�thode est le choix de l'origine. C'est simplement le nom du site +d'o� proviennent les paquets. Une cha�ne vide indique un URI de fichier. + <para> +Le choix d'une version, et en particulier les deux derni�res m�thodes, +concerne plusieurs parties d'APT, pas seulement le fichier pr�f�rences. + </RefSect1> + +<RefSect1><Title>R�gles pour le choix d'une version</> + <para> +APT conserve une liste de toutes les versions disponibles de tous les +paquets. Quand on indique plusieurs �ditions ou vendeurs dans le fichier +&sources-list;, tous ces �l�ments sont disponibles. APT choisit par d�faut +la version la plus r�cente parmi toutes ces sources automatiques. Quelques +sources sont �tiquet�es Non Automatique, p.ex. +<filename>project/experimental</> -- elles sont mises en bas de la pile de +s�lection. + <para> +Pour d�cider quelle version utiliser, APT affecte une priorit� � toutes les +versions disponibles d'un paquet. Puis il fait deux choses. Premi�rement : +il choisit, parmi les versions plus r�centes que la version install�e, la +version qui poss�de la plus haute priorit� ; ensuite il choisit, parmi +les versions plus anciennes que la version install�e, celle qui poss�de la +plus haute priorit�. Deuxi�mement : si les versions plus anciennes ont +une priorit� sup�rieure � 1000, il les compare avec la priorit� que poss�de +l'ensemble de mise � niveau : la plus grande est choisie. Autrement, les +versions provoquant une r�gression sont ignor�es et il choisit la plus grande +priorit� de l'ensemble de mise � niveau. + <para> +On peut penser le syst�me de priorit� en termes de strates : + <VariableList> + <VarListEntry><term>1000 et au-dessus</term> + <ListItem><Para> +Priorit�s permettant la r�gression + </VarListEntry> + + <VarListEntry><term>1000</term> + <ListItem><Para> +La barri�re pour emp�cher la r�gression. + </VarListEntry> + + <VarListEntry><term>de 100 � 1000</term> + <ListItem><Para> +Priorit�s standards. 990 est la priorit� d�finie par l'option +<option/--target-release / du programme &apt-get;. 989 est le d�but des +priorit�s automatiques et 500 la priorit� par d�faut des fichiers d'un paquet. + </VarListEntry> + + <VarListEntry><term>100</term> + <ListItem><Para> +Priorit� de la version actuellement install�e. + </VarListEntry> + + <VarListEntry><term>de 0 � 100</term> + <ListItem><Para> +Priorit�s non automatiques. On s'en sert uniquement si le paquet n'est pas +install� et s'il n'y a pas d'autre version disponible. + </VarListEntry> + + <VarListEntry><term>inf�rieur � 0</term> + <ListItem><Para> +Priorit� pour une version qui ne sera jamais s�lectionn�e. + </VarListEntry> + </VariableList> + <para> +Une priorit� sup�rieure � 1000 donn�e � une �tiquette (pin) autorise une +r�gression vers cette version. + <para> +On peut accrocher une �tiquette � chaque paquet et chaque fichier +<filename/Packages/ poss�de une priorit� pour tous les paquets. La plus +haute priorit� affect�e � un paquet est celle qui est utilis�e. + <para> +Une �tiquette de paquet est de cette forme : +<informalexample><programlisting> +Package: apt +Pin: version 0.4.0 +Pin-Priority: 1001 +</programlisting></informalexample> +La premi�re ligne indique le paquet, la seconde donne le nom de l'�tiquette +et la derni�re la priorit� pour cette �tiquette. Le premier mot du nom de +l'�tiquette peut �tre : version, release ou origin ; le reste du +champ est d�crit plus haut dans la section � R�gles pour le choix d'une +version �. + <para> +Une �tiquette par d�faut repr�sente comment sont d�finies les priorit�s des +fichiers d'un paquet. On peut sp�cifier autant d'�tiquette par d�faut qu'on +veut ; la premi�re correspondant au d�faut s�lectionne la priorit� pour +les fichiers d'un paquet. Seuls � release � et � origin � +peuvent �tre utilis�s dans le nom de l'�tiquette puisqu'ils correspondent aux +fichiers <filename/Packages/. +<informalexample><programlisting> +Package: * +Pin: release v=2.1* +Pin-Priority: 998 +</programlisting></informalexample> + <para> +Quand le champ Pin-Priority manque, la priorit� est par d�faut de 989 +dans les deux cas. + + <RefSect2><title>Effets notables</> + <para> +� cause de la barri�re emp�chant les r�gressions (priorit� 1000), il est +possible qu'une version poss�dant une priorit� inf�rieure soit choisie si +une version poss�dant une priorit� sup�rieure provoque une r�gression. Par +exemple, le paquet foo poss�de les versions <literal/1.2/, <literal/1.1/ +et <literal/1.0/ ; <literal/1.1/ est la version install�e ; les +priorit�s de chaque version sont : 900, 100 et 950 respectivement : +la version <literal/1.2/ sera install�e. + <para> +Dans la pratique, c'est ce qu'on veut ! Un utilisateur utilisera une +�tiquette par d�faut pour rendre la distribution � stable � la +distribution par d�faut ; il utilisera ensuite l'option +<option/--target-dist/ avec &apt-get; pour choisir de nouvelles versions dans +� unstable �. Les paquets mis � niveau avec � unstable � +suivront les versions disponibles dans � unstable � puisque les +versions de � stable � sont maintenant pass�es +sous la barri�re emp�chant la r�gression. + <para> +Si on ne le veut pas, on doit utiliser une �tiquette par d�faut qui donne +� � unstable � une priorit� inf�rieure � 100. + <para> +Ceux qui utilisent des suppl�ments venant de tiers comme Helix GNOME peuvent +se servir de ce proc�d� pour obtenir des paquets Helix ; ils peuvent +forcer l'utilisation des paquets Debian en d�finissant la priorit� de cette +source suffisamment haut. On peut m�me r�aliser une r�gression massive d'un +ensemble de paquets � un autre en utilisant une priorit� sup�rieure � 1000. + </RefSect2> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-cache; &apt-conf; + </RefSect1> + + &manbugs; + &manauthor; +&traducteur; +</refentry> diff --git a/doc/fr/sources.list.5.fr.sgml b/doc/fr/sources.list.5.fr.sgml new file mode 100644 index 000000000..791beeed9 --- /dev/null +++ b/doc/fr/sources.list.5.fr.sgml @@ -0,0 +1,207 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.2 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>sources.list</> + <manvolnum>5</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>sources.list</> + <refpurpose>Une liste, utilis�e par APT, indiquant les ressources de paquets</> + </refnamediv> + + <RefSect1><Title>Description</> + <para> +La liste des ressources de paquets indique o� trouver les archives +du syst�me de distribution de paquets utilis�. Pour l'instant, cette page +de manuel ne documente que le syst�me d'empaquetage utilis� par le syst�me +Debian GNU-Linux. Ce fichier de contr�le est situ� dans +<filename>/etc/apt/sources.list</>. + <para> +La liste des sources est con�ue pour prendre en compte un nombre quelconque +de sources actives et diff�rents m�dia source. Le fichier pr�sente +une source par ligne et la source pr�f�r�e appara�t en premier. Le format de +chaque ligne est : <literal/type uri args/. Le premier �l�ment, +<literal/type/, d�termine le format des <literal/args/. <literal/uri/ est un +identificateur universel de ressources (URI), qui est un surensemble du plus +sp�cifique et bien connu rep�re universel de ressources, ou URL. La fin de la +ligne peut �tre un commentaire commen�ant par un caract�re #. + </RefSect1> + + <RefSect1><Title>Les types deb et deb-src.</> + <para> +Le type <literal/deb/ d�crit une archive Debian classique � deux niveaux, +<filename>distribution/composant</>. <literal/distribution/ peut prendre +l'une des valeurs suivantes : <literal/stable/, <literal/unstable/, ou +<literal/frozen/, et composant : <literal/main/, <literal/contrib/, +<literal/non-free/, ou <literal/non-us/. Le type <literal/deb-src/ d�crit le +code source pour une distribution Debian dans le m�me format que le type +<literal/deb/. Une ligne <literal/deb-src/ est n�cessaire pour r�cup�rer les +index de sources. +<para> +Le format d'une entr�e dans <filename/sources.list/ utilisant les types +<literal/deb/ et <literal/deb-src/ est de la forme : + <literallayout>deb uri distribution [composant1] [composant2] [...]</literallayout> + <para> +L'URI de type <literal/deb/ doit indiquer la base de la distribution Debian +dans laquelle APT trouvera les informations dont il a besoin. +<literal/distribution/ peut sp�cifier le chemin exact : dans ce cas, on +doit omettre les composants et <literal/distribution/ doit se terminer par une +barre oblique (/). C'est utile quand seule une sous-section particuli�re de +l'archive d�crite par cet URI est int�ressante. Quand <literal/distribution/ +n'indique pas un chemin exact, un <literal/component/ au moins doit �tre +pr�sent. + <para> +<literal/distribution/ peut aussi contenir une variable <literal/$(ARCH)/, +qui sera remplac�e par l'architecture Debian (i386, m68k, powerpc, ...) +sur laquelle s'ex�cute le syst�me. On peut ainsi utiliser un fichier +<filename/sources.list/ qui ne d�pend pas d'une architecture. En g�n�ral, +ce n'est int�ressant que si l'on indique un chemin exact ; sinon +<literal/APT/ cr�e automatiquement un URI en fonction de l'architecture +effective. + <para> +Puisqu'on ne peut indiquer qu'une seule distribution par ligne, il peut �tre +n�cessaire de disposer le m�me URI sur plusieurs lignes quand on veut +acc�der � un sous-ensemble des distributions ou composants disponibles � cette +adresse. APT trie les URIs apr�s avoir cr�e pour lui-m�me la liste +compl�te ; il regroupe les r�f�rences multiples au m�me h�te Internet +en vue d'une connexion unique et il �vite ainsi, par exemple, d'�tablir une +connexion FTP, de la fermer, faire autre chose, puis d'�tablir encore cette +connexion. Cette fonctionnalit� permet l'acc�s � des sites FTP surcharg�s qui +limitent le nombre de connexions simultan�es pour les utilisateurs anonymes. +APT parall�lise aussi les connexions � diff�rents h�tes pour tirer plus +efficacement parti des sites � faible bande passante. + <para> +Il est important d'indiquer les sources par ordre de pr�f�rence, +la source principale apparaissant en premier. Un tri est fait, de la plus +rapide � la plus lente ; par exemple, CD-ROM suivi par les h�tes d'un +r�seau local, puis les h�tes Internet distants. + <para> +Quelques exemples : + <literallayout> +deb http://http.us.debian.org/debian stable main contrib non-free +deb http://http.us.debian.org/debian dists/stable-updates/ + </literallayout> + </RefSect1> + + <RefSect1><title>La sp�cification des URIs</title> + <para> +Les URIs actuellement reconnus sont : cdrom, file, http et ftp. + <VariableList> + <VarListEntry><term>file</term> + <ListItem><Para> +Le proc�d� <literal/file/ permet qu'un r�pertoire arbitraire au sein du +syst�me de fichier soit consid�r� comme une archive. On s'en sert avec les +montages NFS, les miroirs et archives locaux. + </VarListEntry> + + <VarListEntry><term>cdrom</term> + <ListItem><Para> +Le proc�d� <literal/cdrom/ permet l'utilisation d'un lecteur de CDROM local +avec la possibilit� de changer de media. Utilisez le programme &apt-cdrom; +pour cr�er des entr�es dans la liste de sources. + </VarListEntry> + + <VarListEntry><term>http</term> + <ListItem><Para> +Le proc�d� <literal/http/ indique un serveur HTTP comme archive. Si une +variable d'environnement <EnVar/http_proxy/ (au format http://server:port/) +existe, le serveur mandataire indiqu� par <EnVar/http_proxy/ est utilis�. +Quand un serveur mandataire HTTP/1.1 demande une authentification, on peut +utiliser la cha�ne http://user:pass@server:port/. Notez qu'il s'agit d'une +m�thode d'authentification peu s�re. + </VarListEntry> + + <VarListEntry><term>ftp</term> + <ListItem><Para> +Le proc�d� <literal/ftp/ indique un serveur FTP comme archive. Le +fonctionnement en mode ftp est grandement configurable ; r�f�rez-vous +� la page de manuel de &apt-conf; pour davantage de renseignements. On +remarquera qu'on peut indiquer un mandataire ftp avec la variable +d'environnement <EnVar/ftp_proxy/. On peut aussi sp�cifier un mandataire http +(les serveurs mandataires http comprennent souvent les URLs ftp) en utilisant +cette m�thode et SEULEMENT cette m�thode. Les mandataires ftp utilisant http +et qui sont sp�cifi�s dans le fichier de configuration seront ignor�s. + </VarListEntry> + + <VarListEntry><term>copy</term> + <ListItem><Para> +Le proc�d� <literal/copy/ est identique au proc�d� <literal/file/ except� que +les paquets sont copi�s dans le cache du r�pertoire au lieu d'�tre utilis�s +directement depuis leur emplacement. C'est utile aux gens qui utilisent un +disque zip pour recopier des fichiers un peu partout via APT. + </VarListEntry> + + <VarListEntry><term>rsh</term><term>ssh</term> + <ListItem><Para> +Le proc�d� <literal/rsh/ssh/ utilise rsh/ssh pour se connecter � une +machine distante en tant que tel utilisateur donn� et pour acc�der aux +fichiers. Aucune authentification par mot de passe n'est possible : il +faut au pr�alable r�gler ce probl�me avec des cl�s RSA ou bien rhosts. Pour +l'acc�s aux fichiers de la machine distante et le transfert, on utilise les +commandes standards <command/find/ et <command/dd/. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><title>Exemples</title> + <para> +Utiliser l'archive stock�e localement (ou mont�e via NFS) dans +/home/jason/debian pour stable/main, stable/contrib et stable/non-free. + <literallayout>deb file:/home/jason/debian stable main contrib non-free</literallayout> + <para> +Comme ci-dessus, except� que cette ligne utilise la distribution +� unstable � (d�veloppement). + <literallayout>deb file:/home/jason/debian unstable main contrib non-free</literallayout> + <para> +La pr�c�dente ligne, mais pour les sources. + <literallayout>deb-src file:/home/jason/debian unstable main contrib non-free</literallayout> + <para> +Utiliser HTTP pour acc�der � l'archive situ�e � archive.debian.org, et +n'utiliser que la section hamm/main. + <literallayout>deb http://archive.debian.org/debian-archive hamm main</literallayout> + <para> +Utiliser FTP pour acc�der � l'archive situ�e � ftp.debian.org, dans le +r�pertoire debian, et n'utiliser que la section stable/contrib. + <literallayout>deb ftp://ftp.debian.org/debian stable contrib</literallayout> + <para> +Utiliser FTP pour acc�der � l'archive situ�e � ftp.debian.org, dans le +r�pertoire debian, et n'utiliser que la section unstable/contrib. Si cette +ligne et celle de l'exemple pr�c�dent dans <filename/sources.list/ +apparaissent, une seule session FTP sera utilis�e pour les deux lignes. + <literallayout>deb ftp://ftp.debian.org/debian unstable contrib</literallayout> + <para> +Utiliser HTTP pour acc�der � l'archive situ�e � nonus.debian.org, dans le +r�pertoire debian-non-US. + <literallayout>deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free</literallayout> + <para> +Utiliser HTTP pour acc�der � l'archive situ�e � nonus.debian.org, dans le +r�pertoire debian-non-US, et n'utiliser que les fichiers trouv�s dans +<filename>unstable/binary-i386</> pour les machines i386, dans +<filename>unstable/binary-m68k</> pour les machines m68k et ainsi de suite +pour les autres architectures support�es. [Notez que cet exemple montre +seulement la mani�re d'utiliser la variable � substituer, non-us n'�tant plus +structur� comme suit.] + <literallayout>deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/</literallayout> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-cache; &apt-conf; + </RefSect1> + + &manbugs; + &manauthor; + &deux-traducteurs; +</refentry> |