1 .\" Title: sources.list
2 .\" Author: Jason Gunthorpe
3 .\" Generator: DocBook XSL Stylesheets v1.71.0 <http://docbook.sf.net/>
4 .\" Date: 29 February 2004
8 .TH "SOURCES.LIST" "5" "29 February 2004" "Linux" ""
9 .\" disable hyphenation
11 .\" disable justification (adjust text to left margin only)
14 sources.list \- Liste des sources de paquets
17 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
18 \fI/etc/apt/sources.list\fR.
20 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\ :
21 type uri args. Le premier élément,
22 type, détermine le format des
25 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 #.
29 \fI/etc/apt/sources.list.d\fR
30 permet de lister des sources de paquets dans des fichiers distincts qui se terminent par
31 .list. Leur format est le même que celui du fichier
33 .SH "LES TYPES DEB ET DEB\-SRC."
37 décrit une archive Debian classique à deux niveaux,
38 \fIdistribution/composant\fR.
40 peut prendre l'une des valeurs suivantes\ :
43 testing, et composant\ :
49 décrit le code source pour une distribution Debian dans le même format que le type
52 est nécessaire pour récupérer les index des sources.
54 Le format d'une entrée dans
64 deb uri distribution [composant1] [composant2] [...]
70 doit indiquer la base de la distribution Debian dans laquelle APT trouvera les informations dont il a besoin.
72 peut spécifier le chemin exact\ : dans ce cas, on doit omettre les composants et
74 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
76 n'indique pas un chemin exact, un
78 au moins doit être présent.
82 peut aussi contenir une variable
83 $(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
85 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
87 crée automatiquement un URI en fonction de l'architecture effective.
89 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.
91 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.
93 Voici quelques exemples\ :
97 deb http://http.us.debian.org/debian stable main contrib non\-free
98 deb http://http.us.debian.org/debian dists/stable\-updates/
102 .SH "LA SPÉCIFICATION DES URI"
104 Les URI actuellement reconnus sont\ : cdrom, file, http et ftp.
110 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.
117 permet l'utilisation d'un lecteur de cédérom avec la possibilité de changer de media. Utilisez le programme
119 pour créer des entrées dans la liste des sources.
126 indique un serveur HTTP comme archive. Si une variable d'environnement
128 (au format http://server:port/) existe, le serveur mandataire indiqué par
130 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.
137 indique un serveur FTP comme archive. Le fonctionnement en mode ftp est largement configurable\ ; référez\-vous à la page de manuel de
139 pour d'autres informations. On remarquera qu'on peut indiquer un mandataire ftp avec la variable d'environnement
140 \fBftp_proxy\fR. 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.
147 est identique au procédé
149 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.
154 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
161 Utiliser l'archive stockée localement (ou montée via NFS) dans /home/jason/debian pour stable/main, stable/contrib et stable/non\-free.
165 deb file:/home/jason/debian stable main contrib non\-free
169 Comme ci\-dessus, excepté que cette ligne utilise la distribution \(Fo\ unstable\ \(Fc (développement).
173 deb file:/home/jason/debian unstable main contrib non\-free
177 La précédente ligne, mais pour les sources.
181 deb\-src file:/home/jason/debian unstable main contrib non\-free
185 Utiliser HTTP pour accéder à l'archive située à archive.debian.org, et n'utiliser que la section hamm/main.
189 deb http://archive.debian.org/debian\-archive hamm main
193 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.
197 deb ftp://ftp.debian.org/debian stable contrib
201 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
203 apparaissent, une seule session FTP sera utilisée pour les deux lignes.
207 deb ftp://ftp.debian.org/debian unstable contrib
211 Utiliser HTTP pour accéder à l'archive située à nonus.debian.org, dans le répertoire debian\-non\-US.
215 deb http://nonus.debian.org/debian\-non\-US stable/non\-US main contrib non\-free
219 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
220 \fIunstable/binary\-i386\fR
221 pour les machines i386, dans
222 \fIunstable/binary\-m68k\fR
223 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.]
227 deb http://ftp.de.debian.org/debian\-non\-US unstable/binary\-$(ARCH)/
237 [1]\&\fI page concernant les bogues d'APT\fR. Si vous voulez signaler un bogue, consultez le texte
238 \fI/usr/share/doc/debian/bug\-reporting.txt\fR
239 ou utilisez la commande
244 <debian\-l10n\-french@lists.debian.org>. 2005.
247 \fBJason Gunthorpe\fR
258 1.\ page concernant les bogues d'APT
259 \%http://bugs.debian.org/src:apt