1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
|
<!-- -*- 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>
|