summaryrefslogtreecommitdiff
path: root/doc/es/apt.conf.es.5.sgml
blob: 53ff58a3d77ed0d29eb60616e52de2a519220b4c (plain)
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::&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>