.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.TH "SOURCES.LIST" "5" "04 December 2006" "" ""
.SH NAME
sources.list \- lista de recursos de paquetes para APT
.SH "DESCRIPCIóN"
.PP
La lista de recursos de paquetes se usa para localizar ficheros del sistema
de distribución de paquetes usado en el sistema.
A día de hoy, esta página del manual documenta sólamente el sistema de
paquetes usado por Debian GNU/Linux. Este fichero de control está situado en
\fI/etc/apt/sources.list\fR
.PP
La lista de procedencias está diseñada para soportar cualquier número y
distintos tipos de procedencias. El fichero lista una procedencia por línea,
con la procedencia 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 caso general de la más especifica y bien conocida
Universal Resource Locator, o URL.
El resto de la línea puede marcarse como comentario usando #.
.SH "LOS TIPOS DEB Y DEB-SRC"
.PP
El tipo deb hace referencia a un típico archivo de Debian de dos
niveles, \fIdistribución/componente\fR\&. Normalmente
distribución es stable, testing, o
unstable, mientras que componente es main,
contrib, non-free, 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\&. Es necesaria una línea
deb-src para descargar un índice de los paquetes que tienen
código fuente disponible.
.PP
El formato para una entrada en el fichero \fIsources.list\fR usando
los tipos deb y deb-src es:
.nf
deb uri distribución [componente1] [componente2] [...]
.fi
.PP
La URI para el tipo deb debe de especificar la base de
la distribución de Debian, donde APT encontrará la información que
necesita.
distribución puede especificar un ruta exacta, en cuyo caso se
deben omitir los componentes y distribución debe finalizar
con una barra (/). Esto es útil cuando únicamente queremos una sub-sección
del archivo denotado por la URI. Si distribución no especifica
la ruta exacta, al menos uno de los componentes debe de estar
presente.
.PP
distribución puede contener una variable, $(ARCH),
que se expandirá en la arquitectura de Debian usada en el sistema (i386,
m68k, powerpc, ...). Esto permite que \fIsources.list\fR sea
independiente de la arquitectura. En general esta característica sólo es
de interés cuando se especifica una ruta completa, de lo contrario
APT generará automáticamente la URI con la arquitectura actual
del sistema.
.PP
Debido a que sólo se puede especificar una distribución por línea es posible
que sea necesario tener múltiples líneas para la misma URI si deseamos
tener accesibles más de una distribución o componente de ese sitio.
APT ordenará internamente la lista de URI's después de haber generado
una copia interna, y juntará 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 algo más, y entonces restablecer la conexión
al mismo servidor. Esta característica es útil para acceder a FPT's concurridos
que limitan el número de accesos simultáneos de usuarios anónimos. APT
también paralelará conexiones a diferentes servidores para aprovechar mejor
el ancho de banda.
.PP
Es importante listar las fuente por orden de preferencia, con la fuente de más
preferencia al principio. 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).
.PP
Algunos ejemplos:
.nf
deb http://http.us.debian.org/debian stable main contrib non-free
deb http://http.us.debian.org/debian dists/stable-updates/
.fi
.SH "ESPECIFICACIóN DE LA URI"
.PP
Se reconocen los siguientes tipos de URI: cdrom, file, http, y ftp.
.TP
\fBfile\fR
file permite considerar como archivo a cualquier
fichero en el sistema de ficheros. Esto es útil para particiones
montadas mediante NFS y réplicas locales.
.TP
\fBcdrom\fR
El cdrom permite a APT usar la unidad de CDROM local. Use el
programa \fBapt-cdrom\fR(8) para añadir entradas de un cdrom a sources.list.
.TP
\fBhttp\fR
Http especifica un servidor HTTP como archivo. Si la variable de entorno
\fBhttp_proxy\fR está establecida con el formato http://server:port/,
se usará el servidor proxy especificado en \fBhttp_proxy\fR\&. Usuarios de
servidor proxy de autenticación HTTP/1.1 deberán usar la cadena de
caracteres http://user:pass@server:port/
Dese cuenta que este método de autenticación es inseguro.
.TP
\fBftp\fR
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
del manual de \fB\fIapt.conf\fB\fR(5)\&. Dese cuenta que un proxy ftp puede ser
especificado usando la variable de entorno \fBftp_proxy\fR\&. Es posible
especificar un servidor proxy http (servidores proxy http normalmente
comprenden las url's tipo ftp) usando este método y SÓLO este método.
Se ignorarán los proxies ftp especificados en el fichero de configuración que usen
http.
.TP
\fBcopy\fR
Copy es idéntico a file excepto en que los paquetes son copiados al
directorio que contiene la caché en vez de usar directamente su
lugar original. Esto es útil para gente que use discos zip con APT.
.TP
\fBrsh\fR
.TP
\fBssh\fR
El método rsh/ssh usa rsh/ssh para conectar a los servidores remotos como
un usuario dado y acceder a los ficheros. No es posible realizar ninguna
autenticación por contraseña, debe hacerse previamente una configuración
de claves RSA o rhosts.
El acceso a los ficheros del sistema remoto usa las órdenes estándar
\fBfind\fR y \fBdd\fR para realizar las transferencias.
.SH "EJEMPLOS"
.PP
Usa el archivo local (o montado mediante NFS) en /home/jason/debian
para stable/main, stable/contrib, y stable/non-free.
.nf
deb file:/home/jason/debian stable main contrib non-free
.fi
.PP
Como arriba, excepto que usa la distribución inestable.
.nf
deb file:/home/jason/debian unstable main contrib non-free
.fi
.PP
Línea para el código fuente de lo mismo que arriba
.nf
deb-src file:/home/jason/debian unstable main contrib non-free
.fi
.PP
Usa HTTP para acceder al archivo en archive.debian.org, y usa sólo la parte
de hamm/main.
.nf
deb http://archive.debian.org/debian-archive hamm main
.fi
.PP
Usa FTP para acceder al archivo en ftp.debian.org, debajo del directorio
debian, y usa sólo la parte de stable/contrib.
.nf
deb ftp://ftp.debian.org/debian stable contrib
.fi
.PP
Usa FTP para acceder al archivo en ftp.debian.org, debajo del directorio
debian, y usa sólo la parte de unstable/contrib. Si tanto esta línea como
la del ejemplo anterior aparecen en \fIsources.list\fR, se usará sólo
una sesión FTP para ambas.
.nf
deb ftp://ftp.debian.org/debian unstable contrib
.fi
.PP
Usa HTTP para acceder al archivo en nonus.debian.org, bajo el directorio
debian-non-US.
.nf
deb http://nonus.debian.org/debian-non-US stable/non-US main
contrib non-free
.fi
.PP
Usa HTTP para acceder al archivo en nonus.debian.org, bajo el directorio
debian-non-US, y usa sólo ficheros que se encuentren debajo de
\fIunstable/binary-i386\fR en máquinas i386,
\fIunstable/binary-m68k\fR en máquinas m68k, y así para todas las
arquitecturas soportadas. (Dese cuenta que este ejemplo sólo sirve para
ilustrar como se usa la variable de substitución, non-us ya no está
estructurado de este modo)
.nf
deb http://ftp.de.debian.org/debian-non-US
unstable/binary-$(ARCH)/
.fi
.SH "VéASE TAMBIéN"
.PP
\fBapt-cache\fR(8) \fB\fIapt.conf\fB\fR(5)
.SH "FALLOS"
.PP
Vea la página de fallos de APT \&.
Si desea avisar de un fallo en APT, vea
\fI/usr/share/doc/debian/bug-reporting.txt\fR o la orden \fBreportbug\fR(1)\&.
.SH "AUTOR"
.PP
APT fue escrito por el equipo de APT \&.
.SH "TRADUCTOR"
.PP
Traducción de Rubén Porras Campo