1
.\" This manpage has been automatically generated by docbook2man
2
.\" from a DocBook document. This tool can be found at:
3
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
4
.\" Please send any bug reports, improvements, comments, patches,
5
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
.TH "SOURCES.LIST" "5" "26 March 2005" "" ""
9
sources.list \- Une liste, utilis�e par APT, indiquant les ressources de paquets
12
La liste des ressources de paquets indique o� trouver les archives
13
du syst�me de distribution de paquets utilis�. Pour l'instant, cette page
14
de manuel ne documente que le syst�me d'empaquetage utilis� par le syst�me
15
Debian GNU/Linux. Ce fichier de contr�le est situ� dans
16
\fI/etc/apt/sources.list\fR\&.
18
La liste des sources est con�ue pour prendre en compte un nombre quelconque
19
de sources actives et diff�rents m�dia. Le fichier pr�sente
20
une source par ligne et la source pr�f�r�e appara�t en premier. Le format de
21
chaque ligne est\~: type uri args\&. Le premier �l�ment,
22
type, d�termine le format des args\&. uri est un
23
identificateur universel de ressources (URI), qui est un sur-ensemble du plus
24
sp�cifique et bien connu rep�re universel de ressources, ou URL. La fin de la
25
ligne peut �tre un commentaire commen�ant par un caract�re #.
26
.SH "LES TYPES DEB ET DEB-SRC."
28
Le type deb d�crit une archive Debian classique � deux niveaux,
29
\fIdistribution/composant\fR\&. distribution peut prendre
30
l'une des valeurs suivantes\~: stable, unstable, ou
31
frozen, et composant\~: main, contrib,
32
non-free, ou non-us\&. Le type deb-src d�crit le
33
code source pour une distribution Debian dans le m�me format que le type
34
deb\&. Une ligne deb-src est n�cessaire pour r�cup�rer les
37
Le format d'une entr�e dans \fIsources.list\fR utilisant les types
38
deb et deb-src est de la forme\~:
41
deb uri distribution [composant1] [composant2] [...]
44
L'URI de type deb doit indiquer la base de la distribution Debian
45
dans laquelle APT trouvera les informations dont il a besoin.
46
distribution peut sp�cifier le chemin exact\~: dans ce cas, on
47
doit omettre les composants et distribution doit se terminer par une
48
barre oblique (/). C'est utile quand seule une sous-section particuli�re de
49
l'archive d�crite par cet URI est int�ressante. Quand distribution
50
n'indique pas un chemin exact, un component au moins doit �tre
53
distribution peut aussi contenir une variable $(ARCH),
54
qui sera remplac�e par l'architecture Debian (i386, m68k, powerpc, ...)
55
sur laquelle s'ex�cute le syst�me. On peut ainsi utiliser un fichier
56
\fIsources.list\fR qui ne d�pend pas d'une architecture. En g�n�ral,
57
ce n'est int�ressant que si l'on indique un chemin exact\~; sinon
58
APT cr�e automatiquement un URI en fonction de l'architecture
61
Puisqu'on ne peut indiquer qu'une seule distribution par ligne, il peut �tre
62
n�cessaire de disposer le m�me URI sur plusieurs lignes quand on veut
63
acc�der � un sous-ensemble des distributions ou composants disponibles � cette
64
adresse. APT trie les URI apr�s avoir cr�e pour lui-m�me la liste
65
compl�te\~; il regroupe les r�f�rences multiples au m�me h�te Internet
66
en vue d'une connexion unique et il �vite ainsi, par exemple, d'�tablir une
67
connexion FTP, de la fermer, faire autre chose, puis d'�tablir encore cette
68
connexion. Cette fonctionnalit� permet l'acc�s � des sites FTP surcharg�s qui
69
limitent le nombre de connexions simultan�es pour les utilisateurs anonymes.
70
APT parall�lise aussi les connexions � diff�rents h�tes pour tirer plus
71
efficacement parti des sites � faible bande passante.
73
Il est important d'indiquer les sources par ordre de pr�f�rence,
74
la source principale apparaissant en premier. Un tri est fait, de la plus
75
rapide � la plus lente\~; par exemple, CD-ROM suivi par les h�tes d'un
76
r�seau local, puis les h�tes Internet distants.
78
Voici quelques exemples\~:
81
deb http://http.us.debian.org/debian stable main contrib non-free
82
deb http://http.us.debian.org/debian dists/stable-updates/
85
.SH "LA SP�CIFICATION DES URI"
87
Les URI actuellement reconnus sont\~: cdrom, file, http et ftp.
90
Le proc�d� file permet qu'un r�pertoire arbitraire au sein du
91
syst�me de fichier soit consid�r� comme une archive. On s'en sert avec les
92
montages NFS, les miroirs et les archives locaux.
95
Le proc�d� cdrom permet l'utilisation d'un lecteur de CDROM local
96
avec la possibilit� de changer de media. Utilisez le programme \fBapt-cdrom\fR(8)
97
pour cr�er des entr�es dans la liste de sources.
100
Le proc�d� http indique un serveur HTTP comme archive. Si une
101
variable d'environnement \fBhttp_proxy\fR (au format http://server:port/)
102
existe, le serveur mandataire indiqu� par \fBhttp_proxy\fR est utilis�.
103
Quand un serveur mandataire HTTP/1.1 demande une authentification, on peut
104
utiliser la cha�ne http://user:pass@server:port/. Notez qu'il s'agit d'une
105
m�thode d'authentification peu s�re.
108
Le proc�d� ftp indique un serveur FTP comme archive. Le
109
fonctionnement en mode ftp est grandement configurable\~; r�f�rez-vous
110
� la page de manuel de \fB\fIapt.conf\fB\fR(5)
111
pour davantage de renseignements. On
112
remarquera qu'on peut indiquer un mandataire ftp avec la variable
113
d'environnement \fBftp_proxy\fR\&. On peut aussi sp�cifier un mandataire http
114
(les serveurs mandataires http comprennent souvent les URLs ftp) en utilisant
115
cette m�thode et SEULEMENT cette m�thode. Les mandataires ftp utilisant http
116
et qui sont sp�cifi�s dans le fichier de configuration seront ignor�s.
119
Le proc�d� copy est identique au proc�d� file except� que
120
les paquets sont copi�s dans le cache du r�pertoire au lieu d'�tre utilis�s
121
directement depuis leur emplacement. C'est utile aux gens qui utilisent un
122
disque zip pour recopier des fichiers un peu partout via APT.
127
Le proc�d� rsh/ssh utilise rsh/ssh pour se connecter � une
128
machine distante en tant que tel utilisateur donn� et pour acc�der aux
129
fichiers. Aucune authentification par mot de passe n'est possible\~: il
130
faut au pr�alable r�gler ce probl�me avec des cl�s RSA ou bien rhosts. Pour
131
l'acc�s aux fichiers de la machine distante et le transfert, on utilise les
132
commandes standard \fBfind\fR et \fBdd\fR\&.
135
Utiliser l'archive stock�e localement (ou mont�e via NFS) dans
136
/home/jason/debian pour stable/main, stable/contrib et stable/non-free.
139
deb file:/home/jason/debian stable main contrib non-free
142
Comme ci-dessus, except� que cette ligne utilise la distribution
143
�\~unstable\~� (d�veloppement).
146
deb file:/home/jason/debian unstable main contrib non-free
149
La pr�c�dente ligne, mais pour les sources.
152
deb-src file:/home/jason/debian unstable main contrib non-free
155
Utiliser HTTP pour acc�der � l'archive situ�e � archive.debian.org, et
156
n'utiliser que la section hamm/main.
159
deb http://archive.debian.org/debian-archive hamm main
162
Utiliser FTP pour acc�der � l'archive situ�e � ftp.debian.org, dans le
163
r�pertoire debian, et n'utiliser que la section stable/contrib.
166
deb ftp://ftp.debian.org/debian stable contrib
169
Utiliser FTP pour acc�der � l'archive situ�e � ftp.debian.org, dans le
170
r�pertoire debian, et n'utiliser que la section unstable/contrib. Si cette
171
ligne et celle de l'exemple pr�c�dent dans \fIsources.list\fR
172
apparaissent, une seule session FTP sera utilis�e pour les deux lignes.
175
deb ftp://ftp.debian.org/debian unstable contrib
178
Utiliser HTTP pour acc�der � l'archive situ�e � nonus.debian.org, dans le
179
r�pertoire debian-non-US.
182
deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free
185
Utiliser HTTP pour acc�der � l'archive situ�e � nonus.debian.org, dans le
186
r�pertoire debian-non-US, et n'utiliser que les fichiers trouv�s dans
187
\fIunstable/binary-i386\fR pour les machines i386, dans
188
\fIunstable/binary-m68k\fR pour les machines m68k et ainsi de suite
189
pour les autres architectures support�es. [Notez que cet exemple montre
190
seulement la mani�re d'utiliser la variable � substituer, non-us n'�tant plus
191
structur� de cette mani�re.]
194
deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/
199
\fB\fIapt.conf\fB\fR(5)
202
Voyez la page concernant les bogues de APT <URL:http://bugs.debian.org/src:apt>\&.
203
Si vous voulez rapporter un bogue, consultez le texte
204
\fI/usr/share/doc/debian/bug-reporting.txt\fR ou utilisez la
205
commande \fBreportbug\fR(1)
209
APT a �t� �crit par l'�quipe APT <apt@packages.debian.org>\&.
212
J�r�me Marant. 2000\~; mise � jour : Philippe Batailler. 2004.