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 wheezy o jessie, 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 [ opciones ] uri distribución [componente1] [componente2] [...]

El URI para el tipo deb debe especificar la base de la distribución de Debian desde la que APT encontrará la información que necesita. distribución puede definir una ruta exacta, en cuyo caso debe omitir los componentes y distribución debe finalizar con una barra (/). Esto es útil cuando sólo se requiere una sub-sección del archivo señalado por el URI. Al menos uno de los componentes debe estar presente si distribución no define una ruta exacta.

distribución puede contener una variable, $(ARCH), que se expandirá a la arquitectura de Debian usada en el sistema (por ejemplo, amd64 o armel). Esto permite que los ficheros sources.list sean independientes de la arquitectura. En general, esta característica sólo es de interés si se especifica una ruta completa, de lo contrario APT generará automáticamente una URI con la arquitectura actual del sistema.

Debido a que sólo se puede especificar una distribución por línea, es posible que se precisen varias líneas para la misma URI si desea tener acceso a más de una distribución o componente de esa ubicación. APT ordenará internamente la lista de direcciones URI después de generar una copia interna, y unirá varias referencias al mismo servidor de Internet en una sola conexión, para así no establecer una conexión FTP de forma ineficiente, cerrarla, hacer otra cosa, y entonces restablecer la conexión con el mismo servidor. Esta característica es útil para acceder a sitios FPT muy visitados que limitan el número de accesos simultáneos a usuarios anónimos. APT también realizará conexiones paralelas a diferentes servidores para aprovechar mejor el ancho de banda.

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.

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

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