<!-- -*- 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 : <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 : <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 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> 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> Voici 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 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/ 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 ; 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 : 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 � 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� 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>