SOURCES.LIST(5)

de Febrero de 2004

NAME
sources.list - Lista de los repositorios de paquetes para APT

DESCRIPCIóN

La lista de los repositorios de paquetes se usa para ubicar los archivos de Debian del sistema de distribución de paquetes en uso en el sistema. A día de hoy, esta página del manual documenta sólo el sistema de paquetes que usa Debian GNU/Linux. Este fichero de control está ubicado en /etc/apt/sources.list

La lista de los repositorios está diseñada para gestionar cualquier número de fuentes y distintos tipos de procedencias. El fichero lista una fuente por línea, con la fuente de mayor prioridad en la primera línea. El formato de cada línea es: tipo uri argumentos. El primer elemento, tipo, determina el formato de argumentos. uri es «Universal Resource Identifier» (Identificador Universal de Recursos), un superconjunto de la más específica y bien conocida «Universal Resource Locator» (URL). Se puede marcar el resto de la línea como comentario usando #.

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 (.). Otros caracteres se ignorarán.

LOS TIPOS «DEB» Y «DEB-SRC»

El tipo deb hace referencia a un típico archivo de Debian de dos niveles, distribución/componente. Normalmente, distribución es «stable» (estable), «testing» (en pruebas), o «unstable» (inestable), 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 uri distribución [componente1] [componente2] [...]

La 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 quiere una sub-sección del archivo señalado por la 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 (i386, m68k, powerpc, ...). 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 la 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.

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

ESPECIFICACIóN DE LA URI

Los tipos de URI reconocidos son cdrom, file, http, ftp, copy, ssh y rsh.

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 usar la unidad de CDROM local. Use el programa apt-cdrom(8) para añadir entradas de un disco óptico a «sources.list».

http
    El esquema «http» especifica un servidor HTTP como archivo. 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» especifica un servidor FTP como archivo. El comportamiento de APT con FTP es altamente 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 usando la variable de entorno ftp_proxy. Es posible especificar un servidor proxy http (los servidores proxy http normalmente comprenden las url de tipo ftp) usando este método y SÓLO este método. Se ignorarán proxies ftp definidos en el fichero de configuración que usen http.

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. Esto es útil para gente que use discos zip con APT.

rsh, ssh
    El método «rsh/ssh» invoca «rsh/ssh» para establecer conexiones con los servidores remotos como un usuario dado, y acceder a los ficheros. Es aconsejable realizar previamente una configuración de claves RSA o rhosts. El acceso a los ficheros remotos usa las órdenes estándar find y dd para realizar la transferencia de ficheros.

Otros tipos de URI reconocidos.
    Puede extender APT con más métodos, proporcionados en otros paquetes opcionales que siguen el esquema de nombre apt-transport-método. El equipo de APT, por ejemplo, es responsable del paquete apt-transport-https, que ofrece métodos de acceso para URI https con características similares al método «http». Existen otros métodos disponibles, por ejemplo «debtorrent», consulte apt-transport-debtorrent(1).

EJEMPLOS

Usa 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

Usa 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

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

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

Usa 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

Usa HTTP para acceder al archivo de Debian en «nonus.debian.org», bajo el directorio debian-non-US.

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

Usa HTTP para acceder al archivo en «nonus.debian.org», bajo el directorio «debian-non-US», y sólo usa ficheros que se encuentren bajo unstable/binary-i386 en máquinas i386, unstable/binary-m68k en máquinas m68k, 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.de.debian.org/debian-non-US 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 2010.

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.

AUTHORS

Jason Gunthorpe

Equipo de APT

NOTES

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