summaryrefslogtreecommitdiff
path: root/doc/es/apt.conf.es.5.sgml
diff options
context:
space:
mode:
authorMichael Vogt <michael.vogt@ubuntu.com>2009-12-10 22:20:07 +0100
committerMichael Vogt <michael.vogt@ubuntu.com>2009-12-10 22:20:07 +0100
commit43be0ac4b37f3a82ae4a16e473c3d8e44637ce1b (patch)
tree7c0e75b291d132b6f1577fc2267f8ea0a60df459 /doc/es/apt.conf.es.5.sgml
parent9307ef07498d37c0b5e05b036195abaf7ad0105c (diff)
parenta0895a74fe95997a5d75e5b54c95afb9594554f6 (diff)
merged from the mvo branch (and contains all non-abi break changes from donkult)
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>