summaryrefslogtreecommitdiff
path: root/doc/es/apt.conf.es.5.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/es/apt.conf.es.5.sgml')
-rw-r--r--doc/es/apt.conf.es.5.sgml447
1 files changed, 0 insertions, 447 deletions
diff --git a/doc/es/apt.conf.es.5.sgml b/doc/es/apt.conf.es.5.sgml
deleted file mode 100644
index 53ff58a3d..000000000
--- a/doc/es/apt.conf.es.5.sgml
+++ /dev/null
@@ -1,447 +0,0 @@
-<!-- -*- mode: sgml; mode: fold -*- -->
-<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!ENTITY % aptent SYSTEM "apt.ent.es">
-%aptent;
-
-]>
-
-<!--
-(c) 2003 Software in the Public Interest
-Esta traducci�n ha sido realizada por Carlos Mestre <faraox@gulic.org> y
-Rub�n Porras Campo <nahoo@inicia.es>.
-Est� basada en la p�gina de manual original:
-versi�n 1.6 del CVS de
-/cvs/debian-doc/manpages/english/apt/apt.conf.5.sgml
--->
-
-<refentry lang=es>
- &apt-docinfo;
-
- <refmeta>
- <refentrytitle>apt.conf</>
- <manvolnum>5</>
- </refmeta>
-
- <!-- Man page title -->
- <refnamediv>
- <refname>apt.conf</>
- <refpurpose>Archivo de configuraci�n de APT</>
- </refnamediv>
-
- <RefSect1><Title>Descripci�n</>
- <para>
- <filename/apt.conf/ es el fichero principal de configuraci�n del conjunto de
- herramientas APT, todas las herramientas hacen uso del fichero de
- configuraci�n y un analizador com�n de sintaxis de la l�nea de �rdenes
- para proporcionar un entorno uniforme. Cuando se inicia una utilidad APT,
- este leer� la configuraci�n especificada en la variable de entorno
- <envar/APT_CONFIG/ (si existe), luego leer� los ficheos en
- <literal/Dir::Etc::Parts/, entonces leer� el fichero de configuraci�n
- principal especificado por <literal/Dir::Etc::main/, finalmente aplicar�
- las opciones de la l�nea de �rdenes para reescribir la directrices de la
- configuraci�n, posiblemente cargando incluso m�s ficheros de configuraci�n.
- <para>
- El fichero de configuraci�n est� organizado en forma de �rbol con las
- opciones organizadas en grupos funcionales. Las opciones especificadas son
- dadas con dobles dos puntos, por ejemplo <literal/APT::Get::Assume-Yes/ es
- un opci�n de la funci�n GET del conjunto de herramientas APT.
- Las opciones no son heredadas de sus grupos padres.
- <para>
- Sint�cticamente, el lenguaje de configuraci�n es modelado como en utilidades
- ISC, como bind y dhcp. Las l�neas que comienzan con <literal>//</literal> se
- tratan como comentarios (se ignoran). Cada l�nea es de la forma
- <literallayout>APT::Get::Assume-Yes "true";</literallayout> Los
- espacios entre los dos puntos son obligatorios, y las comillas son
- opcionales. Un nuevo �mbito puede abrirse con llaves, por ejemplo:
-<informalexample><programlisting>
-APT {
- Get {
- Assume-Yes "true";
- Fix-Broken "true";
- };
-};
-</programlisting></informalexample>
- con nuevas l�neas en cada lugar para hacerlo m�s legible. Las listas pueden
- crearse abriendo un nuevo �mbito e incluyendo una �nica palabra acotada
- entre comillas seguido de un punto y coma. Pueden ser incluidas m�ltiples
- entradas, cada una separada por un punto y coma.
-<informalexample><programlisting>
-DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
-</programlisting></informalexample>
- <para>
- En general, el fichero de configuraci�n de ejemplo
- <filename>&docdir;examples/apt.conf</> &configureindex; es una buena gu�a
- para entender su aspecto.
- <para>
- Se permiten dos valores especiales, <literal/#include/ y <literal/#clear/.
- <literal/#include/ incluir� el fichero dado, a menos que el final del nombre
- del fichero acabe en una barra, entonces se incluye el directorio entero.
- <literal/#clear/ se usa para suprimir la lista de nombres.
- <para>
- Todas las utilidades APT permiten la opci�n -o como una directriz
- arbitraria de configuraci�n que es especificada en la l�nea de �rdenes. La
- sintaxis es un nombre de opci�n completo (<literal/APT::Get::Assume-Yes/
- por ejemplo) seguido por signos de igualdad y el nuevo valor de la
- opci�n. Las listas tambi�n pueden ser a�adidas incluyendo :: al final del
- nombre de la lista.
- </RefSect1>
-
- <RefSect1><Title>El grupo APT</>
- <para>
- Este grupo de opciones controlan la conducta general de APT as� como el
- mantenimiento de las opciones para todas las utilidades.
- <VariableList>
- <VarListEntry><Term>Arquitectura</Term>
- <ListItem><Para>
- Arquitectura del sistema; ajusta la arquitectura a usar cuando se obtengan
- los ficheros y se analicen las listas de paquetes. El valor por defecto es
- la arquitectura para la que ha sido compilado apt.
- </VarListEntry>
-
- <VarListEntry><Term>Ignore-Hold</Term>
- <ListItem><Para>
- Ignorar paquetes retenidos: Esta opci�n global causa que el solucionador de
- problemas ignore paquetes retenidos cuando tome decisiones.
- </VarListEntry>
-
- <VarListEntry><Term>Clean-Installed</Term>
- <ListItem><Para>
- Activo por defecto. Cuando se activa la funci�n de auto-limpieza, �sta
- eliminar� cualquier paquete de la cach� que ya no pueda descargarse. Si se
- desactiva, entonces los paquetes que est�n localmente instalados son
- excluidos de la limpieza - n�tese que APT no provee ning�n medio directo
- para reinstalarlos.
- </VarListEntry>
-
- <VarListEntry><Term>Immediate-Configure</Term>
- <ListItem><Para>
- Deshabilita la configuraci�n inmediata: Esta peligrosa opci�n
- deshabilita algunas partes del c�digo de ordenaci�n de APT para inducir a �ste
- a hacer pocas llamadas a dpkg. Hacer esto podr�a ser necesario en alg�n
- sistema de usuario extremadamente lento, pero ser�a muy peligroso y
- podr�a causar que los scripts de instalaci�n del paquete fallaran o algo
- peor. �selo a su cuenta y riesgo.
- </VarListEntry>
-
- <VarListEntry><Term>Force-LoopBreak</Term>
- <ListItem><Para>
- Nunca habilite esta opci�n a menos que usted -realmente- conozca lo que
- est� haciendo. Esto permite a APT eliminar temporalmente un paquete
- esencial para romper conflictos o bucles conflictos/pre-dependencias
- entre dos paquetes esenciales. EL BUCLE NO DEBER�A EXISTIR NUNCA COMO TAL
- Y ES UN ERROR GRAVE. Esta opci�n trabajar� si el paquete esencial no es
- tar, gzip, libc, dpkg, bash o cualquier otro del que dependan estos
- paquetes.
- </VarListEntry>
-
- <VarListEntry><Term>Cache-Limit</Term>
- <ListItem><Para>
- APT usa un fichero de cach� de memoria mapeada de tama�o fijo para
- almacenar la informaci�n disponible. Esto fija el tama�o de esa cach�.
- </VarListEntry>
-
- <VarListEntry><Term>Build-Essential</Term>
- <ListItem><Para>
- Define que paquete(s) son considerados dependencias de construcci�n
- esenciales.
- </VarListEntry>
-
- <VarListEntry><Term>Get</Term>
- <ListItem><Para>
- La subsecci�n Get controla la herramienta &apt-get;, por favor, mire su
- documentaci�n para m�s informaci�n sobre esta opci�n.
- </VarListEntry>
-
- <VarListEntry><Term>Cache</Term>
- <ListItem><Para>
- La subsecci�n Cache controla la herramienta &apt-cache;, por favor, mire
- su documentaci�n para m�s informaci�n sobre esta opci�n.
- </VarListEntry>
-
- <VarListEntry><Term>CDROM</Term>
- <ListItem><Para>
- La subsecci�n CDROM controla la herramienta &apt-cdrom;, por favor, mire
- la documentaci�n para m�s informaci�n sobre esta opci�n.
- </VarListEntry>
- </VariableList>
- </RefSect1>
-
- <RefSect1><Title>El grupo Acquire</>
- <para>
- El grupo de opciones <literal/Acquire/ controla la descarga de paquetes y los
- manejadores de URI.
- <VariableList>
- <VarListEntry><Term>Queue-Mode</Term>
- <ListItem><Para>
- Modo de cola; <literal/Queue-Mode/ puede ser <literal/host/ o
- <literal/access/ que determina como paralelizar las conexiones salientes
- de APT. <literal/host/ significa que se abrir� una conexi�n
- por puesto de destino, <literal/access/ significa que ser� abierta una
- conexi�n por cada tipo de URI.
- </VarListEntry>
-
- <VarListEntry><Term>Retries</Term>
- <ListItem><Para>
- N�mero de reintentos. Si es distinto de cero APT volver� a intentar obtener
- los ficheros fallidos el n�mero de veces dado.
- </VarListEntry>
-
- <VarListEntry><Term>Source-Symlinks</Term>
- <ListItem><Para>
- Usar enlaces simb�licos para los archivos fuente. Si es true los archivos
- fuente se enlazar�n a ser posible, en vez de copiarse. Por omisi�n es true.
- </VarListEntry>
-
- <VarListEntry><Term>http</Term>
- <ListItem><Para>
- HTTP URIs; http::Proxy es el proxy http predeterminado a usar. Usa el
- formato general <literal>http://[[usuario][:clave]@]puesto[:puerto]/</>.
- Tambi�n se puede especificar un proxy por cada puesto usando la forma
- <literal/http::Proxy::&lt;puesto&gt;/ con la palabra especial <literal/DIRECT/
- queriendo decir que no se use proxy. La variable de entorno
- <envar/http_proxy/ modifica todas las preferencias.
- <para>
- Para los proxies que cumplen con HTTP/1.1 se proporcionan tres opciones de
- configuraci�n. <literal/No-Cache/ dice al proxy que no use su cach� bajo
- ninguna circunstancia, <literal/Max-Age/ s�lo se env�a para los ficheros de
- �ndice y le pide a la cach� que refresque su copia si es m�s antigua que
- un determinado n�mero de segundos. Debian actualiza sus ficheros de �ndices
- diariamente, debido a esto el valor predeterminado es 1 d�a.
- <literal/No-Store/ especifica que la cach� nunca deber� almacenar la
- petici�n, s�lo est� habilitada para los ficheros de archivo. Puede ser
- �til para prevenir que un proxy se contamine con ficheros .deb muy
- grandes. Nota: Squid 2.0.2 no soporta ninguna de estas opciones.
- <para>
- La opci�n <literal/timeout/ establece el tiempo m�ximo de espera del
- m�todo, esto se aplica a todo, incluyendo el tiempo de espera para realizar
- la conexi�n y para recibir datos.
- <para>
- Se proporciona una opci�n para controlar la profundidad de la tuber�a en
- casos en que el servidor no cumpla con RFC o tenga fallos (como pasa con
- Squid 2.0.2).
- <literal/Acquire::http::Pipeline-Depth/ puede ser un valor entre 0 y 5
- indicando cuantas peticiones sin resolver puede env�ar APT. DEBE
- especificarse si el puesto remoto no demora apropiadamente las conexiones
- TCP - de otro modo los datos se corromper�n. Los puesto que necesiten esto
- violan el RFC 2068.
- </VarListEntry>
-
- <VarListEntry><Term>ftp</Term>
- <ListItem><Para>
- FTP URIs; ftp::Proxy es el servidor proxy a usar de forma
- predeterminada. Se encuentra en el formato est�ndar
- <literal>ftp://[[usuario][:clave]@]puesto[:puerto]/</> y se modifica mediante
- la variable de entorno <envar/ftp_proxy/. Para usar un proxy ftp es
- necesario establecer el script <literal/ftp::ProxyLogin/ en el fichero de
- configuraci�n. Esta entrada especifica �rdenes que se mandan al servidor
- proxy para decirle a donde debe conectarse. Consulte &configureindex; para
- ver un ejemplo de como hacerlo. Las variables de substituci�n disponibles
- son <literal/$(PROXY_USER)/, <literal/$(PROXY_PASS)/,
- <literal/$(SITE_USER)/, <literal/$(SITE_PASS)/, <literal/$(SITE)/, y
- <literal/$(SITE_PORT)/. Cada una se toma del componete de la URI
- correspondiente.
- <para>
- La opci�n <literal/timeout/ establece el tiempo m�ximo de espera del
- m�todo, esto se aplica a todo, incluyendo el tiempo de espera para realizar
- la conexi�n y para recibir datos.
- <para>
- Se proporcionan varias opciones para controlar el modo pasivo. Generalmente
- es seguro dejar activado el modo pasivo, funciona en casi todos los
- entornos. Sin embargo algunas situaciones requieren desactivar el modo
- pasivo y usar el modo puerto e su lugar. Esto se puede hacer globalmente,
- para conexiones a trav�s de proxy o para un puesto espec�fico (Consulte el
- fichero de configuraci�n de muestra para ver ejemplos).
- <para>
- Es posible usar proxy FTP a trav�s de HTTP estableciendo la variable de
- entorno <envar/ftp_proxy/ a una direcci�n http - mire la discusi�n del
- m�todo http de arriba para la sintaxis. No se puede habilitar en el fichero
- de configuraci�n y no se recomienda su uso debido a su poca eficiencia.
- <para>
- La opci�n <literal/ForceExtended/ controla el uso de las �rdenes de RFC2428
- <literal/EPSV/ y <literal/EPRT/. Por omisi�n es false, que quiere decir que
- s�lo se usan si el control de conexi�n es IPv6. Poni�ndolo a true fuerza su
- uso incluso en conexiones IPv4. Dese cuenta que la mayor�a de los
- servidores FTP no soportan RFC2428.
- </VarListEntry>
-
- <VarListEntry><Term>cdrom</Term>
- <ListItem><Para>
- CDROM URIs; la �nica opci�n de configuraci�n para los CDROM es el punto de
- montaje, <literal/cdrom::Mount/ debe ser el punto de montaje de la unidad
- de CDROM tal y como se especifica en <filename>/etc/fstab</>. Es posible
- proporcionar �rdenes mount y unmount alternativas si el punto de montaje no
- puede especificarse en fstab (como con SMB y versiones de mount
- antiguas). Respecto a la sintaxis se pone <literallayout>"/cdrom/"::Mount
- "tal";</literallayout> dentro del bloque cdrom. Es importante no tener una
- barra final. Las �rdenes de unmount pueden especificarse usando UMount.
- </VarListEntry>
- </VariableList>
- </RefSect1>
-
- <RefSect1><Title>Directorios</>
- <para>
- La secci�n <literal/Dir::State/ contiene directorios que pertenecen a
- informaci�n del estado local. <literal/lists/ es el directorio donde se
- almacenan las listas de paquetes descargados y <literal/status/ es el nombre
- del fichero de estado de dpkg.
- <literal/preferences/ es el nombre del fichero de preferencias de APT.
- <literal/Dir::State/ contiene el directorio que se usar� como prefijo por
- omisi�n en todas las opciones restantes en caso de que no empiezen con
- <filename>/</> o <filename>./</>.
- <para>
- <literal/Dir::Cache/ contiene lugares pertenecientes a informaci�n de la
- cach� local, como las dos cach�s de paquetes <literal/srcpkgcache/ y
- <literal/pkgcache/ o como el lugar donde se guardan los ficheros descargados,
- <literal/Dir::Cache::archives/. La generaci�n de cach�s puede desactivarse
- dejando sus nombres en blanco. �sto enlentecer� el arranque pero ahorrar�
- espacio. Normalmente se prefiere deshabilitar pkgcache en vez de
- srcpkgcache. Al igual que con <literal/Dir::State/ el directorio
- predeterminado est� en <literal/Dir::Cache/
- <para>
- <literal/Dir::Etc/ contiene el lugar de los ficheros de configuraci�n,
- <literal/sourcelist/ contiene el lugar de sourcelist y <literal/main/ es el
- fichero de configuraci�n predeterminado (esta opci�n de configuraci�n no
- tiene ning�n efecto a menos que se realice desde el fichero de configuraci�n
- especificado por <envar/APT_CONFIG/).
- <para>
- La opci�n <literal/Dir::Parts/ lee en todos los fragementos de configuraci�n
- en orden l�xico <!--�Y esto qu� es?--> desde el directorio
- especificado. Despu�s de esto se carga el fichero principal de configuraci�n.
- <para>
- <literal/Dir::Bin/ apunta a los programas
- binarios. <literal/Dir::Bin::Methods/ especifica la localizaci�n de los
- manejadores de los m�todos y <literal/gzip/, <literal/dpkg/,
- <literal/apt-get/, <literal/dpkg-source/, <literal/dpkg-buildpackage/ y
- <literal/apt-cache/ especifican la localizaci�n de los respectivos programas.
- </RefSect1>
-
- <RefSect1><Title>APT con DSelect</>
- <para>
- Cuando APT se usa como m�todo de &dselect; varias directivas de configuraci�n
- controlan el comportamiento predeterminado. Se encuentran en la secci�n
- <literal/DSelect/.
-
- <VariableList>
- <VarListEntry><Term>Clean</Term>
- <ListItem><Para>
- Modo de borrado de cach�; este valor puede ser always, prompt, auto,
- pre-auto y never. always y prompt borrar�n todos los paquetes de la cach�
- despu�s de actualizar, prompt (predeterminado) pregunta primero.
- auto borra s�lo aquellos paquetes que ya no se pueden descargar (han sido
- reemplazados por otra versi�n, por ejemplo). pre-auto realiza esta �ltima
- acci�n antes de descargar los paquetes nuevos.
- </VarListEntry>
-
- <VarListEntry><Term>Options</Term>
- <ListItem><Para>
- El contenido de esta variable se pasa a &apt-get; como opciones de l�nea de
- ordenes cuando se ejecuta en la fase de instalaci�n.
- </VarListEntry>
-
- <VarListEntry><Term>UpdateOptions</Term>
- <ListItem><Para>
- El contenido de esta variable se pasa a &apt-get; como opciones de l�nea de
- ordenes cuando se ejecuta en la fase de actualizaci�n.
- </VarListEntry>
-
- <VarListEntry><Term>PromptAfterUpdate</Term>
- <ListItem><Para>
- Si es true la operaci�n de [U]pdate en &dselect; preguntar� siempre antes
- de continuar. Por omisi�n s�lo pregunta en caso de error.
- </VarListEntry>
- </VariableList>
- </RefSect1>
-
- <RefSect1><Title>Como APT llama a dpkg</>
- <para>
- Varias directivas de configuraci�n controlan como APT llama a &dpkg;. Se
- encuentran en la secci�n <literal/DPkg/.
-
- <VariableList>
- <VarListEntry><Term>Options</Term>
- <ListItem><Para>
- Lista de opciones que se pasan a dpkg. Las opciones deben especificarse
- usando la notaci�n de lista y cada elemento de la lista se pasa a &dpkg;
- como un s�lo argumento.
- </VarListEntry>
-
- <VarListEntry><Term>Pre-Invoke</Term><Term>Post-Invoke</Term>
- <ListItem><Para>
- Es una lista de �rdenes de shell que se ejecutar�n antes de llamar a
- &dpkg;. Como <literal/Options/, debe de especificarse con notaci�n de
- lista. Las �rdenes se ejecutan en orden usando <filename>/bin/sh</>, si
- alguna falla APT abortar�.
- </VarListEntry>
-
- <VarListEntry><Term>Pre-Install-Pkgs</Term>
- <ListItem><Para>
- Lista de �rdenes de shell que se ejecutar�n antes de llamar a
- &dpkg;. Como <literal/Options/, debe de especificarse con notaci�n de
- lista. Las �rdenes se ejecutan en orden usando <filename>/bin/sh</>, si
- alguna falla APT abortar�. APT pasar� a los programas los nombres de
- fichero de todos los .deb que va ha instalar por la entrada est�ndar, uno
- por l�nea.
- <para>
- La versi�n 2 de este protocolo vuelca m�s informaci�n, incluyendo la
- versi�n del protocolo, el espacio de configuraci�n de APT <!--Esto suena
- raro-->, los ficheros y versiones que cambian. La versi�n 2 se habilita
- estableciendo <literal/DPkg::Tools::Options::cmd::Version/ a
- 2. <literal/cmd/ es una orden dada a <literal/Pre-Install-Pkgs/.
- </VarListEntry>
-
- <VarListEntry><Term>Run-Directory</Term>
- <ListItem><Para>
- APT hace que �ste sea su directorio de trabajo antes de llamar a dpkg, por
- omisi�n es <filename>/</>.
- </VarListEntry>
-
- <VarListEntry><Term>Build-Options</Term>
- <ListItem><Para>
- �stas opciones se pasan a &dpkg-buildpackage; cuando compila paquetes,
- por omisi�n se limita a deshabilitar el firmado de paquetes y producir
- todos los binarios.
- </VarListEntry>
- </VariableList>
- </RefSect1>
-
- <RefSect1><Title>Opciones de depuraci�n</>
- <para>
- La mayor�a de las opciones de la secci�n <literal/debug/ no son interesantes
- para el usuario normal, sin embargo <literal/Debug::pkgProblemResolver/
- muestra una salida interesante acerca de las decisiones que realiza
- dist-upgrade. <literal/Debug::NoLocking/ deshabilita el bloqueo de fichero de
- forma que APT puede realizar algunas operaciones sin permisos de superusuario
- y <literal/Debug::pkgDPkgPM/ mostrar� la l�nea de �rdenes para cada llamada a
- dpkg. <literal/Debug::IdentCdrom/ deshabilitar� la inclusi�n de datos de
- statfs <!--��sto es correcto-->en los ID's de los CDROM.
- </RefSect1>
-
- <RefSect1><Title>Ejemplos</>
- <para>
- &configureindex; contiene un fichero de configuraci�n de ejemplo mostrando
- los valores predeterminados para todas las opciones posibles.
- </RefSect1>
-
- <RefSect1><Title>Ficheros</>
- <para>
- <filename>/etc/apt/apt.conf</>
- </RefSect1>
-
- <RefSect1><Title>V�ase tambi�n</>
- <para>
- &apt-cache;, &apt-config;<!-- ? reading apt.conf -->, &apt-preferences;.
- </RefSect1>
-
- &manbugs;
- &manauthor;
-
- <refsect1>
- <title>TRADUCTOR</title>
- <para>
- Traducci�n de Rub�n Porras Campo
- &lt;debian-l10n-spanish@lists.debian.org&gt;
- </para>
- </refsect1>
-
-</refentry>