diff options
Diffstat (limited to 'doc/es/apt.conf.es.5.sgml')
| -rw-r--r-- | doc/es/apt.conf.es.5.sgml | 446 |
1 files changed, 446 insertions, 0 deletions
diff --git a/doc/es/apt.conf.es.5.sgml b/doc/es/apt.conf.es.5.sgml new file mode 100644 index 000000000..2df76687c --- /dev/null +++ b/doc/es/apt.conf.es.5.sgml @@ -0,0 +1,446 @@ +<!-- -*- 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.5 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 de padres. + <para> + Sintácticamente, el lenguaje de configuración es modelado como en utilidades + ISC, como bind y dhcp. Cada línea es de la forma + <literallayout>APT::Get::Assume-Yes "true";</literallayout>. Los + espacios entre los dos puntos son requeridos, y las comillas son + opcionales. Un nuevo ámbito puede ser abierto con las llaves, como: +<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, un ejemplo del fichero de configuración + <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 + excluido 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 de las clasificaciones de código 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 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 paquete 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::<puesto>/ 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 un valor de cero 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 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 ordenes 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 + <debian-l10n-spanish@lists.debian.org> + </para> + </refsect1> + +</refentry> |