<?xml version="1.0" encoding="iso-8859-15" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!ENTITY % aptent SYSTEM "apt.ent.fr">
%aptent;

]>

<refentry lang="fr">

 <refentryinfo>
   &apt-author.jgunthorpe;
   &apt-author.team;
   &apt-email;
   &apt-product;
   <!-- The last update date -->
   <date>29 February 2004</date>
 </refentryinfo>

<refmeta>
<refentrytitle>sources.list</refentrytitle>
<manvolnum>5</manvolnum>
</refmeta>

<refnamediv>
<refname>sources.list</refname>
<refpurpose>Liste des sources de paquets</refpurpose>
</refnamediv>

<refsect1><title>Description</title>
<para>   
La liste des sources 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 <filename>/etc/apt/sources.list</filename>.
   </para>
<para>
La liste des sources est con�ue pour prendre en compte un nombre quelconque
de sources actives et diff�rents m�dia. 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&nbsp;: <literal>type uri args</literal>. Le premier �l�ment, 
<literal>type</literal>, d�termine le format des <literal>args</literal>. 
<literal>uri</literal>  est un 
identificateur universel de ressources (URI), qui est un sur-ensemble 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 #. 
 </para>
</refsect1>

<refsect1><title>sources.list.d</title>
<para> Le r�pertoire <filename>/etc/apt/sources.list.d</filename> permet de
lister des sources de paquets dans des fichiers distincts qui se terminent
par <literal>.list</literal>. Leur format est le m�me que celui du fichier
<filename>sources.list</filename>. 
</para>
  </refsect1>

<refsect1><title>Les types deb et deb-src.</title>
<para>   
Le type <literal>deb</literal> d�crit une archive Debian classique � deux niveaux,
<filename>distribution/composant</filename>. <literal>distribution</literal> peut prendre
l'une des valeurs suivantes&nbsp;: <literal>stable</literal>, <literal>unstable</literal>, ou 
<literal>testing</literal>, et composant&nbsp;: <literal>main</literal>, 
<literal>contrib</literal>, 
<literal>non-free</literal>, ou <literal>non-us</literal>. 
Le type <literal>deb-src</literal> d�crit le
code source pour une distribution Debian dans le m�me format que le type
<literal>deb</literal>. Une ligne <literal>deb-src</literal> est n�cessaire pour r�cup�rer les
index des sources.
</para>
<para>
Le format d'une entr�e dans <filename>sources.list</filename> utilisant les types 
<literal>deb</literal> et <literal>deb-src</literal> est de la forme&nbsp;:
</para>
 <literallayout>deb uri distribution [composant1] [composant2] [...]</literallayout>
   <para>
L'URI de type <literal>deb</literal> doit indiquer la base de la distribution Debian
dans laquelle APT trouvera les informations dont il a besoin. 
<literal>distribution</literal> peut sp�cifier le chemin exact&nbsp;: dans ce cas, on 
doit omettre les composants et <literal>distribution</literal> 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</literal>
n'indique pas un chemin exact, un <literal>composant</literal> au moins doit �tre 
pr�sent.
   </para>
<para>
<literal>distribution</literal> peut aussi contenir une variable <literal>$(ARCH)</literal>,
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</filename> 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&nbsp;; sinon 
<literal>APT</literal> cr�e automatiquement un URI en fonction de l'architecture 
effective.
   </para>
<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 URI apr�s avoir cr�e pour lui-m�me la liste 
compl�te&nbsp;; 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>
<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&nbsp;; par exemple, un c�d�rom suivi par les h�tes d'un 
r�seau local, puis les h�tes distants.
   </para>
<para>Voici quelques exemples&nbsp;:
</para>

   <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 URI</title>
<para>
Les URI actuellement reconnus sont&nbsp;: cdrom, file, http et ftp.
   <variablelist>
<varlistentry><term>file</term>
<listitem><para>
Le proc�d� <literal>file</literal> 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 les archives locaux.
    </para></listitem>
</varlistentry>

<varlistentry><term>cdrom</term>
<listitem><para>
Le proc�d� <literal>cdrom</literal> permet l'utilisation d'un lecteur de c�d�rom 
avec la possibilit� de changer de media. Utilisez le programme &apt-cdrom; 
pour cr�er des entr�es dans la liste des sources.
</para>
</listitem>
</varlistentry>

<varlistentry><term>http</term>
<listitem><para>
Le proc�d� <literal>http</literal> indique un serveur HTTP comme archive. Si une 
variable d'environnement <envar>http_proxy</envar> (au format http://server:port/) 
existe, le serveur mandataire indiqu� par <envar>http_proxy</envar> 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.
    </para>
</listitem>
</varlistentry>

<varlistentry><term>ftp</term>
<listitem><para>
Le proc�d� <literal>ftp</literal> indique un serveur FTP comme archive. Le 
fonctionnement en mode ftp est largement configurable&nbsp;; r�f�rez-vous 
� la page de manuel de &apt-cdrom; pour d'autres informations. On 
remarquera qu'on peut indiquer un mandataire ftp avec la variable 
d'environnement <envar>ftp_proxy</envar>. On peut aussi sp�cifier un mandataire http 
(les serveurs mandataires http comprennent souvent les URL 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.
    </para>
</listitem>
</varlistentry>

<varlistentry><term>copy</term>
<listitem><para>
Le proc�d� <literal>copy</literal> est identique au proc�d� <literal>file</literal> 
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 avec APT.
    </para></listitem>
</varlistentry>

<varlistentry><term>rsh</term><term>ssh</term>
<listitem><para>
Le proc�d� 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&nbsp;: 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 standard <command>find</command> et <command>dd</command>.
    </para></listitem>
</varlistentry>
</variablelist>
 </para>
</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.
</para>
   <literallayout>deb file:/home/jason/debian stable main contrib non-free</literallayout>
   
<para>
Comme ci-dessus, except� que cette ligne utilise la distribution
�&nbsp;unstable&nbsp;� (d�veloppement).
</para>
   <literallayout>deb file:/home/jason/debian unstable main contrib non-free</literallayout>
   
<para>
La pr�c�dente ligne, mais pour les sources.
   </para>
<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.
</para>
   <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.
</para>
   <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</filename> 
apparaissent, une seule session FTP sera utilis�e pour les deux lignes.
</para>
   <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.
</para>
   <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</filename> pour les machines i386, dans
<filename>unstable/binary-m68k</filename> pour les machines m68k et ainsi de suite
pour les autres architectures reconnues. [Notez que cet exemple montre 
seulement la mani�re d'utiliser la variable � substituer, non-us n'�tant plus 
structur� de cette mani�re.]
</para>
   <literallayout>deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/</literallayout>
 </refsect1>

<refsect1><title>Voir aussi</title>
<para>&apt-cache; &apt-conf;
   </para>
 </refsect1>
&manbugs;
&traducteur;
</refentry>