SOURCES.LIST(5)

NOMBRE
sources.list - Lista de fuentes de datos de APT configurados

DESCRIPCIÓN

La lista de fuentes /etc/apt/sources.list se ha diseñado para permitir cualquier número de fuentes activas así como distintos medios de soporte de fuentes. El fichero enumera una fuente por línea, con la fuente preferida en primer lugar. La información disponible de las fuentes configuradas se obtiene mediante apt-get update (o una orden equivalente de una interfaz de APT).

Cada línea que define una fuente empieza con el tipo (por ejemplo, «deb-src») seguido de las opciones y argumentos para este tipo. Una entrada individual no puede continuar en la siguiente línea. Las líneas vacías se ignoran, y un carácter «#» presente en cualquier lugar de la línea marca los caracteres restantes como comentario.

SOURCES.LIST.D

El directorio /etc/apt/sources.list.d ofrece una manera de añadir entradas de «sources.list» en ficheros separados. El formato es idéntico al del fichero normal sources.list. Los nombres de los ficheros deben terminar en .list, y sólo pueden contener caracteres de letras (a-z y A-Z), dígitos (0-9), guión bajo (_), guión (-) y punto (.). De no ser así, APT informa de que ha omitido un fichero, a menos que coincida con un patrón en la lista de configuración Dir::Ignore-Files-Silently. Si coincide, se omite silenciosamente.

LOS TIPOS «DEB» Y «DEB-SRC»

El tipo deb hace referencia a un típico archivo de Debian de dos niveles, distribución/componente. Habitualmente, distribución es «stable» (estable) o «testing» (en pruebas), o un nombre código como jessie o stretch, mientras que el componente es main (principal), contrib, non-free (no libre), o non-us. El tipo deb-src hace referencia al código fuente de la distribución con la misma sintaxis que el tipo deb. Debe insertar una línea deb-src para obtener los índices de fuentes.

El formato para una entrada en el fichero sources.list usando los tipos deb y deb-src es:

    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 siempre es opcional, y debe estar delimitado por corchetes. Puede consistir de varias opciones con la forma opción=valor. Varias opciones se separan con espacios. APT permite las siguientes opciones (tenga en cuenta que las opciones no permitidas se ignoran silenciosamente):

    • arch=arquitecura1,arquitecura2,... se puede utilizar para definir la arquitectura para la que se descarga información sobre arquitecturas. Si no se define esta opción, se descargarán todas las arquitecturas definidas por la opción APT::Architectures.

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

    • trusted=yes se puede definir para indicar que los paquetes que proviene de esta fuente siempre están autenticados incluso si el fichero Release no está firmado, o si no se puede comprobar la firma. Esto desactiva partes de apt-secure(8) y por ello solo se debe utilizar en un contexto local y de confianza. trusted=no ofrece lo opuesto, ya que supone que las fuentes correctamente autenticadas no lo están.

Es importante listar las fuentes por orden de preferencia, con la fuente preferente al inicio. Lo normal es ordenar las fuentes por velocidad, de la más rápida a la más lenta (CD-ROM seguido de servidores en la red local, seguidos por servidores de Internet distantes, por ejemplo).

Algunos ejemplos:

    deb http://ftp.debian.org/debian jessie main contrib non-free
    deb http://security.debian.org/ jessie/updates main contrib non-free

ESPECIFICACIÓN DEL URI

Los tipos de URI permitidos actualmente son:

file
    El esquema «file» permite considerar cualquier directorio en el sistema de ficheros como un archivo de paquetes adicional. Esto es útil para particiones montadas mediante NFS y réplicas o archivos de paquetes locales.

cdrom
    El esquema «cdrom» permite a APT utilizar la unidad de CD-ROM local. Utilice el programa apt-cdrom(8) para añadir entradas de un disco óptico a «sources.list».

http
    El esquema «http» define un servidor HTTP como el archivo de paquetes. Si la variable de entorno http_proxy está definida con formato «http://servidor:puerto/», se usará el servidor proxy definido en http_proxy. Los usuarios de servidores proxy con autenticación HTTP/1.1 deberán usar la cadena de caracteres «http://usuario:contraseña@servidor:puerto/». Tenga en cuenta que este método de autenticación no es seguro.

ftp
    El esquema «ftp» definea un servidor FTP como el archivo de paquetes. El comportamiento de APT con FTP es muy configurable, para más información consulte la página de manual de apt.conf(5). Tenga en cuenta que puede especificar un proxy FTP mediante la variable de entorno ftp_proxy. Es posible especificar un servidor proxy HTTP (los servidores proxy HTTP normalmente comprenden los URL de tipo FTP) mediante este método y SÓLO este método. Se ignoran los proxies que utilizan HTTP definidos en el fichero de configuración.

copy
    El esquema «copy» es idéntico a «file», pero los paquetes se copian al directorio almacén en vez de usarlos directamente en su ubicación original. Es de utilidad para personas que utilizan dispositivos extraíbles, ya que permite realizar la copia de ficheros con APT.

rsh, ssh
    El método «rsh/ssh» invoca RSH/SSH para establecer una conexión con una máquina remota y acceder a los ficheros como un usuario dado. Se recomienda configurar previamente rhosts o las claves RSA. Las órdenes estándar find y dd se utilizan para realizar la transferencia de ficheros desde la máquina remota.

Añadir más tipos de URI reconocidos.
    APT se puede extender con más métodos proporcionados por paquetes opcionales, que deben seguir el esquema de denominación apt-transport-método. Por ejemplo, el equipo de APT también desarrolla el paquete apt-transport-https, que proporciona métodos de acceso a direcciones URI de HTTPS de forma similar al método «http». También se proporcionan métodos para debtorrent, consulte apt-transport-debtorrent(1).

EJEMPLOS

Utiliza el archivo local (o montado mediante NFS) en «/home/jason/debian» para «stable/main», «stable/contrib», y «stable/non-free».

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

Como arriba, excepto que usa la distribución «unstable» (en desarrollo).

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

Línea para obtener el código fuente desde la ubicación anterior.

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

La primera línea obtiene información de paquete para las arquitecturas en APT::Architectures mientras que la segunda siempre obtiene amd64 y armel.

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

Utiliza HTTP para acceder al archivo de Debian en «archive.debian.org», y usa sólo la sección «hamm/main».

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

Utiliza FTP para acceder al archivo de Debian en «ftp.debian.org», debajo del directorio «debian», y usa sólo la sección «jessie/contrib».

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

Utiliza FTP para acceder al archivo de Debian en «ftp.debian.org», debajo del directorio «debian», y usa sólo la sección unstable/contrib. Si tanto esta línea como la del ejemplo anterior aparecen en sources.list, se usará sólo una sesión FTP para ambas.

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

Utiliza HTTP para acceder al archivo en «ftp.tlh.debian.org», bajo el directorio «universe», y sólo usa ficheros que se encuentren bajo unstable/binary-i386 en máquinas i386, unstable/binary-amd64 en máquinas amd64, y así para todas las arquitecturas compatibles. (Tenga en cuenta que este ejemplo sólo sirve para ilustrar cómo se usa la variable de sustitución, «non-us» ya tiene esta estructura.)

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

VÉASE TAMBIÉN

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

BUGS

Página de errores de APT[1]. Si quiere informar de un error en APT, consulte /usr/share/doc/debian/bug-reporting.txt o use la orden reportbug(1).

TRADUCCIÓN

La traducción al español la realizaron Ismael Fanlo, Carlos Mestre, Rudy Godoy, Gustavo Saldumbide, Javier Fernández-Sanguino y Rubén Porras Campo entre los años 2003 y 2004. La traducción fue actualizada por Francisco Javier Cuadrado y Omar Campagne Polaino entre los años 2009 y 2012 .

Tenga en cuenta que este documento puede contener secciones sin traducir. Esto es intencionado para evitar perder contenido cuando la traducción no está actualizada con respecto al documento original.

AUTORES

Jason Gunthorpe

Equipo de APT

NOTAS

1.  Página de errores de APT
    http://bugs.debian.org/src:apt