SOURCES.LIST(5)

février 2004

NAME
sources.list - Liste des sources de paquets

DESCRIPTION

The package resource list is used to locate archives of the package distribution system in use on the system. At this time, this manual page documents only the packaging system used by the Debian GNU/Linux system. This control file is /etc/apt/sources.list.

The source list is designed to support any number of active sources and a variety of source media. The file lists one source per line, with the most preferred source listed first. The format of each line is: type uri args The first item, type determines the format for args. uri is a Universal Resource Identifier (URI), which is a superset of the more specific and well-known Universal Resource Locator, or URL. The rest of the line can be marked as a comment by using a #.

SOURCES.LIST.D

Le répertoire /etc/apt/sources.list.d permet de spécifier des sources de paquets dans des fichiers distincts qui se terminent par .list. Leur format est le même que celui du fichier sources.list. Les noms de fichiers doivent se terminer par .list et ne peuvent contenir que des lettres (a-z et A-Z), des chiffres (0-9), des caractères de soulignement (_), des tirets et des points. Dans le cas contraire, ils seront ignorés.

LES TYPES DEB ET DEB-SRC.

The deb type describes a typical two-level Debian archive, distribution/component. Typically, distribution is generally one of stable unstable or testing while component is one of main contrib non-free or non-us. The deb-src type describes a debian distribution's source code in the same form as the deb type. A deb-src line is required to fetch source indexes.

The format for a sources.list entry using the deb and deb-src types is:

    deb uri distribution [composant1] [composant2] [...]

The URI for the deb type must specify the base of the Debian distribution, from which APT will find the information it needs. distribution can specify an exact path, in which case the components must be omitted and distribution must end with a slash (/). This is useful for when the case only a particular sub-section of the archive denoted by the URI is of interest. If distribution does not specify an exact path, at least one component must be present.

distribution peut aussi contenir une variable $(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 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 ; sinon APT crée automatiquement un URI en fonction de l'architecture effective.

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.

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 CD suivi par les hôtes d'un réseau local, puis les hôtes distants.

Exemples :

    deb http://http.us.debian.org/debian stable main contrib non-free
    deb http://http.us.debian.org/debian dists/stable-updates/

SPéCIFICATION DES URI

Les types d'URI actuellement reconnus sont : cdrom, file, http, ftp, copy, ssh et rsh.

file
    Le procédé 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 les archives locaux.

cdrom
    Le procédé cdrom permet l'utilisation d'un lecteur de CD avec la possibilité de changer de media. Utilisez le programme apt-cdrom(8) pour créer des entrées dans la liste des sources.

http
    The http scheme specifies an HTTP server for the archive. If an environment variable http_proxy is set with the format http://server:port/, the proxy server specified in http_proxy will be used. Users of authenticated HTTP/1.1 proxies may use a string of the format http://user:pass@server:port/. Note that this is an insecure method of authentication.

ftp
    Le procédé ftp indique un serveur FTP comme archive. Le fonctionnement en mode ftp est largement configurable ; référez-vous à la page de manuel de apt-cdrom(8) pour d'autres informations. On remarquera qu'on peut indiquer un mandataire ftp avec la variable d'environnement ftp_proxy. 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.

copy
    Le procédé copy est identique au procédé 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 avec APT.

rsh, ssh
    Le procédé rsh/ssh utilise rsh/ssh pour se connecter à une machine distante en tant qu'un certain utilisateur et pour accéder aux fichiers. Il est préférable au préalable de s'arranger 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 find et dd.

more recognizable URI types
    APT can be extended with more methods shipped in other optional packages which should follow the nameing scheme apt-transport-method. The APT team e.g. maintains also the apt-transport-https package which provides access methods for https-URIs with features similiar to the http method, but other methods for using e.g. debtorrent are also available, see apt-transport-debtorrent(1).

EXEMPLES

Utiliser l'archive stockée localement (ou montée via NFS) dans /home/jason/debian pour stable/main, stable/contrib et stable/non-free.

    deb file:/home/jason/debian stable main contrib non-free

Comme ci-dessus, excepté que cette ligne utilise la distribution « unstable » (développement).

    deb file:/home/jason/debian unstable main contrib non-free

La précédente ligne, mais pour les sources.

    deb-src file:/home/jason/debian unstable main contrib non-free

Utiliser HTTP pour accéder à l'archive située à archive.debian.org, et n'utiliser que la section hamm/main.

    deb http://archive.debian.org/debian-archive hamm main

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.

    deb ftp://ftp.debian.org/debian stable contrib

Uses FTP to access the archive at ftp.debian.org, under the debian directory, and uses only the unstable/contrib area. If this line appears as well as the one in the previous example in sources.list a single FTP session will be used for both resource lines.

    deb ftp://ftp.debian.org/debian unstable contrib

Utiliser HTTP pour accéder à l'archive située à nonus.debian.org, dans le répertoire debian-non-US.

    deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free

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 unstable/binary-i386 pour les machines i386, dans unstable/binary-m68k 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.]

    deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/

VOIR AUSSI

apt-cache(8) apt.conf(5)

BOGUES

Page des bogues d'APT[1]. Si vous souhaitez remonter un bogue à propos d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou utiliser la commande reportbug(1).

TRADUCTEURS

Jérôme Marant, Philippe Batailler, Christian Perrier bubulle@debian.org (2000, 2005, 2009), Équipe de traduction francophone de Debian debian-l10n-french@lists.debian.org

AUTHORS

Jason Gunthorpe

Équipe de développement d'APT

NOTES

1.  Page des bogues d'APT
    http://bugs.debian.org/src:apt