]> git.saurik.com Git - apt-legacy.git/blob - doc/fr/sources.list.fr.5
Drastically improved APT HTTP error messages and actually set the proxy server config...
[apt-legacy.git] / doc / fr / sources.list.fr.5
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
5 .\" Manual:
6 .\" Source: Linux
7 .\"
8 .TH "SOURCES.LIST" "5" "29 February 2004" "Linux" ""
9 .\" disable hyphenation
10 .nh
11 .\" disable justification (adjust text to left margin only)
12 .ad l
13 .SH "NOM"
14 sources.list \- Liste des sources de paquets
15 .SH "DESCRIPTION"
16 .PP
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.
19 .PP
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
23 args.
24 uri
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 #.
26 .SH "SOURCES.LIST.D"
27 .PP
28 Le répertoire
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
32 \fIsources.list\fR.
33 .SH "LES TYPES DEB ET DEB\-SRC."
34 .PP
35 Le type
36 deb
37 décrit une archive Debian classique à deux niveaux,
38 \fIdistribution/composant\fR.
39 distribution
40 peut prendre l'une des valeurs suivantes\ :
41 stable,
42 unstable, ou
43 testing, et composant\ :
44 main,
45 contrib,
46 non\-free, ou
47 non\-us. Le type
48 deb\-src
49 décrit le code source pour une distribution Debian dans le même format que le type
50 deb. Une ligne
51 deb\-src
52 est nécessaire pour récupérer les index des sources.
53 .PP
54 Le format d'une entrée dans
55 \fIsources.list\fR
56 utilisant les types
57 deb
58 et
59 deb\-src
60 est de la forme\ :
61 .sp
62 .RS 3n
63 .nf
64 deb uri distribution [composant1] [composant2] [...]
65 .fi
66 .RE
67 .PP
68 L'URI de type
69 deb
70 doit indiquer la base de la distribution Debian dans laquelle APT trouvera les informations dont il a besoin.
71 distribution
72 peut spécifier le chemin exact\ : dans ce cas, on doit omettre les composants et
73 distribution
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
75 distribution
76 n'indique pas un chemin exact, un
77 composant
78 au moins doit être présent.
79 .PP
80
81 distribution
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
84 \fIsources.list\fR
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
86 APT
87 crée automatiquement un URI en fonction de l'architecture effective.
88 .PP
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.
90 .PP
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.
92 .PP
93 Voici quelques exemples\ :
94 .sp
95 .RS 3n
96 .nf
97 deb http://http.us.debian.org/debian stable main contrib non\-free
98 deb http://http.us.debian.org/debian dists/stable\-updates/
99
100 .fi
101 .RE
102 .SH "LA SPÉCIFICATION DES URI"
103 .PP
104 Les URI actuellement reconnus sont\ : cdrom, file, http et ftp.
105 .PP
106 file
107 .RS 3n
108 Le procédé
109 file
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.
111 .RE
112 .PP
113 cdrom
114 .RS 3n
115 Le procédé
116 cdrom
117 permet l'utilisation d'un lecteur de cédérom avec la possibilité de changer de media. Utilisez le programme
118 \fBapt\-cdrom\fR(8)
119 pour créer des entrées dans la liste des sources.
120 .RE
121 .PP
122 http
123 .RS 3n
124 Le procédé
125 http
126 indique un serveur HTTP comme archive. Si une variable d'environnement
127 \fBhttp_proxy\fR
128 (au format http://server:port/) existe, le serveur mandataire indiqué par
129 \fBhttp_proxy\fR
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.
131 .RE
132 .PP
133 ftp
134 .RS 3n
135 Le procédé
136 ftp
137 indique un serveur FTP comme archive. Le fonctionnement en mode ftp est largement configurable\ ; référez\-vous à la page de manuel de
138 \fBapt\-cdrom\fR(8)
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.
141 .RE
142 .PP
143 copy
144 .RS 3n
145 Le procédé
146 copy
147 est identique au procédé
148 file
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.
150 .RE
151 .PP
152 rsh, ssh
153 .RS 3n
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
155 \fBfind\fR
156 et
157 \fBdd\fR.
158 .RE
159 .SH "EXEMPLES"
160 .PP
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.
162 .sp
163 .RS 3n
164 .nf
165 deb file:/home/jason/debian stable main contrib non\-free
166 .fi
167 .RE
168 .PP
169 Comme ci\-dessus, excepté que cette ligne utilise la distribution \(Fo\ unstable\ \(Fc (développement).
170 .sp
171 .RS 3n
172 .nf
173 deb file:/home/jason/debian unstable main contrib non\-free
174 .fi
175 .RE
176 .PP
177 La précédente ligne, mais pour les sources.
178 .sp
179 .RS 3n
180 .nf
181 deb\-src file:/home/jason/debian unstable main contrib non\-free
182 .fi
183 .RE
184 .PP
185 Utiliser HTTP pour accéder à l'archive située à archive.debian.org, et n'utiliser que la section hamm/main.
186 .sp
187 .RS 3n
188 .nf
189 deb http://archive.debian.org/debian\-archive hamm main
190 .fi
191 .RE
192 .PP
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.
194 .sp
195 .RS 3n
196 .nf
197 deb ftp://ftp.debian.org/debian stable contrib
198 .fi
199 .RE
200 .PP
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
202 \fIsources.list\fR
203 apparaissent, une seule session FTP sera utilisée pour les deux lignes.
204 .sp
205 .RS 3n
206 .nf
207 deb ftp://ftp.debian.org/debian unstable contrib
208 .fi
209 .RE
210 .PP
211 Utiliser HTTP pour accéder à l'archive située à nonus.debian.org, dans le répertoire debian\-non\-US.
212 .sp
213 .RS 3n
214 .nf
215 deb http://nonus.debian.org/debian\-non\-US stable/non\-US main contrib non\-free
216 .fi
217 .RE
218 .PP
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.]
224 .sp
225 .RS 3n
226 .nf
227 deb http://ftp.de.debian.org/debian\-non\-US unstable/binary\-$(ARCH)/
228 .fi
229 .RE
230 .SH "VOIR AUSSI"
231 .PP
232 \fBapt\-cache\fR(8)
233 \fBapt.conf\fR(5)
234 .SH "BOGUES"
235 .PP
236 Voyez la
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
240 \fBreportbug\fR(1).
241 .SH "TRADUCTION"
242 .PP
243 Philippe Batailler.
244 <debian\-l10n\-french@lists.debian.org>. 2005.
245 .SH "AUTHORS"
246 .PP
247 \fBJason Gunthorpe\fR
248 .sp -1n
249 .IP "" 3n
250 Auteur.
251 .PP
252 \fBAPT team\fR
253 .sp -1n
254 .IP "" 3n
255 Auteur.
256 .SH "REFERENCES"
257 .TP 3
258 1.\ page concernant les bogues d'APT
259 \%http://bugs.debian.org/src:apt