diff options
Diffstat (limited to 'doc/es/apt.conf.es.5.sgml')
-rw-r--r-- | doc/es/apt.conf.es.5.sgml | 447 |
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::<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 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 - <debian-l10n-spanish@lists.debian.org> - </para> - </refsect1> - -</refentry> |