1
<!-- -*- mode: sgml; mode: fold -*- -->
2
<!-- translation of version 1.5 -->
3
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
5
<!ENTITY % aptent SYSTEM "apt.ent.fr">
14
<refentrytitle>sources.list</>
18
<!-- Man page title -->
20
<refname>sources.list</>
21
<refpurpose>Une liste, utilis�e par APT, indiquant les ressources de paquets</>
24
<RefSect1><Title>Description</>
26
La liste des ressources de paquets indique o� trouver les archives
27
du syst�me de distribution de paquets utilis�. Pour l'instant, cette page
28
de manuel ne documente que le syst�me d'empaquetage utilis� par le syst�me
29
Debian GNU/Linux. Ce fichier de contr�le est situ� dans
30
<filename>/etc/apt/sources.list</>.
32
La liste des sources est con�ue pour prendre en compte un nombre quelconque
33
de sources actives et diff�rents m�dia. Le fichier pr�sente
34
une source par ligne et la source pr�f�r�e appara�t en premier. Le format de
35
chaque ligne est : <literal/type uri args/. Le premier �l�ment,
36
<literal/type/, d�termine le format des <literal/args/. <literal/uri/ est un
37
identificateur universel de ressources (URI), qui est un sur-ensemble du plus
38
sp�cifique et bien connu rep�re universel de ressources, ou URL. La fin de la
39
ligne peut �tre un commentaire commen�ant par un caract�re #.
42
<RefSect1><Title>Les types deb et deb-src.</>
44
Le type <literal/deb/ d�crit une archive Debian classique � deux niveaux,
45
<filename>distribution/composant</>. <literal/distribution/ peut prendre
46
l'une des valeurs suivantes : <literal/stable/, <literal/unstable/, ou
47
<literal/frozen/, et composant : <literal/main/, <literal/contrib/,
48
<literal/non-free/, ou <literal/non-us/. Le type <literal/deb-src/ d�crit le
49
code source pour une distribution Debian dans le m�me format que le type
50
<literal/deb/. Une ligne <literal/deb-src/ est n�cessaire pour r�cup�rer les
53
Le format d'une entr�e dans <filename/sources.list/ utilisant les types
54
<literal/deb/ et <literal/deb-src/ est de la forme :
55
<literallayout>deb uri distribution [composant1] [composant2] [...]</literallayout>
57
L'URI de type <literal/deb/ doit indiquer la base de la distribution Debian
58
dans laquelle APT trouvera les informations dont il a besoin.
59
<literal/distribution/ peut sp�cifier le chemin exact : dans ce cas, on
60
doit omettre les composants et <literal/distribution/ doit se terminer par une
61
barre oblique (/). C'est utile quand seule une sous-section particuli�re de
62
l'archive d�crite par cet URI est int�ressante. Quand <literal/distribution/
63
n'indique pas un chemin exact, un <literal/component/ au moins doit �tre
66
<literal/distribution/ peut aussi contenir une variable <literal/$(ARCH)/,
67
qui sera remplac�e par l'architecture Debian (i386, m68k, powerpc, ...)
68
sur laquelle s'ex�cute le syst�me. On peut ainsi utiliser un fichier
69
<filename/sources.list/ qui ne d�pend pas d'une architecture. En g�n�ral,
70
ce n'est int�ressant que si l'on indique un chemin exact ; sinon
71
<literal/APT/ cr�e automatiquement un URI en fonction de l'architecture
74
Puisqu'on ne peut indiquer qu'une seule distribution par ligne, il peut �tre
75
n�cessaire de disposer le m�me URI sur plusieurs lignes quand on veut
76
acc�der � un sous-ensemble des distributions ou composants disponibles � cette
77
adresse. APT trie les URI apr�s avoir cr�e pour lui-m�me la liste
78
compl�te ; il regroupe les r�f�rences multiples au m�me h�te Internet
79
en vue d'une connexion unique et il �vite ainsi, par exemple, d'�tablir une
80
connexion FTP, de la fermer, faire autre chose, puis d'�tablir encore cette
81
connexion. Cette fonctionnalit� permet l'acc�s � des sites FTP surcharg�s qui
82
limitent le nombre de connexions simultan�es pour les utilisateurs anonymes.
83
APT parall�lise aussi les connexions � diff�rents h�tes pour tirer plus
84
efficacement parti des sites � faible bande passante.
86
Il est important d'indiquer les sources par ordre de pr�f�rence,
87
la source principale apparaissant en premier. Un tri est fait, de la plus
88
rapide � la plus lente ; par exemple, CD-ROM suivi par les h�tes d'un
89
r�seau local, puis les h�tes Internet distants.
91
Voici quelques exemples :
93
deb http://http.us.debian.org/debian stable main contrib non-free
94
deb http://http.us.debian.org/debian dists/stable-updates/
98
<RefSect1><title>La sp�cification des URI</title>
100
Les URI actuellement reconnus sont : cdrom, file, http et ftp.
102
<VarListEntry><term>file</term>
104
Le proc�d� <literal/file/ permet qu'un r�pertoire arbitraire au sein du
105
syst�me de fichier soit consid�r� comme une archive. On s'en sert avec les
106
montages NFS, les miroirs et les archives locaux.
109
<VarListEntry><term>cdrom</term>
111
Le proc�d� <literal/cdrom/ permet l'utilisation d'un lecteur de CDROM local
112
avec la possibilit� de changer de media. Utilisez le programme &apt-cdrom;
113
pour cr�er des entr�es dans la liste de sources.
116
<VarListEntry><term>http</term>
118
Le proc�d� <literal/http/ indique un serveur HTTP comme archive. Si une
119
variable d'environnement <EnVar/http_proxy/ (au format http://server:port/)
120
existe, le serveur mandataire indiqu� par <EnVar/http_proxy/ est utilis�.
121
Quand un serveur mandataire HTTP/1.1 demande une authentification, on peut
122
utiliser la cha�ne http://user:pass@server:port/. Notez qu'il s'agit d'une
123
m�thode d'authentification peu s�re.
126
<VarListEntry><term>ftp</term>
128
Le proc�d� <literal/ftp/ indique un serveur FTP comme archive. Le
129
fonctionnement en mode ftp est grandement configurable ; r�f�rez-vous
130
� la page de manuel de &apt-conf; pour davantage de renseignements. On
131
remarquera qu'on peut indiquer un mandataire ftp avec la variable
132
d'environnement <EnVar/ftp_proxy/. On peut aussi sp�cifier un mandataire http
133
(les serveurs mandataires http comprennent souvent les URLs ftp) en utilisant
134
cette m�thode et SEULEMENT cette m�thode. Les mandataires ftp utilisant http
135
et qui sont sp�cifi�s dans le fichier de configuration seront ignor�s.
138
<VarListEntry><term>copy</term>
140
Le proc�d� <literal/copy/ est identique au proc�d� <literal/file/ except� que
141
les paquets sont copi�s dans le cache du r�pertoire au lieu d'�tre utilis�s
142
directement depuis leur emplacement. C'est utile aux gens qui utilisent un
143
disque zip pour recopier des fichiers un peu partout via APT.
146
<VarListEntry><term>rsh</term><term>ssh</term>
148
Le proc�d� rsh/ssh utilise rsh/ssh pour se connecter � une
149
machine distante en tant que tel utilisateur donn� et pour acc�der aux
150
fichiers. Aucune authentification par mot de passe n'est possible : il
151
faut au pr�alable r�gler ce probl�me avec des cl�s RSA ou bien rhosts. Pour
152
l'acc�s aux fichiers de la machine distante et le transfert, on utilise les
153
commandes standard <command/find/ et <command/dd/.
158
<RefSect1><title>Exemples</title>
160
Utiliser l'archive stock�e localement (ou mont�e via NFS) dans
161
/home/jason/debian pour stable/main, stable/contrib et stable/non-free.
162
<literallayout>deb file:/home/jason/debian stable main contrib non-free</literallayout>
164
Comme ci-dessus, except� que cette ligne utilise la distribution
165
� unstable � (d�veloppement).
166
<literallayout>deb file:/home/jason/debian unstable main contrib non-free</literallayout>
168
La pr�c�dente ligne, mais pour les sources.
169
<literallayout>deb-src file:/home/jason/debian unstable main contrib non-free</literallayout>
171
Utiliser HTTP pour acc�der � l'archive situ�e � archive.debian.org, et
172
n'utiliser que la section hamm/main.
173
<literallayout>deb http://archive.debian.org/debian-archive hamm main</literallayout>
175
Utiliser FTP pour acc�der � l'archive situ�e � ftp.debian.org, dans le
176
r�pertoire debian, et n'utiliser que la section stable/contrib.
177
<literallayout>deb ftp://ftp.debian.org/debian stable contrib</literallayout>
179
Utiliser FTP pour acc�der � l'archive situ�e � ftp.debian.org, dans le
180
r�pertoire debian, et n'utiliser que la section unstable/contrib. Si cette
181
ligne et celle de l'exemple pr�c�dent dans <filename/sources.list/
182
apparaissent, une seule session FTP sera utilis�e pour les deux lignes.
183
<literallayout>deb ftp://ftp.debian.org/debian unstable contrib</literallayout>
185
Utiliser HTTP pour acc�der � l'archive situ�e � nonus.debian.org, dans le
186
r�pertoire debian-non-US.
187
<literallayout>deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free</literallayout>
189
Utiliser HTTP pour acc�der � l'archive situ�e � nonus.debian.org, dans le
190
r�pertoire debian-non-US, et n'utiliser que les fichiers trouv�s dans
191
<filename>unstable/binary-i386</> pour les machines i386, dans
192
<filename>unstable/binary-m68k</> pour les machines m68k et ainsi de suite
193
pour les autres architectures support�es. [Notez que cet exemple montre
194
seulement la mani�re d'utiliser la variable � substituer, non-us n'�tant plus
195
structur� de cette mani�re.]
196
<literallayout>deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/</literallayout>
199
<RefSect1><Title>Voir aussi</>
201
&apt-cache; &apt-conf;