SOURCES.LIST(5)

NOM
sources.list - Liste des sources de données APT configurées

DESCRIPTION

Le fichier de liste de sources /etc/apt/sources.list est prévu pour pouvoir gérer un nombre quelconque de sources actives et de supports. Le fichier donne une source par ligne, avec les sources prioritaires en premier. L'information relative aux sources configurées est récupérée par la commande apt-get update (ou par une commande équivalent avec une autre interface à APT).

Chaque ligne qui indique une source commence par son type (p. ex. deb-src), suivi d'options et paramètres pour ce type. Les entrées individuelles ne peuvent pas être multilignes. Les lignes vides sont ignorées et un caractère # sur une ligne indique que le reste de la ligne est un commentaire.

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 wheezy ou jessie, 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 suite [component1] [component2] [...]

Alternatively a rfc822 style format is also supported:

         Types: deb deb-src
         URIs: http://example.com
         Suites: stable testing
         Sections: component1 component2
         Description: short
          long long long
         [option1]: [option1-value]
         Types: deb
         URIs: http://another.example.com
         Suites: experimental
         Sections: component1 component2
         Enabled: no
         Description: short
          long long long
         [option1]: [option1-value]

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

suite may also contain a variable, $(ARCH) which expands to the Debian architecture (such as amd64 or armel) used on the system. This permits architecture-independent sources.list files to be used. In general this is only of interest when specifying an exact path, APT will automatically generate a URI with the current architecture otherwise.

In the traditional style sources.list format since only one distribution can be specified per line it may be necessary to have multiple lines for the same URI, if a subset of all available distributions or components at that location is desired. APT will sort the URI list after it has generated a complete set internally, and will collapse multiple references to the same Internet host, for instance, into a single connection, so that it does not inefficiently establish an FTP connection, close it, do something else, and then re-establish a connection to that same host. This feature is useful for accessing busy FTP sites with limits on the number of simultaneous anonymous users. APT also parallelizes connections to different hosts to more effectively deal with sites with low bandwidth.

options est toujours optionnel et doit être entouré par des crochets. It est constitué de réglages multiples sous la forme réglage=valeur. Des réglages multiples sont séparés par des espaces. Les réglages suivants sont gérés par APT (des réglages non gérés seront ignorés silencieusement) :

    • arch=arch1,arch2,... peut être utilisé pour indiquer les architectures pour lesquelles l'information doit être téléchargée. Si cette option n'est pas utilisée, toutes les architectures définies par l'option APT::Architectures sera téléchargée.

    • arch+=arch1,arch2,... and arch-=arch1,arch2,... which can be used to add/remove architectures from the set which will be downloaded.

    • trusted=yes peut être utilisée pour indiquer que les paquets issus de cette source doivent être authentifiés même si le fichier Release n'est pas signé ou que la signature ne peut pas être vérifiée. Cela désactive certaines parties d'apt-secure(8) et ne devrait donc être utilisé que dans un contexte local ou sûr. trusted=no est l'opposé et considérera même les sources correctement authentifiées comme non authentifiées.

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

SPÉCIFICATION DES URI

Les types d'URI actuellement reconnues sont :

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 qui utilisent 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. Ce réglage peut servir aux utilisateurs qui se servent d'un support amovible pour recopier des fichiers avec APT.

rsh, ssh
    Le procédé rsh/ssh utilise rsh/ssh pour se connecter à une machine distante et pour accéder aux fichiers en tant qu'un certain utilisateur. Il est recommandé de régler préalablement les hôtes distants (rhosts) ou les clés RSA. Les commandes standard find et dd sont utilisées pour l'accès aux fichiers de la machine distante.

ajout de types d'URI supplémentaires reconnues
    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

La première ligne récupère l'information des paquets pour les architectures de APT::Architectures alors que la deuxième récupère amd64 et armel.

    deb http://ftp.debian.org/debian wheezy main
    deb [ arch=amd64,armel ] http://ftp.debian.org/debian wheezy 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 wheezy/contrib.

    deb ftp://ftp.debian.org/debian wheezy 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.

AUTEURS

Jason Gunthorpe

Équipe de développement d'APT

NOTES

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