<?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 : <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 : <literal>stable</literal>, <literal>unstable</literal>, ou <literal>testing</literal>, et composant : <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 : </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 : 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 ; 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 ; 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 ; 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 : </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 : 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 ; 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 : 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 � unstable � (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>