summaryrefslogtreecommitdiff
path: root/doc/fr/sources.list.5.fr.sgml
blob: e2c48079cbdbf4e4e718f7d26a8a26f86407c545 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
<!-- -*- mode: sgml; mode: fold -*- -->
<!-- translation of version 1.2 -->
<!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 source. 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 surensemble 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/testing/, 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&thinsp;; 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 URIs apr�s avoir cr�e pour lui-m�me la liste 
compl�te&thinsp;; 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&thinsp;; par exemple, CD-ROM suivi par les h�tes d'un 
r�seau local, puis les h�tes Internet distants.
   <para>
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 URIs</title>
   <para>
Les URIs 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 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&thinsp;; 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� <literal/rsh&sol;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 standards <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� comme suit.]
   <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>