doc/es/apt_preferences.es.5.sgml

   1 <!-- -*- mode: sgml; mode: fold -*- -->
   2 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
   3
   4 <!ENTITY % aptent SYSTEM "apt.ent.es">
   5 %aptent;
   6
   7 ]>
   8
   9 <!--
  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 0.5.20 de apt
  15  -->
  16
  17 <refentry lang=es>
  18  &apt-docinfo;
  19
  20  <refmeta>
  21    <refentrytitle>apt_preferences</>
  22    <manvolnum>5</>
  23  </refmeta>
  24
  25  <!-- Man page title -->
  26  <refnamediv>
  27     <refname>apt_preferences</>
  28     <refpurpose>Fichero de preferencias de APT</>
  29  </refnamediv>
  30
  31 <RefSect1>
  32 <Title>Descripción</Title>
  33 <para>
  34 El fichero de preferencias de APT <filename>/etc/apt/preferences</>
  35 se puede usar para controlar las versiones de los paquetes seleccionados.
  36 </para>
  37
  38 <para>Cuando el fichero &sources-list; contiene referencias a más de una
  39 distribución (por ejemplo, <literal>estable</literal> y <literal>pruebas
  40 </literal>). APT asigna una prioridad a cada versión disponible.
  41 Limitado por las dependencias, <command>apt-get</command> selecciona la versión
  42 con mayor prioridad.
  43 </para>
  44
  45 <para>El fichero de preferencias de APT modifica las prioridades asignadas por
  46 APT, dando control al usuario sobre que ejemplar se seleccionar para la
  47 instalación.
  48 </para>
  49 <para>
  50 Puede estén disponibles varios ejemplares de la misma versión de un paquete
  51 cuando el fichero &sources-list; contenga referencias a más de una fuente. En
  52 este caso <command>apt-get</command> descarga el ejemplar que aparezca listado
  53 primero en el fichero &sources-list;. El fichero de preferencias de APT no
  54 modifica la elección del ejemplar, sólo la elección de la versión.
  55 </para>
  56 <RefSect2><Title>¿Cómo asigna APT las prioridades?</>
  57
  58 <para>Si no existe el fichero de preferencias o no hay ninguna entrada en éste
  59 que se pueda aplicar a una determinada versión, se asigna a la versión la
  60 prioridad de la distribución a la que pertenece. Es posible seleccionar una
  61 distribución, &gt;&gt;distribución objetivo&lt;&lt;
  62 (n. t. del inglés <emphasis>target release</emphasis>), que recibe
  63 una prioridad mayor que el resto. La distribución objetivo se puede definir
  64 en la línea de órdenes al ejecutar <command>apt-get</command> o en el fichero
  65 de configuración de APT (<filename>/etc/apt/apt.conf</filename>).
  66 Por ejemplo,
  67 <programlisting>
  68 <command>apt-get install -t testing <replaceable>paquete</replaceable></command>
  69 </programlisting>
  70 <programlisting>
  71 APT::Default-Release "stable";
  72 </programlisting>
  73 </para>
  74
  75 <para>
  76 Si se ha especificado una distribución objetivo, APT usa el siguiente
  77 algoritmo para establecer las prioridades de cada versión de un paquete.
  78 Asigna:
  79
  80 <variablelist>
  81 <varlistentry>
  82 <term>prioridad 100</term>
  83 <listitem><simpara>a la versión instalada (si existe).</simpara></listitem>
  84 </varlistentry>
  85 <varlistentry>
  86 <term>prioridad 500</term>
  87 <listitem><simpara>a la versión que ni está instalada ni pertenece a la
  88 distribución objetivo.</simpara></listitem>
  89 </varlistentry>
  90 <varlistentry>
  91 <term>prioridad 990</term>
  92 <listitem><simpara>a las versiones que no están instaladas pero que
  93 pertenecen a la distribución objetivo.</simpara></listitem>
  94 </varlistentry>
  95 </variablelist>
  96 </para>
  97
  98 <para>
  99 Si no se especifica ninguna distribución objetivo APT asigna prioridad 100 a
 100 todas las versiones de los paquetes instalados y 500 al resto.
 101 </para>
 102
 103 <para>
 104 APT aplica las siguientes normas, expuestas por orden de precedencia,
 105 para determinar qué versión del paquete debe instalar.
 106
 107 <itemizedlist>
 108 <listitem><simpara>Nunca instalar una versión anterior de un paquete en lugar
 109 de la instalada a menos que la prioridad de la versión disponible supere 1000
 110 (Dese cuenta que ninguna de las prioridades que asigna APT por omisión superan
 111 1000, éstas prioridades sólo se pueden establecer mediante el fichero de
 112 preferencias. Tenga en consideración que instalar una versión anterior del
 113 paquete puede ser peligroso).
 114 </simpara></listitem>
 115 <listitem><simpara>Instalar la versión de mayor prioridad.
 116 </simpara></listitem>
 117 <listitem><simpara>Si dos o más versiones tienen la misma prioridad,
 118 instala la más reciente (esto es, la que tiene un número de versión mayor).
 119 </simpara></listitem>
 120 <listitem><simpara>Si dos o más versiones tienen la misma prioridad y número de
 121 versión, pero o bien difieren en su meta-información o se a proporcionado la
 122 opción <literal/--reinstall/ se instala la que no está instalada.
 123 </simpara></listitem>
 124 </itemizedlist>
 125 </para>
 126
 127 <para>
 128 Típicamente, la versión instalada del paquete (prioridad 100)
 129 no es tan reciente como la disponible a través de &sources-list;
 130 (prioridad 500 o 990). Entonces el paquete se actualizará cuando se ejecute
 131 <command>apt-get install <replaceable>algún-paquete</replaceable></command> o
 132 <command>apt-get upgrade</command>.
 133 </para>
 134
 135 <para>Rara vez la versión instalada de un paquete es <emphasis/más/ reciente
 136 que cualquiera de las versiones disponibles. En éste caso no se instalará la
 137 versión anterior del paquete cuando se ejecute <command>apt-get install
 138 <replaceable>algún-paquete</replaceable></command> o <command>apt-get
 139 upgrade</command>.
 140 </para>
 141
 142 <para>
 143 A veces la versión instalada de un paquete es más reciente que la
 144 versión perteneciente a la distribución objetivo, pero no tan reciente como la
 145 versión de otra distribución. Este tipo de paquetes se actualizarán cuando se
 146 ejecute <command>apt-get install
 147 <replaceable>algún-paquete</replaceable></command> o <command>apt-get
 148 upgrade</command>.porque al menos <emphasis/uno/ de los ejemplares disponibles
 149 tiene una prioridad mayor que la versión instalada.
 150 </para>
 151
 152 </RefSect2>
 153
 154 <RefSect2><Title>El efecto de las preferencias sobre APT</>
 155
 156 <para>
 157 El fichero de preferencias de APT permite al administrador del sistema controlar
 158 las asignaciones de prioridades. El fichero consiste en uno o más registros de
 159 varias líneas separados entre sí por espacios en blanco. Los registros pueden
 160 tener una o dos formas: una específica y otra general.
 161 <itemizedlist>
 162 <listitem>
 163 <simpara>
 164 La forma específica asigna una prioridad ("Pin-Priority") a un paquete
 165 concreto y se aplica a una versión o rango de versiones. Por ejemplo,
 166 el siguiente registro asigna una prioridad alta a todas las versiones del
 167 paquete <filename/perl/ cuyo número de versión empiece con "<literal/5.8/".
 168 </simpara>
 169
 170 <programlisting>
 171 Package: perl
 172 Pin: version 5.8*
 173 Pin-Priority: 1001
 174 </programlisting>
 175 </listitem>
 176
 177 <listitem><simpara>
 178 La forma general asigna una prioridad a todas las versiones de los paquetes
 179 en una distribución (esto es, a todas las versiones de paquetes provenientes
 180 de un fichero <filename/Release/), o a todos las versiones de un paquete
 181 que provienen de un sitio concreto en internet, identificado por su
 182 nombre de dominio.
 183 </simpara>
 184
 185 <simpara>
 186 Esta forma general del fichero de preferencias de APT sólo se aplica a grupos de
 187 paquetes. Por ejemplo, el siguiente registro hace que asigne una prioridad alta
 188 a todas las versiones disponibles desde un sitio local.
 189 </simpara>
 190
 191 <programlisting>
 192 Package: *
 193 Pin: origin ""
 194 Pin-Priority: 999
 195 </programlisting>
 196
 197 <simpara>
 198 Un aviso acerca de la palabra clave usada en "<literal/origin/": no debe de
 199 confundirse con el origen ("Origin:") de una distribución tal y como se
 200 especifica en el fichero <filename/Release/. Lo que sigue a "Origin:" en un
 201 fichero <filename/Release/ no es una dirección de un sitio de internet, sino el
 202 autor o el nombre del proveedor, tales como "Debian" o "Ximian".
 203 </simpara>
 204
 205 <simpara>
 206 El siguiente registro asigna una prioridad baja a todas las versiones de los
 207 paquetes pertenecientes a cualquier distribución que tenga como nombre de
 208 Archivo "<literal/unstable/".
 209 </simpara>
 210
 211 <programlisting>
 212 Package: *
 213 Pin: release a=unstable
 214 Pin-Priority: 50
 215 </programlisting>
 216
 217 <simpara>
 218 El siguiente registro asigna una prioridad alta a todas las versiones de los
 219 paquetes pertenecientes a la distribución que tiene como nombre de Archivo
 220 "<literal/stable/" y como número de versión "<literal/3.0/".
 221 </simpara>
 222
 223 <programlisting>
 224 Package: *
 225 Pin: release a=unstable, v=3.0
 226 Pin-Priority: 50
 227 </programlisting>
 228 </listitem>
 229 </itemizedlist>
 230 </para>
 231
 232 </RefSect2>
 233
 234 <RefSect2>
 235 <Title>¿Cómo interpreta APT las prioridades?</Title>
 236
 237 <para>
 238 Las prioridades (P) asignadas en el fichero de preferencias deben ser
 239 números enteros. Se interpretan (en general) del siguiente modo:
 240
 241 <variablelist>
 242 <varlistentry>
 243 <term>P &gt; 1000</term>
 244 <listitem><simpara>la versión se instala incluso si es una versión
 245 anterior a la instalada en el sistema.</simpara></listitem>
 246 </varlistentry>
 247 <varlistentry><term>990 &lt; P &lt;=1000</term>
 248 <listitem><simpara>la versión se instala aunque no venga de la distribución
 249 objetivo, a menos que la versión instalada sea más reciente.
 250 </simpara></listitem>
 251 </varlistentry>
 252 <varlistentry><term>500 &lt; P &lt;=990</term>
 253 <listitem><simpara>la versión se instala a menos que exista otro ejemplar
 254 disponible perteneciente a la distribución objetivo o bien la versión
 255 instalada sea más reciente.</simpara></listitem>
 256 </varlistentry>
 257 <varlistentry><term>100 &lt; P &lt;=500</term>
 258 <listitem><simpara>la versión se instala a menos que exista un ejemplar
 259 perteneciente a otra distribución o la versión instalada sea más reciente.
 260 </simpara></listitem>
 261 <varlistentry><term>0 &lt; P &lt;=100</term>
 262 <listitem><simpara>la versión sólo se instala si no hay ninguna versión
 263 del paquete instalado.</simpara></listitem>
 264 </varlistentry>
 265 <varlistentry><term>P &lt; 0</term>
 266 <listitem><simpara>la versión nunca se instala.
 267 </simpara></listitem>
 268 </varlistentry>
 269 </variablelist>
 270 </para>
 271
 272 <para>
 273 Si uno de los registros de forma específica descritos arriba coinciden con una
 274 versión disponible de un paquete, el registro determina la prioridad de la
 275 versión. En caso de que esto no sea así, si cualquier número de registros de
 276 forma general coinciden con una versión, el primero determina la prioridad de la
 277 versión del paquete.
 278 </para>
 279
 280 <para>
 281 Por ejemplo, suponga que el fichero de preferencias de APT
 282 contiene los tres registros antes mencionados:
 283
 284 <programlisting>
 285 Package: perl
 286 Pin: version 5.8*
 287 Pin-Priority: 1001
 288
 289 Package: *
 290 Pin: origin ""
 291 Pin-Priority: 999
 292
 293 Package: *
 294 Pin: release unstable
 295 Pin-Priority: 50
 296 </programlisting>
 297
 298 Entonces:
 299
 300 <itemizedlist>
 301 <listitem><simpara>La versión más reciente disponible del paquete
 302 <literal/perl/ se instala mientras que el número de versión empieze
 303 con "<literal/5.8/". Si se encuentra disponible <emphasis/cualquier/
 304 versión 5.8* de <literal/perl/ y la versión instalada es 5.9*, entonces
 305 se instala la versión5.8*.
 306 </simpara></listitem><listitem><simpara>Cualquier otra versión de un paquete
 307 distinto de
 308 <literal/perl/ disponible desde el sistema local tiene prioridad sobre el
 309 resto de las versiones, incluso sobre los pertenecientes a la distribución
 310 objetivo.
 311 </simpara></listitem>
 312 <listitem><simpara>Otras versiones que tengan un origen distinto al sistema
 313 local listadas en &sources-list; y que pertenezcan a la distribución
 314 <literal/inestable/ sólo se instalarán si se seleccionan para instalar y no hay
 315 ninguna versión del paquete instalado.
 316 </simpara></listitem>
 317 </itemizedlist>
 318 </para>
 319 </RefSect2>
 320
 321 <RefSect2>
 322 <Title>Determinación de la versión del paquete y de las propiedades de la
 323 distribución</Title>
 324
 325 <para>
 326 Los recursos del fichero &sources-list; deben proporcionar los ficheros
 327 <filename>Packages</filename> y <filename>Release</filename>. Éstos describen
 328 los paquetes disponibles en cada uno de los sitios.
 329 </para>
 330
 331 <para>El fichero <filename>Packages</filename> se encuentra normalmente en
 332 el directorio <filename>.../dists/<replaceable>nombre-dist</replaceable>/
 333 <replaceable>componente</replaceable>/<replaceable>arquitectura</replaceable>
 334 </filename>,
 335 por ejemplo, <filename>.../dists/stable/main/binary-i386/Packages</filename>.
 336 El fichero consiste en una serie de registros de varias líneas, uno por cada
 337 paquete disponible en ese directorio. Para montar un repositorio de APT sólo
 338 son significativas dos de las líneas de cada registro:
 339 <variablelist>
 340 <varlistentry>
 341 <term>La línea <literal/Package:/ </term>
 342 <listitem><simpara>Indica el nombre del paquete</simpara></listitem>
 343 </varlistentry>
 344 <varlistentry>
 345 <term>La línea <literal/Version:/ </term>
 346 <listitem><simpara>Indica el número de versión del paquete</simpara></listitem>
 347 </varlistentry>
 348 </variablelist>
 349 </para>
 350
 351 <para>El fichero <filename>Release</filename> normalmente se encuentra en el
 352 directorio
 353 <filename>.../dists/<replaceable>nombre-dist</replaceable></filename>,
 354 por ejemplo, <filename>.../dists/stable/Release</filename>,
 355 o <filename>.../dists/woody/Release</filename>.
 356 El fichero consiste en registros de una sola línea que se aplican a
 357 <emphasis/todos/ los paquetes por debajo del directorio
 358 padre. Al contrario que el fichero <filename/Packages/, casi todas las
 359 líneas del fichero <filename/Release/ son relevantes para las prioridades de
 360 APT:
 361
 362 <variablelist>
 363 <varlistentry>
 364 <term>La línea <literal/Archive:/ </term>
 365 <listitem><simpara>Indica el nombre del archivo al que pertenecen todos los
 366 paquetes del árbol de directorios. Por ejemplo, la línea
 367 "Archive: stable" especifica que todos los paquetes en el árbol de
 368 directorios por debajo del directorio raíz marcado en el fichero
 369 <filename/Release/ están en un archivo de <literal/estable/. Para
 370 especificar una preferencia de acuerdo con este parámetro
 371 tendrá que poner la siguiente línea en el fichero de preferencias de APT:
 372 </simpara>
 373 <programlisting>
 374 Pin: release a=stable
 375 </programlisting>
 376 </listitem>
 377 </varlistentry>
 378
 379 <varlistentry>
 380 <term>La línea <literal/Version:/ </term>
 381 <listitem><simpara>Indica la versión de la distribución. Por ejemplo, los
 382 paquetes en árbol pueden pertenecer a la versión 3.0 de Debian GNU/Linux. Dese
 383 cuenta de que <literal/pruebas/ e <literal/inestable/ no tienen una versión
 384 asignada porque no han sido liberadas. Para especificar una preferencia de
 385 acuerdo con este parámetro tendrá que poner una de las siguientes línea en el
 386 fichero de preferencias de APT:
 387 </simpara>
 388
 389 <programlisting>
 390 Pin: release v=3.0
 391 Pin: release a=stable, v=3.0
 392 Pin: release 3.0
 393 </programlisting>
 394
 395 </listitem>
 396 </varlistentry>
 397
 398 <varlistentry>
 399 <term>La línea <literal/Component:/ </term>
 400 <listitem><simpara>Indica la licencia asociada a los paquetes en el árbol
 401 de directorios correspondiente al fichero <filename/Release/. Por ejemplo,
 402 la línea <literal/Component: main/ especifica que todos los ejemplares son
 403 de la sección <literal/main/, ésto asegura que su licencia se ajusta a las
 404 DFSG. Para especificar una preferencia de acuerdo con este parámetro tendrá
 405 que poner la siguiente línea en el fichero de preferencias de APT:
 406 </simpara>
 407 <programlisting>
 408 Pin: release c=main
 409 </programlisting>
 410 </listitem>
 411 </varlistentry>
 412
 413 <varlistentry>
 414 <term>La línea <literal/Origin:/ </term>
 415 <listitem><simpara>Indica la procedencia de los paquetes en el árbol de
 416 directorios del fichero <filename/Release/. La procedencia más común es
 417 <literal/Debian/. Para especificar una preferencia de acuerdo con este
 418 parámetro tendrá que poner la siguiente línea en el fichero de preferencias
 419 de APT:
 420 </simpara>
 421 <programlisting>
 422 Pin: release o=Debian
 423 </programlisting>
 424 </listitem>
 425 </varlistentry>
 426
 427 <varlistentry>
 428 <term>La línea <literal/Label:/ </term>
 429 <listitem><simpara>nombra la etiqueta de los paquetes en los árboles de
 430 directorios del fichero <filename/Release/. Normalmente es
 431 <literal/Debian/. Para especificar una preferencia de acuerdo con este parámetro
 432 tendrá que poner la siguiente línea en el fichero de preferencias de APT:
 433 </simpara>
 434 <programlisting>
 435 Pin: release l=Debian
 436 </programlisting>
 437 </listitem>
 438 </varlistentry>
 439 </variablelist>
 440 </para>
 441
 442 <para>
 443 Todos los ficheros <filename>Packages</filename> y <filename>Release</filename>
 444 que se obtienen de los recursos de &sources-list; se guardan en el directorio
 445 <filename>/var/lib/apt/lists</filename>, o en el directorio definido por la
 446 variable <literal/Dir::State::Lists/, que puede estar definida en el fichero
 447 <filename/apt.conf/. Por ejemplo, el fichero
 448 <filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release
 449 </filename> contiene los ficheros <filename>Release</filename> obtenidos de
 450 <literal/debian.lcs.mit.edu/ para la arquitectura <literal/binary-i386/ de la
 451 sección <literal/contrib/ de la distribución <literal/inestable/.
 452 </para>
 453
 454 </RefSect2>
 455
 456 <RefSect2>
 457 <Title>Líneas opcionales en un registro de preferencias de APT</Title>
 458
 459 <para>
 460 Cada registro en el fichero de preferencias de APT puede comenzar
 461 con una o más líneas que tengan como primera palabra
 462 <literal/Explanation:/. Útil para comentarios.
 463 </para>
 464
 465 <para>
 466 La línea <literal/Pin-Priority:/ es opcional. Si se omite, APT asigna
 467 una prioridad un número menor que la última prioridad especificada en una línea
 468 que empieze con <literal/Pin-Priority: release .../.
 469 </para>
 470 </RefSect2>
 471 </RefSect1>
 472
 473 <RefSect1>
 474 <Title>Ejemplos</Title>
 475 <RefSect2>
 476 <Title>Siguiendo la distribución estable</Title>
 477
 478 <para>El siguiente fichero de preferencias de APT provoca que APT asigne una
 479 prioridad mayor de la que asigna por omisión (500) a todos los ejemplares de
 480 la distribución <literal/estable/ y una prioridad más baja al resto de las
 481 distribuciones <literal/Debian/.
 482
 483 <programlisting>
 484 Explanation: Desinstalar o no instalar los ejemplares que no
 485 Explanation: pertenecen a la distribución estable
 486 Package: *
 487 Pin: release a=stable
 488 Pin-Priority: 900
 489
 490 Package: *
 491 Pin: release o=Debian
 492 Pin-Priority: -10
 493 </programlisting>
 494 </para>
 495
 496 <para>
 497 Con un fichero &sources-list; apropiado y el fichero de preferencias mostrado
 498 anteriormente, cualquiera de las siguientes órdenes de APT hace que o bien todo
 499 el sistema o bien sólo algunos paquetes se actualicen a la última versión
 500 <literal/estable/.
 501
 502 <programlisting>
 503 apt-get install <replaceable>paquete</replaceable>
 504 apt-get upgrade
 505 apt-get dist-upgrade
 506 </programlisting>
 507 </para>
 508
 509 <para>La siguiente orden hace que APT actualice un paquete a la última versión
 510 de la distribución de <literal/pruebas/, el paquete no se actualizará de nuevo amenos que se ejecute de nuevo la orden.
 511
 512 <programlisting>
 513 apt-get install <replaceable>paquete</replaceable>/testing
 514 </programlisting>
 515 </RefSect2>
 516
 517 <RefSect2>
 518 <Title>Siguiendo la distribución de pruebas o inestable</Title>
 519
 520 <para>El siguiente fichero de preferencias de APT provocará que APT asigne
 521 mayor prioridad a las versiones de la distribución de <literal/pruebas/,
 522 una prioridad menor a los paquetes de la distribución <literal/inestable/,
 523 y una prioridad prohibitiva a los paquetes de otras distribuciones de
 524 <literal/Debian/.
 525
 526 <programlisting>
 527 Package: *
 528 Pin: release a=testing
 529 Pin-Priority: 900
 530
 531 Package: *
 532 Pin: release a=unstable
 533 Pin-Priority: 800
 534
 535 Package: *
 536 Pin: release o=Debian
 537 Pin-Priority: -10
 538 </programlisting>
 539 </para>
 540
 541 <para>
 542 Con un fichero &sources-list; adecuado y el fichero de preferencias anterior,
 543 cualquiera de la órdenes siguientes hace que APT actualice los paquetes a la
 544 última versión de la distribución de <literal/pruebas/.
 545
 546 <programlisting>
 547 apt-get install <replaceable>paquete</replaceable>
 548 apt-get upgrade
 549 apt-get dist-upgrade
 550 </programlisting>
 551 </para>
 552
 553 <para>La siguiente orden hace que APT actualice un determinado paquete a la
 554 última versión de la distribución <literal/inestable/. Más tarde,
 555 <command>apt-get upgrade</command> actualizarán el paquete a la última versión
 556 de la distribución de <literal/pruebas/ si es más reciente que la versión
 557 instalada, de otro modo, se instalará la versión más reciente de la
 558 distribución<literal/inestable/ si es más reciente que la versión instalada.
 559
 560 <programlisting>
 561 apt-get install <replaceable>paquete</replaceable>/unstable
 562 </programlisting>
 563 </para>
 564
 565 </RefSect2>
 566 </RefSect1>
 567
 568 <RefSect1>
 569 <Title>Véase además</>
 570 <para>
 571 &apt-get; &apt-cache; &apt-conf; &sources-list;
 572 </para>
 573  </RefSect1>
 574
 575  &manbugs;
 576  &manauthor;
 577
 578   <refsect1>
 579     <title>TRADUCTOR</title>
 580     <para>
 581       Traducción de Rubén Porras Campo
 582       &lt;debian-l10n-spanish@lists.debian.org&gt;
 583     </para>
 584   </refsect1>
 585
 586 </refentry>