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 Rub�n Porras Campo <nahoo@inicia.es>
12
y revisada por Javier Fern�ndez-Sanguino <jfs@computer.org>
13
Est� basada en la p�gina de manual original:
14
versi�n 1.5 del CVS de
15
/cvs/debian-doc/manpages/english/apt/apt_preferences.5.sgml
22
<refentrytitle>apt_preferences</>
26
<!-- Man page title -->
28
<refname>apt_preferences</>
29
<refpurpose>Fichero de preferencias de APT</>
33
<Title>Descripci�n</Title>
35
El fichero de preferencias de APT <filename>/etc/apt/preferences</>
36
se puede usar para controlar las versiones de los paquetes seleccionados.
39
<para>Cuando el fichero &sources-list; contiene referencias a m�s de una
40
distribuci�n (por ejemplo, <literal>estable</literal> y <literal>pruebas
41
</literal>). APT asigna una prioridad a cada versi�n disponible.
42
Limitado por las dependencias, <command>apt-get</command> selecciona la versi�n
46
<para>El fichero de preferencias de APT modifica las prioridades asignadas por
47
APT, dando control al usuario sobre que ejemplar se seleccionar� para la
51
Puede est�n disponibles varios ejemplares de la misma versi�n de un paquete
52
cuando el fichero &sources-list; contenga referencias a m�s de una fuente. En
53
este caso <command>apt-get</command> descarga el ejemplar que aparezca listado
54
primero en el fichero &sources-list;. El fichero de preferencias de APT no
55
modifica la elecci�n del ejemplar, s�lo la elecci�n de la versi�n.
57
<RefSect2><Title>�C�mo asigna APT las prioridades?</>
59
<para>Si no existe el fichero de preferencias o no hay ninguna entrada en �ste
60
que se pueda aplicar a una determinada versi�n, se asigna a la versi�n la
61
prioridad de la distribuci�n a la que pertenece. Es posible seleccionar una
62
distribuci�n, >>distribuci�n objetivo<<
63
(n. t. del ingl�s <emphasis>target release</emphasis>), que recibe
64
una prioridad mayor que el resto. La distribuci�n objetivo se puede definir
65
en la l�nea de �rdenes al ejecutar <command>apt-get</command> o en el fichero
66
de configuraci�n de APT (<filename>/etc/apt/apt.conf</filename>).
69
<command>apt-get install -t testing <replaceable>paquete</replaceable></command>
72
APT::Default-Release "stable";
77
Si se ha especificado una distribuci�n objetivo, APT usa el siguiente
78
algoritmo para establecer las prioridades de cada versi�n de un paquete.
83
<term>prioridad 100</term>
84
<listitem><simpara>a la versi�n instalada (si existe).</simpara></listitem>
87
<term>prioridad 500</term>
88
<listitem><simpara>a la versi�n que ni est� instalada ni pertenece a la
89
distribuci�n objetivo.</simpara></listitem>
92
<term>prioridad 990</term>
93
<listitem><simpara>a las versiones que no est�n instaladas pero que
94
pertenecen a la distribuci�n objetivo.</simpara></listitem>
100
Si no se especifica ninguna distribuci�n objetivo APT asigna prioridad 100 a
101
todas las versiones de los paquetes instalados y 500 al resto.
105
APT aplica las siguientes normas, expuestas por orden de precedencia,
106
para determinar qu� versi�n del paquete debe instalar.
109
<listitem><simpara>Nunca instalar una versi�n anterior de un paquete en lugar
110
de la instalada a menos que la prioridad de la versi�n disponible supere 1000
111
(Dese cuenta que ninguna de las prioridades que asigna APT por omisi�n superan
112
1000, �stas prioridades s�lo se pueden establecer mediante el fichero de
113
preferencias. Tenga en consideraci�n que instalar una versi�n anterior del
114
paquete puede ser peligroso).
115
</simpara></listitem>
116
<listitem><simpara>Instalar la versi�n de mayor prioridad.
117
</simpara></listitem>
118
<listitem><simpara>Si dos o m�s versiones tienen la misma prioridad,
119
instala la m�s reciente (esto es, la que tiene un n�mero de versi�n mayor).
120
</simpara></listitem>
121
<listitem><simpara>Si dos o m�s versiones tienen la misma prioridad y n�mero de
122
versi�n, pero o bien difieren en su meta-informaci�n o se ha proporcionado la
123
opci�n <literal/--reinstall/ se instala la que no est� instalada.
124
</simpara></listitem>
129
T�picamente, la versi�n instalada del paquete (prioridad 100)
130
no es tan reciente como la disponible a trav�s de &sources-list;
131
(prioridad 500 o 990). Entonces el paquete se actualizar� cuando se ejecute
132
<command>apt-get install <replaceable>alg�n-paquete</replaceable></command> o
133
<command>apt-get upgrade</command>.
136
<para>Rara vez la versi�n instalada de un paquete es <emphasis/m�s/ reciente
137
que cualquiera de las versiones disponibles. En �ste caso no se instalar� la
138
versi�n anterior del paquete cuando se ejecute <command>apt-get install
139
<replaceable>alg�n-paquete</replaceable></command> o <command>apt-get
144
A veces la versi�n instalada de un paquete es m�s reciente que la
145
versi�n perteneciente a la distribuci�n objetivo, pero no tan reciente como la
146
versi�n de otra distribuci�n. Este tipo de paquetes se actualizar�n cuando se
147
ejecute <command>apt-get install
148
<replaceable>alg�n-paquete</replaceable></command> o <command>apt-get
149
upgrade</command> porque al menos <emphasis/uno/ de los ejemplares disponibles
150
tiene una prioridad mayor que la versi�n instalada.
155
<RefSect2><Title>El efecto de las preferencias sobre APT</>
158
El fichero de preferencias de APT permite al administrador del sistema controlar
159
las asignaciones de prioridades. El fichero consiste en uno o m�s registros de
160
varias l�neas separados entre s� por espacios en blanco. Los registros pueden
161
tener una o dos formas: una espec�fica y otra general.
165
La forma espec�fica asigna una prioridad ("Pin-Priority") a un paquete
166
concreto y se aplica a una versi�n o rango de versiones. Por ejemplo,
167
el siguiente registro asigna una prioridad alta a todas las versiones del
168
paquete <filename/perl/ cuyo n�mero de versi�n empiece con "<literal/5.8/".
179
La forma general asigna una prioridad a todas las versiones de los paquetes
180
en una distribuci�n (esto es, a todas las versiones de paquetes provenientes
181
de un fichero <filename/Release/), o a todos las versiones de un paquete
182
que provienen de un sitio concreto en internet, identificado por su
187
Esta forma general del fichero de preferencias de APT s�lo se aplica a grupos de
188
paquetes. Por ejemplo, el siguiente registro hace que asigne una prioridad alta
189
a todas las versiones disponibles desde un sitio local.
199
Un aviso acerca de la palabra clave usada en "<literal/origin/": no debe de
200
confundirse con el origen ("Origin:") de una distribuci�n tal y como se
201
especifica en el fichero <filename/Release/. Lo que sigue a "Origin:" en un
202
fichero <filename/Release/ no es una direcci�n de un sitio de internet, sino el
203
autor o el nombre del proveedor, tales como "Debian" o "Ximian".
207
El siguiente registro asigna una prioridad baja a todas las versiones de los
208
paquetes pertenecientes a cualquier distribuci�n que tenga como nombre de
209
Archivo "<literal/unstable/".
214
Pin: release a=unstable
219
El siguiente registro asigna una prioridad alta a todas las versiones de los
220
paquetes pertenecientes a la distribuci�n que tiene como nombre de Archivo
221
"<literal/stable/" y como n�mero de versi�n "<literal/3.0/".
226
Pin: release a=unstable, v=3.0
236
<Title>�C�mo interpreta APT las prioridades?</Title>
239
Las prioridades (P) asignadas en el fichero de preferencias deben ser
240
n�meros enteros. Se interpretan (en general) del siguiente modo:
244
<term>P > 1000</term>
245
<listitem><simpara>la versi�n se instala incluso si es una versi�n
246
anterior a la instalada en el sistema.</simpara></listitem>
248
<varlistentry><term>990 < P <=1000</term>
249
<listitem><simpara>la versi�n se instala aunque no venga de la distribuci�n
250
objetivo, a menos que la versi�n instalada sea m�s reciente.
251
</simpara></listitem>
253
<varlistentry><term>500 < P <=990</term>
254
<listitem><simpara>la versi�n se instala a menos que exista otro ejemplar
255
disponible perteneciente a la distribuci�n objetivo o bien la versi�n
256
instalada sea m�s reciente.</simpara></listitem>
258
<varlistentry><term>100 < P <=500</term>
259
<listitem><simpara>la versi�n se instala a menos que exista un ejemplar
260
perteneciente a otra distribuci�n o la versi�n instalada sea m�s reciente.
261
</simpara></listitem>
262
<varlistentry><term>0 < P <=100</term>
263
<listitem><simpara>la versi�n s�lo se instala si no hay ninguna versi�n
264
del paquete instalado.</simpara></listitem>
266
<varlistentry><term>P < 0</term>
267
<listitem><simpara>la versi�n nunca se instala.
268
</simpara></listitem>
274
Si uno de los registros de forma espec�fica descritos arriba coinciden con una
275
versi�n disponible de un paquete, el registro determina la prioridad de la
276
versi�n. En caso de que esto no sea as�, si cualquier n�mero de registros de
277
forma general coinciden con una versi�n, el primero determina la prioridad de la
282
Por ejemplo, suponga que el fichero de preferencias de APT
283
contiene los tres registros antes mencionados:
295
Pin: release unstable
302
<listitem><simpara>La versi�n m�s reciente disponible del paquete
303
<literal/perl/ se instala mientras que el n�mero de versi�n empieze
304
con "<literal/5.8/". Si se encuentra disponible <emphasis/cualquier/
305
versi�n 5.8* de <literal/perl/ y la versi�n instalada es 5.9*, entonces
306
se instala la versi�n5.8*.
307
</simpara></listitem><listitem><simpara>Cualquier otra versi�n de un paquete
309
<literal/perl/ disponible desde el sistema local tiene prioridad sobre el
310
resto de las versiones, incluso sobre los pertenecientes a la distribuci�n
312
</simpara></listitem>
313
<listitem><simpara>Otras versiones que tengan un origen distinto al sistema
314
local listadas en &sources-list; y que pertenezcan a la distribuci�n
315
<literal/inestable/ s�lo se instalar�n si se seleccionan para instalar y no hay
316
ninguna versi�n del paquete instalado.
317
</simpara></listitem>
323
<Title>Determinaci�n de la versi�n del paquete y de las propiedades de la
327
Los recursos del fichero &sources-list; deben proporcionar los ficheros
328
<filename>Packages</filename> y <filename>Release</filename>. �stos describen
329
los paquetes disponibles en cada uno de los sitios.
332
<para>El fichero <filename>Packages</filename> se encuentra normalmente en
333
el directorio <filename>.../dists/<replaceable>nombre-dist</replaceable>/
334
<replaceable>componente</replaceable>/<replaceable>arquitectura</replaceable>
336
por ejemplo, <filename>.../dists/stable/main/binary-i386/Packages</filename>.
337
El fichero consiste en una serie de registros de varias l�neas, uno por cada
338
paquete disponible en ese directorio. Para montar un repositorio de APT s�lo
339
son significativas dos de las l�neas de cada registro:
342
<term>La l�nea <literal/Package:/ </term>
343
<listitem><simpara>Indica el nombre del paquete</simpara></listitem>
346
<term>La l�nea <literal/Version:/ </term>
347
<listitem><simpara>Indica el n�mero de versi�n del paquete</simpara></listitem>
352
<para>El fichero <filename>Release</filename> normalmente se encuentra en el
354
<filename>.../dists/<replaceable>nombre-dist</replaceable></filename>,
355
por ejemplo, <filename>.../dists/stable/Release</filename>,
356
o <filename>.../dists/woody/Release</filename>.
357
El fichero consiste en registros de una sola l�nea que se aplican a
358
<emphasis/todos/ los paquetes por debajo del directorio
359
padre. Al contrario que el fichero <filename/Packages/, casi todas las
360
l�neas del fichero <filename/Release/ son relevantes para las prioridades de
365
<term>La l�nea <literal/Archive:/ </term>
366
<listitem><simpara>Indica el nombre del archivo al que pertenecen todos los
367
paquetes del �rbol de directorios. Por ejemplo, la l�nea
368
"Archive: stable" especifica que todos los paquetes en el �rbol de
369
directorios por debajo del directorio ra�z marcado en el fichero
370
<filename/Release/ est�n en un archivo de <literal/estable/. Para
371
especificar una preferencia de acuerdo con este par�metro
372
tendr� que poner la siguiente l�nea en el fichero de preferencias de APT:
375
Pin: release a=stable
381
<term>La l�nea <literal/Version:/ </term>
382
<listitem><simpara>Indica la versi�n de la distribuci�n. Por ejemplo, los
383
paquetes en �rbol pueden pertenecer a la versi�n 3.0 de Debian GNU/Linux. Dese
384
cuenta de que <literal/pruebas/ e <literal/inestable/ no tienen una versi�n
385
asignada porque no han sido liberadas. Para especificar una preferencia de
386
acuerdo con este par�metro tendr� que poner una de las siguientes l�nea en el
387
fichero de preferencias de APT:
392
Pin: release a=stable, v=3.0
400
<term>La l�nea <literal/Component:/ </term>
401
<listitem><simpara>Indica la licencia asociada a los paquetes en el �rbol
402
de directorios correspondiente al fichero <filename/Release/. Por ejemplo,
403
la l�nea <literal/Component: main/ especifica que todos los ejemplares son
404
de la secci�n <literal/main/, �sto asegura que su licencia se ajusta a las
405
DFSG. Para especificar una preferencia de acuerdo con este par�metro tendr�
406
que poner la siguiente l�nea en el fichero de preferencias de APT:
415
<term>La l�nea <literal/Origin:/ </term>
416
<listitem><simpara>Indica la procedencia de los paquetes en el �rbol de
417
directorios del fichero <filename/Release/. La procedencia m�s com�n es
418
<literal/Debian/. Para especificar una preferencia de acuerdo con este
419
par�metro tendr� que poner la siguiente l�nea en el fichero de preferencias
423
Pin: release o=Debian
429
<term>La l�nea <literal/Label:/ </term>
430
<listitem><simpara>nombra la etiqueta de los paquetes en los �rboles de
431
directorios del fichero <filename/Release/. Normalmente es
432
<literal/Debian/. Para especificar una preferencia de acuerdo con este par�metro
433
tendr� que poner la siguiente l�nea en el fichero de preferencias de APT:
436
Pin: release l=Debian
444
Todos los ficheros <filename>Packages</filename> y <filename>Release</filename>
445
que se obtienen de los recursos de &sources-list; se guardan en el directorio
446
<filename>/var/lib/apt/lists</filename>, o en el directorio definido por la
447
variable <literal/Dir::State::Lists/, que puede estar definida en el fichero
448
<filename/apt.conf/. Por ejemplo, el fichero
449
<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release
450
</filename> contiene los ficheros <filename>Release</filename> obtenidos de
451
<literal/debian.lcs.mit.edu/ para la arquitectura <literal/binary-i386/ de la
452
secci�n <literal/contrib/ de la distribuci�n <literal/inestable/.
458
<Title>L�neas opcionales en un registro de preferencias de APT</Title>
461
Cada registro en el fichero de preferencias de APT puede comenzar
462
con una o m�s l�neas que tengan como primera palabra
463
<literal/Explanation:/. �til para comentarios.
467
La l�nea <literal/Pin-Priority:/ es opcional. Si se omite, APT asigna
468
una prioridad un n�mero menor que la �ltima prioridad especificada en una l�nea
469
que empieze con <literal/Pin-Priority: release .../.
475
<Title>Ejemplos</Title>
477
<Title>Siguiendo la distribuci�n estable</Title>
479
<para>El siguiente fichero de preferencias de APT provoca que APT asigne una
480
prioridad mayor de la que asigna por omisi�n (500) a todos los ejemplares de
481
la distribuci�n <literal/estable/ y una prioridad m�s baja al resto de las
482
distribuciones <literal/Debian/.
485
Explanation: Desinstalar o no instalar los ejemplares que no
486
Explanation: pertenecen a la distribuci�n estable
488
Pin: release a=stable
492
Pin: release o=Debian
498
Con un fichero &sources-list; apropiado y el fichero de preferencias mostrado
499
anteriormente, cualquiera de las siguientes �rdenes de APT hace que o bien todo
500
el sistema o bien s�lo algunos paquetes se actualicen a la �ltima versi�n
504
apt-get install <replaceable>paquete</replaceable>
510
<para>La siguiente orden hace que APT actualice un paquete a la �ltima versi�n
511
de la distribuci�n de <literal/pruebas/, el paquete no se actualizar� de nuevo amenos que se ejecute de nuevo la orden.
514
apt-get install <replaceable>paquete</replaceable>/testing
519
<Title>Siguiendo la distribuci�n de pruebas o inestable</Title>
521
<para>El siguiente fichero de preferencias de APT provocar� que APT asigne
522
mayor prioridad a las versiones de la distribuci�n de <literal/pruebas/,
523
una prioridad menor a los paquetes de la distribuci�n <literal/inestable/,
524
y una prioridad prohibitiva a los paquetes de otras distribuciones de
529
Pin: release a=testing
533
Pin: release a=unstable
537
Pin: release o=Debian
543
Con un fichero &sources-list; adecuado y el fichero de preferencias anterior,
544
cualquiera de la �rdenes siguientes hace que APT actualice los paquetes a la
545
�ltima versi�n de la distribuci�n de <literal/pruebas/.
548
apt-get install <replaceable>paquete</replaceable>
554
<para>La siguiente orden hace que APT actualice un determinado paquete a la
555
�ltima versi�n de la distribuci�n <literal/inestable/. M�s tarde,
556
<command>apt-get upgrade</command> actualizar�n el paquete a la �ltima versi�n
557
de la distribuci�n de <literal/pruebas/ si es m�s reciente que la versi�n
558
instalada, de otro modo, se instalar� la versi�n m�s reciente de la
559
distribuci�n<literal/inestable/ si es m�s reciente que la versi�n instalada.
562
apt-get install <replaceable>paquete</replaceable>/unstable
570
<Title>V�ase adem�s</>
572
&apt-get; &apt-cache; &apt-conf; &sources-list;
580
<title>TRADUCTOR</title>
582
Traducci�n de Rub�n Porras Campo
583
<debian-l10n-spanish@lists.debian.org>