SOURCES.LIST(5)

février 2004

NAME
sources.list - Liste des sources de paquets

DESCRIPTION

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 /etc/apt/sources.list.

La liste des sources est conçue pour gérer 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 : type uri paramètres. Le premier élément, type, détermine le format des paramètres. uri 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 #.

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, APT affichera un avertissement indiquant qu'il a ignoré un fichier si celui-ci ne correspond par à un motif défini dans Dir::Ignore-Files-Silently (les fichiers correspondant à cette variable de configuration étant, eux, ignorés silencieusemennt).

LES TYPES DEB ET DEB-SRC.

Le type deb décrit une archive Debian classique à deux niveaux, distribution/composant. distribution peut prendre l'une des valeurs suivantes : un nom d'archive tel que stable ou testing ou bien un nom de code comme squeeze ou wheezy, alors que composant prend les valeurs : main, contrib ou non-free. Le type deb-src décrit une archive de distribution de code source pour une distribution Debian dans le même format que le type deb. Une ligne deb-src est nécessaire pour récupérer les index des sources.

Le format d'une entrée dans sources.list utilisant les types deb et deb-src est :

    deb [ options ] uri distribution [component1] [component2] [...]

L'URI de type deb doit indiquer la base de la distribution Debian dans laquelle APT trouvera les informations dont il a besoin. distribution peut spécifier le chemin exact : dans ce cas, on doit omettre les composants et 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 distribution n'indique pas un chemin exact, un composant au moins doit être présent.

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.

options is always optional and needs to be surounded by square brackets. It can consist of multiple settings in the form setting=value. Multiple settings are separated by spaces. The following settings are supported by APT, note though that unsupported settings will be ignored silently:

    • arch=arch1,arch2,... can be used to specify for which architectures packages information should be downloaded. If this option is not set all architectures defined by the APT::Architectures option will be downloaded.

    • trusted=yes can be set to indicate that packages from this source are always authenificated even if the Release file is not signed or the signature can't be checked. This disables parts of apt-secure(8) and should therefore only be used in a local and trusted context. trusted=no is the opposite which handles even correctly authenificated sources as not authenificated.

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://ftp.debian.org/debian squeeze main contrib non-free
    deb http://security.debian.org/ squeeze/updates main contrib non-free

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
    Le procédé http indique un serveur HTTP comme archive. Si une variable d'environnement http_proxy (au format http://server:port/) existe, le serveur mandataire indiqué par 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.

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.

plus de types d'URI simples à reconnaître
    APT peut être complété avec des méthodes supplémentaires fournies par des paquets optionnels dont le schéma de nommage est apt-transport-méthode. Ainsi, l'équipe de maintenance d'APT gère un paquet apt-transport-https qui gère les accès par URI de type https, avec des fonctionnalités analogues à la méthode http. D'autres méthodes telles que debtorrent sont aussi disponibles (voir 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

The first line gets package information for the architectures in APT::Architectures while the second always retrieves amd64 and armel.

    deb http://ftp.debian.org/debian squeeze main
    deb [ arch=amd64,armel ] http://ftp.debian.org/debian squeeze main

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 squeeze/contrib.

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

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 sources.list apparaissent, une seule session FTP sera utilisée pour les deux lignes.

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

Utiliser HTTP pour accéder à l'archive située à ftp.tlh.debian.org, dans le répertoire universe, et n'utiliser que les fichiers trouvés dans unstable/binary-i386 pour les machines i386, dans unstable/binary-amd64 pour les machines amd64 et ainsi de suite pour les autres architectures reconnues. [Notez que cet exemple montre seulement la manière d'utiliser la variable à substituer, les archives Debian n'étant plas structurées de cette manière.]

    deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/

VOIR AUSSI

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

BOGUES

Page des bogues d'APT[1]. Si vous souhaitez signaler 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, 2010), Équipe de traduction francophone de Debian <debian-l10n-french@lists.debian.org>

Veuillez noter que cette traduction peut contenir des parties non traduites. Cela est volontaire, pour éviter de perdre du contenu quand la traduction est légèrement en retard sur le contenu d'origine.

AUTHORS

Jason Gunthorpe

Équipe de développement d'APT

NOTES

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