1
<!-- -*- mode: sgml; mode: fold -*- -->
2
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
4
<!ENTITY % aptent SYSTEM "apt.ent.es">
10
(c) 2003 Software in the Public Interest
11
Esta traducci�n ha sido realizada por Carlos Mestre <faraox@gulic.org> y
12
Rub�n Porras Campo <nahoo@inicia.es>.
13
Est� basada en la p�gina de manual original:
14
versi�n 1.6 del CVS de
15
/cvs/debian-doc/manpages/english/apt/apt.conf.5.sgml
22
<refentrytitle>apt.conf</>
26
<!-- Man page title -->
29
<refpurpose>Archivo de configuraci�n de APT</>
32
<RefSect1><Title>Descripci�n</>
34
<filename/apt.conf/ es el fichero principal de configuraci�n del conjunto de
35
herramientas APT, todas las herramientas hacen uso del fichero de
36
configuraci�n y un analizador com�n de sintaxis de la l�nea de �rdenes
37
para proporcionar un entorno uniforme. Cuando se inicia una utilidad APT,
38
este leer� la configuraci�n especificada en la variable de entorno
39
<envar/APT_CONFIG/ (si existe), luego leer� los ficheos en
40
<literal/Dir::Etc::Parts/, entonces leer� el fichero de configuraci�n
41
principal especificado por <literal/Dir::Etc::main/, finalmente aplicar�
42
las opciones de la l�nea de �rdenes para reescribir la directrices de la
43
configuraci�n, posiblemente cargando incluso m�s ficheros de configuraci�n.
45
El fichero de configuraci�n est� organizado en forma de �rbol con las
46
opciones organizadas en grupos funcionales. Las opciones especificadas son
47
dadas con dobles dos puntos, por ejemplo <literal/APT::Get::Assume-Yes/ es
48
un opci�n de la funci�n GET del conjunto de herramientas APT.
49
Las opciones no son heredadas de sus grupos padres.
51
Sint�cticamente, el lenguaje de configuraci�n es modelado como en utilidades
52
ISC, como bind y dhcp. Las l�neas que comienzan con <literal>//</literal> se
53
tratan como comentarios (se ignoran). Cada l�nea es de la forma
54
<literallayout>APT::Get::Assume-Yes "true";</literallayout> Los
55
espacios entre los dos puntos son obligatorios, y las comillas son
56
opcionales. Un nuevo �mbito puede abrirse con llaves, por ejemplo:
57
<informalexample><programlisting>
64
</programlisting></informalexample>
65
con nuevas l�neas en cada lugar para hacerlo m�s legible. Las listas pueden
66
crearse abriendo un nuevo �mbito e incluyendo una �nica palabra acotada
67
entre comillas seguido de un punto y coma. Pueden ser incluidas m�ltiples
68
entradas, cada una separada por un punto y coma.
69
<informalexample><programlisting>
70
DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
71
</programlisting></informalexample>
73
En general, el fichero de configuraci�n de ejemplo
74
<filename>&docdir;examples/apt.conf</> &configureindex; es una buena gu�a
75
para entender su aspecto.
77
Se permiten dos valores especiales, <literal/#include/ y <literal/#clear/.
78
<literal/#include/ incluir� el fichero dado, a menos que el final del nombre
79
del fichero acabe en una barra, entonces se incluye el directorio entero.
80
<literal/#clear/ se usa para suprimir la lista de nombres.
82
Todas las utilidades APT permiten la opci�n -o como una directriz
83
arbitraria de configuraci�n que es especificada en la l�nea de �rdenes. La
84
sintaxis es un nombre de opci�n completo (<literal/APT::Get::Assume-Yes/
85
por ejemplo) seguido por signos de igualdad y el nuevo valor de la
86
opci�n. Las listas tambi�n pueden ser a�adidas incluyendo :: al final del
90
<RefSect1><Title>El grupo APT</>
92
Este grupo de opciones controlan la conducta general de APT as� como el
93
mantenimiento de las opciones para todas las utilidades.
95
<VarListEntry><Term>Arquitectura</Term>
97
Arquitectura del sistema; ajusta la arquitectura a usar cuando se obtengan
98
los ficheros y se analicen las listas de paquetes. El valor por defecto es
99
la arquitectura para la que ha sido compilado apt.
102
<VarListEntry><Term>Ignore-Hold</Term>
104
Ignorar paquetes retenidos: Esta opci�n global causa que el solucionador de
105
problemas ignore paquetes retenidos cuando tome decisiones.
108
<VarListEntry><Term>Clean-Installed</Term>
110
Activo por defecto. Cuando se activa la funci�n de auto-limpieza, �sta
111
eliminar� cualquier paquete de la cach� que ya no pueda descargarse. Si se
112
desactiva, entonces los paquetes que est�n localmente instalados son
113
excluidos de la limpieza - n�tese que APT no provee ning�n medio directo
117
<VarListEntry><Term>Immediate-Configure</Term>
119
Deshabilita la configuraci�n inmediata: Esta peligrosa opci�n
120
deshabilita algunas partes del c�digo de ordenaci�n de APT para inducir a �ste
121
a hacer pocas llamadas a dpkg. Hacer esto podr�a ser necesario en alg�n
122
sistema de usuario extremadamente lento, pero ser�a muy peligroso y
123
podr�a causar que los scripts de instalaci�n del paquete fallaran o algo
124
peor. �selo a su cuenta y riesgo.
127
<VarListEntry><Term>Force-LoopBreak</Term>
129
Nunca habilite esta opci�n a menos que usted -realmente- conozca lo que
130
est� haciendo. Esto permite a APT eliminar temporalmente un paquete
131
esencial para romper conflictos o bucles conflictos/pre-dependencias
132
entre dos paquetes esenciales. EL BUCLE NO DEBER�A EXISTIR NUNCA COMO TAL
133
Y ES UN ERROR GRAVE. Esta opci�n trabajar� si el paquete esencial no es
134
tar, gzip, libc, dpkg, bash o cualquier otro del que dependan estos
138
<VarListEntry><Term>Cache-Limit</Term>
140
APT usa un fichero de cach� de memoria mapeada de tama�o fijo para
141
almacenar la informaci�n disponible. Esto fija el tama�o de esa cach�.
144
<VarListEntry><Term>Build-Essential</Term>
146
Define que paquete(s) son considerados dependencias de construcci�n
150
<VarListEntry><Term>Get</Term>
152
La subsecci�n Get controla la herramienta &apt-get;, por favor, mire su
153
documentaci�n para m�s informaci�n sobre esta opci�n.
156
<VarListEntry><Term>Cache</Term>
158
La subsecci�n Cache controla la herramienta &apt-cache;, por favor, mire
159
su documentaci�n para m�s informaci�n sobre esta opci�n.
162
<VarListEntry><Term>CDROM</Term>
164
La subsecci�n CDROM controla la herramienta &apt-cdrom;, por favor, mire
165
la documentaci�n para m�s informaci�n sobre esta opci�n.
170
<RefSect1><Title>El grupo Acquire</>
172
El grupo de opciones <literal/Acquire/ controla la descarga de paquetes y los
175
<VarListEntry><Term>Queue-Mode</Term>
177
Modo de cola; <literal/Queue-Mode/ puede ser <literal/host/ o
178
<literal/access/ que determina como paralelizar las conexiones salientes
179
de APT. <literal/host/ significa que se abrir� una conexi�n
180
por puesto de destino, <literal/access/ significa que ser� abierta una
181
conexi�n por cada tipo de URI.
184
<VarListEntry><Term>Retries</Term>
186
N�mero de reintentos. Si es distinto de cero APT volver� a intentar obtener
187
los ficheros fallidos el n�mero de veces dado.
190
<VarListEntry><Term>Source-Symlinks</Term>
192
Usar enlaces simb�licos para los archivos fuente. Si es true los archivos
193
fuente se enlazar�n a ser posible, en vez de copiarse. Por omisi�n es true.
196
<VarListEntry><Term>http</Term>
198
HTTP URIs; http::Proxy es el proxy http predeterminado a usar. Usa el
199
formato general <literal>http://[[usuario][:clave]@]puesto[:puerto]/</>.
200
Tambi�n se puede especificar un proxy por cada puesto usando la forma
201
<literal/http::Proxy::<puesto>/ con la palabra especial <literal/DIRECT/
202
queriendo decir que no se use proxy. La variable de entorno
203
<envar/http_proxy/ modifica todas las preferencias.
205
Para los proxies que cumplen con HTTP/1.1 se proporcionan tres opciones de
206
configuraci�n. <literal/No-Cache/ dice al proxy que no use su cach� bajo
207
ninguna circunstancia, <literal/Max-Age/ s�lo se env�a para los ficheros de
208
�ndice y le pide a la cach� que refresque su copia si es m�s antigua que
209
un determinado n�mero de segundos. Debian actualiza sus ficheros de �ndices
210
diariamente, debido a esto el valor predeterminado es 1 d�a.
211
<literal/No-Store/ especifica que la cach� nunca deber� almacenar la
212
petici�n, s�lo est� habilitada para los ficheros de archivo. Puede ser
213
�til para prevenir que un proxy se contamine con ficheros .deb muy
214
grandes. Nota: Squid 2.0.2 no soporta ninguna de estas opciones.
216
La opci�n <literal/timeout/ establece el tiempo m�ximo de espera del
217
m�todo, esto se aplica a todo, incluyendo el tiempo de espera para realizar
218
la conexi�n y para recibir datos.
220
Se proporciona una opci�n para controlar la profundidad de la tuber�a en
221
casos en que el servidor no cumpla con RFC o tenga fallos (como pasa con
223
<literal/Acquire::http::Pipeline-Depth/ puede ser un valor entre 0 y 5
224
indicando cuantas peticiones sin resolver puede env�ar APT. DEBE
225
especificarse si el puesto remoto no demora apropiadamente las conexiones
226
TCP - de otro modo los datos se corromper�n. Los puesto que necesiten esto
230
<VarListEntry><Term>ftp</Term>
232
FTP URIs; ftp::Proxy es el servidor proxy a usar de forma
233
predeterminada. Se encuentra en el formato est�ndar
234
<literal>ftp://[[usuario][:clave]@]puesto[:puerto]/</> y se modifica mediante
235
la variable de entorno <envar/ftp_proxy/. Para usar un proxy ftp es
236
necesario establecer el script <literal/ftp::ProxyLogin/ en el fichero de
237
configuraci�n. Esta entrada especifica �rdenes que se mandan al servidor
238
proxy para decirle a donde debe conectarse. Consulte &configureindex; para
239
ver un ejemplo de como hacerlo. Las variables de substituci�n disponibles
240
son <literal/$(PROXY_USER)/, <literal/$(PROXY_PASS)/,
241
<literal/$(SITE_USER)/, <literal/$(SITE_PASS)/, <literal/$(SITE)/, y
242
<literal/$(SITE_PORT)/. Cada una se toma del componete de la URI
245
La opci�n <literal/timeout/ establece el tiempo m�ximo de espera del
246
m�todo, esto se aplica a todo, incluyendo el tiempo de espera para realizar
247
la conexi�n y para recibir datos.
249
Se proporcionan varias opciones para controlar el modo pasivo. Generalmente
250
es seguro dejar activado el modo pasivo, funciona en casi todos los
251
entornos. Sin embargo algunas situaciones requieren desactivar el modo
252
pasivo y usar el modo puerto e su lugar. Esto se puede hacer globalmente,
253
para conexiones a trav�s de proxy o para un puesto espec�fico (Consulte el
254
fichero de configuraci�n de muestra para ver ejemplos).
256
Es posible usar proxy FTP a trav�s de HTTP estableciendo la variable de
257
entorno <envar/ftp_proxy/ a una direcci�n http - mire la discusi�n del
258
m�todo http de arriba para la sintaxis. No se puede habilitar en el fichero
259
de configuraci�n y no se recomienda su uso debido a su poca eficiencia.
261
La opci�n <literal/ForceExtended/ controla el uso de las �rdenes de RFC2428
262
<literal/EPSV/ y <literal/EPRT/. Por omisi�n es false, que quiere decir que
263
s�lo se usan si el control de conexi�n es IPv6. Poni�ndolo a true fuerza su
264
uso incluso en conexiones IPv4. Dese cuenta que la mayor�a de los
265
servidores FTP no soportan RFC2428.
268
<VarListEntry><Term>cdrom</Term>
270
CDROM URIs; la �nica opci�n de configuraci�n para los CDROM es el punto de
271
montaje, <literal/cdrom::Mount/ debe ser el punto de montaje de la unidad
272
de CDROM tal y como se especifica en <filename>/etc/fstab</>. Es posible
273
proporcionar �rdenes mount y unmount alternativas si el punto de montaje no
274
puede especificarse en fstab (como con SMB y versiones de mount
275
antiguas). Respecto a la sintaxis se pone <literallayout>"/cdrom/"::Mount
276
"tal";</literallayout> dentro del bloque cdrom. Es importante no tener una
277
barra final. Las �rdenes de unmount pueden especificarse usando UMount.
282
<RefSect1><Title>Directorios</>
284
La secci�n <literal/Dir::State/ contiene directorios que pertenecen a
285
informaci�n del estado local. <literal/lists/ es el directorio donde se
286
almacenan las listas de paquetes descargados y <literal/status/ es el nombre
287
del fichero de estado de dpkg.
288
<literal/preferences/ es el nombre del fichero de preferencias de APT.
289
<literal/Dir::State/ contiene el directorio que se usar� como prefijo por
290
omisi�n en todas las opciones restantes en caso de que no empiezen con
291
<filename>/</> o <filename>./</>.
293
<literal/Dir::Cache/ contiene lugares pertenecientes a informaci�n de la
294
cach� local, como las dos cach�s de paquetes <literal/srcpkgcache/ y
295
<literal/pkgcache/ o como el lugar donde se guardan los ficheros descargados,
296
<literal/Dir::Cache::archives/. La generaci�n de cach�s puede desactivarse
297
dejando sus nombres en blanco. �sto enlentecer� el arranque pero ahorrar�
298
espacio. Normalmente se prefiere deshabilitar pkgcache en vez de
299
srcpkgcache. Al igual que con <literal/Dir::State/ el directorio
300
predeterminado est� en <literal/Dir::Cache/
302
<literal/Dir::Etc/ contiene el lugar de los ficheros de configuraci�n,
303
<literal/sourcelist/ contiene el lugar de sourcelist y <literal/main/ es el
304
fichero de configuraci�n predeterminado (esta opci�n de configuraci�n no
305
tiene ning�n efecto a menos que se realice desde el fichero de configuraci�n
306
especificado por <envar/APT_CONFIG/).
308
La opci�n <literal/Dir::Parts/ lee en todos los fragementos de configuraci�n
309
en orden l�xico <!--�Y esto qu� es?--> desde el directorio
310
especificado. Despu�s de esto se carga el fichero principal de configuraci�n.
312
<literal/Dir::Bin/ apunta a los programas
313
binarios. <literal/Dir::Bin::Methods/ especifica la localizaci�n de los
314
manejadores de los m�todos y <literal/gzip/, <literal/dpkg/,
315
<literal/apt-get/, <literal/dpkg-source/, <literal/dpkg-buildpackage/ y
316
<literal/apt-cache/ especifican la localizaci�n de los respectivos programas.
319
<RefSect1><Title>APT con DSelect</>
321
Cuando APT se usa como m�todo de &dselect; varias directivas de configuraci�n
322
controlan el comportamiento predeterminado. Se encuentran en la secci�n
326
<VarListEntry><Term>Clean</Term>
328
Modo de borrado de cach�; este valor puede ser always, prompt, auto,
329
pre-auto y never. always y prompt borrar�n todos los paquetes de la cach�
330
despu�s de actualizar, prompt (predeterminado) pregunta primero.
331
auto borra s�lo aquellos paquetes que ya no se pueden descargar (han sido
332
reemplazados por otra versi�n, por ejemplo). pre-auto realiza esta �ltima
333
acci�n antes de descargar los paquetes nuevos.
336
<VarListEntry><Term>Options</Term>
338
El contenido de esta variable se pasa a &apt-get; como opciones de l�nea de
339
ordenes cuando se ejecuta en la fase de instalaci�n.
342
<VarListEntry><Term>UpdateOptions</Term>
344
El contenido de esta variable se pasa a &apt-get; como opciones de l�nea de
345
ordenes cuando se ejecuta en la fase de actualizaci�n.
348
<VarListEntry><Term>PromptAfterUpdate</Term>
350
Si es true la operaci�n de [U]pdate en &dselect; preguntar� siempre antes
351
de continuar. Por omisi�n s�lo pregunta en caso de error.
356
<RefSect1><Title>Como APT llama a dpkg</>
358
Varias directivas de configuraci�n controlan como APT llama a &dpkg;. Se
359
encuentran en la secci�n <literal/DPkg/.
362
<VarListEntry><Term>Options</Term>
364
Lista de opciones que se pasan a dpkg. Las opciones deben especificarse
365
usando la notaci�n de lista y cada elemento de la lista se pasa a &dpkg;
366
como un s�lo argumento.
369
<VarListEntry><Term>Pre-Invoke</Term><Term>Post-Invoke</Term>
371
Es una lista de �rdenes de shell que se ejecutar�n antes de llamar a
372
&dpkg;. Como <literal/Options/, debe de especificarse con notaci�n de
373
lista. Las �rdenes se ejecutan en orden usando <filename>/bin/sh</>, si
374
alguna falla APT abortar�.
377
<VarListEntry><Term>Pre-Install-Pkgs</Term>
379
Lista de �rdenes de shell que se ejecutar�n antes de llamar a
380
&dpkg;. Como <literal/Options/, debe de especificarse con notaci�n de
381
lista. Las �rdenes se ejecutan en orden usando <filename>/bin/sh</>, si
382
alguna falla APT abortar�. APT pasar� a los programas los nombres de
383
fichero de todos los .deb que va ha instalar por la entrada est�ndar, uno
386
La versi�n 2 de este protocolo vuelca m�s informaci�n, incluyendo la
387
versi�n del protocolo, el espacio de configuraci�n de APT <!--Esto suena
388
raro-->, los ficheros y versiones que cambian. La versi�n 2 se habilita
389
estableciendo <literal/DPkg::Tools::Options::cmd::Version/ a
390
2. <literal/cmd/ es una orden dada a <literal/Pre-Install-Pkgs/.
393
<VarListEntry><Term>Run-Directory</Term>
395
APT hace que �ste sea su directorio de trabajo antes de llamar a dpkg, por
396
omisi�n es <filename>/</>.
399
<VarListEntry><Term>Build-Options</Term>
401
�stas opciones se pasan a &dpkg-buildpackage; cuando compila paquetes,
402
por omisi�n se limita a deshabilitar el firmado de paquetes y producir
408
<RefSect1><Title>Opciones de depuraci�n</>
410
La mayor�a de las opciones de la secci�n <literal/debug/ no son interesantes
411
para el usuario normal, sin embargo <literal/Debug::pkgProblemResolver/
412
muestra una salida interesante acerca de las decisiones que realiza
413
dist-upgrade. <literal/Debug::NoLocking/ deshabilita el bloqueo de fichero de
414
forma que APT puede realizar algunas operaciones sin permisos de superusuario
415
y <literal/Debug::pkgDPkgPM/ mostrar� la l�nea de �rdenes para cada llamada a
416
dpkg. <literal/Debug::IdentCdrom/ deshabilitar� la inclusi�n de datos de
417
statfs <!--��sto es correcto-->en los ID's de los CDROM.
420
<RefSect1><Title>Ejemplos</>
422
&configureindex; contiene un fichero de configuraci�n de ejemplo mostrando
423
los valores predeterminados para todas las opciones posibles.
426
<RefSect1><Title>Ficheros</>
428
<filename>/etc/apt/apt.conf</>
431
<RefSect1><Title>V�ase tambi�n</>
433
&apt-cache;, &apt-config;<!-- ? reading apt.conf -->, &apt-preferences;.
440
<title>TRADUCTOR</title>
442
Traducci�n de Rub�n Porras Campo
443
<debian-l10n-spanish@lists.debian.org>