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

The /etc/apt/sources.list.d directory provides a way to add sources.list entries in separate files. The format is the same as for the regular sources.list file. File names need to end with .list and may only contain letters (a-z and A-Z), digits (0-9), underscore (_), hyphen (-) and period (.) characters. Otherwise APT will print a notice that it has ignored a file if the file doesn't match a pattern in the Dir::Ignore-Files-Silently configuration list - in this case it will be silently ignored.

LOS TIPOS «DEB» Y «DEB-SRC»

The deb type describes a typical two-level Debian archive, distribution/component. Typically, distribution is generally an archivename like stable or testing or a codename like squeeze or wheezy while component is one of main contrib or non-free. The deb-src type describes a debian distribution's source code in the same form as the deb type. A deb-src line is required to fetch source indexes.

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

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

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.

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.

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

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

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

Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe directory, and uses only files found under unstable/binary-i386 on i386 machines, unstable/binary-amd64 on amd64, and so forth for other supported architectures. [Note this example only illustrates how to use the substitution variable; official debian archives are not structured like this]

    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 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