<!-- -*- 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>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. 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/. 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 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 #. 
 </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&nbsp;: <literal/stable/, <literal/unstable/, ou 
<literal/frozen/, et composant&nbsp;: <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&nbsp;:
   <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&nbsp;: 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&nbsp;; 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 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>
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, CD-ROM suivi par les h�tes d'un 
r�seau local, puis les h�tes Internet distants.
   <para>
Voici quelques exemples&nbsp;:
   <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/ 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.
    </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&nbsp;; 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� 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/ 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
�&nbsp;unstable&nbsp� (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� de cette mani�re.]
   <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>