Provided by: kernel-package_11.001-0.1_all bug

NOMBRE

       kernel-img.conf  -  fichero  de  configuración global para paquetes con
       imágenes del núcleo

SINOPSIS

       /etc/kernel-img.conf

DESCRIPCIÓN

       El fichero /etc/kernel-img.conf es un simple fichero  que  se  consulta
       durante  el  proceso  de post-instalación de la imagen del núcleo y que
       permite personalizar localmente algunos  aspectos  de  la  instalación,
       modificando las opciones predeterminadas de la propia imagen.

       El  formato  de  los  valores  es  una  simple pareja VAR = VALOR.  Los
       valores booleanos han de especificarse como Yes, True, 1, y No,  False,
       0,   teniendo   en   cuenta  las  mayúsculas.   Este  fichero  se  crea
       automáticamente por el script de instalación si no existe, al contrario
       que con el enlace simbólico /vmlinuz.  El script pregunta al usuario si
       se debe  de  crear  el  enlace  simbólico  y  guarda  la  respuesta  en
       /etc/kernel-img.conf

       En este momento, las variables modificables por el usuario son:

       link_in_boot
              Si es «Yes» el enlace simbólico con la imagen llamado vmlinuz se
              creará en /boot en vez de en /.  El  nombre  antiguo  y  confuso
              image_in_boot  es  desaconsejado,  ya  que  lo  que  se  reubica
              normalmente es el enlace simbólico.  Por omisión es «No».

       do_symlinks
              Por omisión, el script de  post-instalación  de  la  imagen  del
              núcleo  crea  o  actualiza  los  enlaces  simbólicos  /vmlinuz y
              /vmlinuz.old.  Esto es cierto si ya existe un enlace /vmlinuz  ,
              sin  embargo, en ausencia de éste, el script busca el fichero de
              configuración.   Si  no  existe,  el  script  de   configuración
              pregunta al usuario si desea crear el enlace simbólico, y guarda
              la respuesta en el fichero /etc/kernel-img.conf  recién  creado.
              Si  el  fichero  de  configuración ya existe, y esta opción está
              definida a No, en ningún caso se crea el enlace.  Esto  es  para
              aquellos  que  no quieran tener enlaces simbólicos molestando en
              su directorio / . Por omisión es Yes.

       minimal_swap
              Por omisión, si el enlace simbólico /vmlinuz  no  apunta  a  una
              imagen  que  es  la  misma  que la imagen instalada, el programa
              postinst  mueve  /vmlinuz  a  /vmlinuz.old,  y  crea  un  enlace
              simbólico  a  la  imagen del núcleo en /vmlinuz (la excepción es
              para prevenir que /vmlinuz y /vmlinuz.old  apunten  a  la  misma
              imagen del núcleo -- que podría ser potencialmente desastroso si
              la imagen actual es defectuosa o le falta algo). Sin embargo, si
              la  opción  está  habilitada,  no  se  realiza ninguna acción si
              /vmlinuz.old apunta  a  la  imagen  actualmente  instalada  (por
              omisión  los enlaces simbólicos son intercambiados). Por omisión
              tiene el valor de No.

       no_symlinks
              Determina si se usan los  enlaces  al  fichero  con  la  imagen.
              Mutuamente  excluyente  con  reverse_symlinks.  Puede usarse con
              link_in_boot (image_in_boot).  Si es  Yes,  la  imagen  real  se
              coloca  en  vmlinuz  (en vez de en /boot/vmlinuz-X.X.XX). Si usa
              link_in_boot junto con esto,  se  mueve  /boot/vmlinuz-X.X.XX  a
              /boot/vmlinuz.  El  vmlinuz previo se mueve incondicionalmente a
              vmlinuz.old. (Normalmente, esto sólo se hace si la versión de la
              nueva  imagen  es diferente de la anterior). Esto le restringe a
              dos imágenes, a menos que tome  acciones  adicionales  y  guarde
              copias de imágenes anteriores.  Esto es para aquellos que tienen
              /boot en un sistema que no usa los enlaces simbólicos  (digamos,
              que  usan loadlin como gestor de arranque). Esto es una chapuza.
              Por omisión tiene el valor de No.

       reverse_symlinks
              Determina si se usan enlaces simbólico invertidos (esto  es,  el
              fichero  real  es  el que no tiene número de versión, la versión
              numerada es el enlace) al fichero  con  la  imagen.   Mutuamente
              excluyente   con   no_symlinks.    Se   puede   usar  junto  con
              link_in_boot (image_in_boot).  Igual  que  no_symlinks,  excepto
              porque  /boot/vmlinuz-X.XX es enlazado con la nueva imagen real,
              vmlinuz. Esto también le restringe a dos imágenes  a  menos  que
              tome  alguna  acción  adicional.  Los  enlaces anteriores quedan
              colgando. Esto es para aquellos con /boot en umsdos, y no pueden
              ver el enlace en dos, pero quieren saber el número de la versión
              cuando estén en Linux. Esto es una chapuza.  Por  omisión  tiene
              el valor de No.

       image_dest
              Si  quiere que el enlace simbólico (o imagen, si move_image está
              establecida) se guarde en algún sitio distinto de  /  establezca
              esta  variable al directorio donde quiera poner el enlace. Tenga
              en cuenta que no es una variable booleana. Puede  ser  de  ayuda
              para  usuarios  de  loadlin  ,  que  pueden  establecer  ésta  y
              move_image.  Por omisión es /.   Se  puede  usar  con  todas  la
              opciones  anteriores  excepto  con link_in_boot (image_in_boot),
              porque no tendría sentido. (Si se establece ambas  image_dest  y
              link_in_boot    (image_in_boot)    ,    predomina   link_in_boot
              (image_in_boot)).

       postinst_hook
              Establezca esta variable apuntando a  un  script  que  debe  ser
              ejecutado  durante la instalación después de que se hayan creado
              todos los enlaces simbólicos, pero antes de invocar el gestor de
              arranque. La ruta puede ser relativa si el programa se encuentra
              en una ruta segura (es decir, si se  localiza  en  /bin,  /sbin,
              /usr/bin,  o  /usr/sbin),  o en caso contrario debe ser una ruta
              absoluta. Antes de invocar a  este  programa,  debe  definir  la
              variable  STEM  con  el  valor  del argumento --stem (o el valor
              predeterminado, linux).  Este  script  debe  invocarse  con  dos
              argumentos, el primero es la versin de la imagen del núcleo, el
              segundo es la localizacin de la imagen del núcleo. Los  errores
              en el script causarán el fallo de postinst. Debido a que se está
              usando debconf antes de que se invoque al script, éste  no  debe
              mostrar  mensajes  de  diagnóstico  a  stdout (mientras postinst
              invoca db_stop , debconf no restaura stdout, por  lo  tanto  los
              mensajes  a stdout desaparecerán).  Puede encontrar un script de
              ejemplo   para   usuarios   de    grub    en    el    directorio
              /usr/share/doc/kernel-package/.

       postrm_hook
              Establezca  esta  variable  apuntando  a  un script que debe ser
              ejecutado en el  postrm  (es  decir,  después  de  que  se  haya
              eliminado la imagen) después de que se hayan realizado todas las
              acciones. La ruta puede ser relativa si el programa se encuentra
              en  una  ruta  segura  (es decir, si se localiza en /bin, /sbin,
              /usr/bin, o /usr/sbin), o en caso contrario debe  ser  una  ruta
              absoluta.   Este  script  debe  invocarse con dos argumentos, el
              primero es la versin de la imagen del núcleo, el segundo es  la
              localizacin  de  la imagen del núcleo. Los errores en el script
              sólo producirán un mensaje de aviso, pero deben  ser  ignorados.
              Debido  a  que  debconf  está  en uso antes de que se invoque el
              script, éste no debe mostrar mensajes de  diagnóstico  a  stdout
              (mientras  postinst invoca db_stop , debconf no restaura stdout,
              por lo tanto los mensajes a stdout desaparecerán).

       preinst_hook
              Establezca esta variable apuntando a  un  script  que  debe  ser
              ejecutado después de desempaquetar el paquete, puede usarse para
              comprobaciones adicionales.
               La ruta puede ser relativa si el programa se encuentra  en  una
              ruta  segura (es decir, si se localiza en /bin, /sbin, /usr/bin,
              o /usr/sbin), o en caso contrario debe ser  una  ruta  absoluta.
              Este  script debe invocarse con dos argumentos, el primero es la
              versin de la imagen del núcleo, el segundo es  la  localizacin
              de la imagen del núcleo.

       prerm_hook
              Establezca  esta  variable apuntando a un script que debe de ser
              ejecutado después  que  los  ficheros  del  paquete  hayan  sido
              eliminados  (de  este  modo  se puede eliminar cualquier fichero
              añadido). La ruta puede ser relativa si el programa se encuentra
              en  una  ruta  segura  (es decir, si se localiza en /bin, /sbin,
              /usr/bin, o /usr/sbin), o en caso contrario debe  ser  una  ruta
              absoluta.   Este  script  debe  invocarse con dos argumentos, el
              primero es la versin de la imagen del núcleo, y el  segundo  es
              la  localizacin  de  la  imagen  del  núcleo. Los errores en el
              script causarán el fallo de prerm.  Debido a que debconf está en
              uso  antes  de  que se invoque al script, éste no deberá mostrar
              mensajes a stdout (mientras postinst invoca db_stop , debconf no
              restaura   stdout,   por   lo   tanto   los  mensajes  a  stdout
              desaparecerán).

       ramdisk
              Establezca esta variable a una lista de ejecutables separada por
              espacios  que  crean  un  disco RAM de inicio. Esto tiene efecto
              únicamente si se instala un kernel-image (imágen de núcleo)  que
              usa  un  disco  RAM  de  inicio. Las órdenes definidas deben ser
              compatibles con mkinitrd.  Al usar  las  opciones  de  línea  de
              órdenes  --supported-host-version  y --supported-target-version,
              estos ejecutables se consultan al momento  de  instalación  para
              comprobar  si la combinación del actual núcleo en ejecución como
              núcleo anfitrión, y la versión del núcleo a instalarse  como  al
              núcleo  destino,  y  elminados  de  la  lista  si no. La primera
              herramienta viable se usa para crear el disco RAM de inicio.  La
              instalación   fallará   si   no  se  encuentra  una  herramienta
              utilizable.  Por omisión es definido  al  conjunto  de  mkinitrd
              mkinitrd.yaird mkinitramfs

       src_postinst_hook
              A diferencia de las otras variables hook, éste es para un script
              que  se  ejecuta  durante  el  postinst   de   un   paquete   de
              documentación,  de  cabeceras, o fuente. El uso de esta variable
              en paquetes con cabeceras ahora  está  desaconsejado,  en  algún
              momento el script de postinst del paquete con las cabeceras sólo
              deberá ejecutar header_postinst_hook. La ruta puede ser relativa
              si  el programa se encuentra en una ruta segura (es decir, si se
              localiza en /bin, /sbin,  /usr/bin,  o  /usr/sbin),  o  en  caso
              contrario  debe ser una ruta absoluta.  Este script necesita dos
              argumentos, el primero es el nombre  del  paquete  que  se  esta
              instalando (kernel-headers-X.X.XX), y el segundo argumento es la
              versin del paquete que esta siendo instalado. Los errores en el
              script causarán el fallo de postinst.

       headers_postinst_hook
              A  diferencia  de las otras variables hook, ésta es sólo para un
              script que se ejecuta durante  el  postinst  de  un  paquete  de
              cabeceras.  La  ruta  puede  ser  relativa  si  el  programa  se
              encuentra en una ruta segura (es decir, si se localiza en  /bin,
              /sbin,  /usr/bin, o /usr/sbin), o en caso contrario debe ser una
              ruta absoluta. Este script necesita dos argumentos,  el  primero
              es  el  nombre  del  paquete  que se esta instalando (podría ser
              kernel-source-X.X.XX  o  kernel-headers-X.X.XX),  y  el  segundo
              argumento  es  la versin del paquete que esta siendo instalado.
              Los errores en el script sólo producirán un mensaje de aviso.

       move_image
              En vez de crear el enlace simbólico a  (o,  si  reverse_symlinks
              está  establecida,  desde)  image_dest, La imagen se mueve desde
              /boot a image_dest.  Si reverse_symlinks está establecida  /boot
              contendrá  un  enlace  simbólico  a la imagen real.  Esta opción
              puede ser útil para aquellos  que  usen  loadlin,  y  que  quizá
              necesiten  mover  la  imagen  a una partición diferente, de dos.
              Por omisión esta variable está sin establecer.

       clobber_modules
              Si  está   establecida,   el   preinst   tratará   de   eliminar
              /lib/modules/version  sin comunicarlo si es la misma versión que
              la de la imagen siendo instalada. Uselo bajo su responsabilidad.
              Por omisión esta variable está sin establecer.

       warn_reboot
              Esta  variable  se  puede  utilizar  para  deshabilitar el aviso
              cuando se instala un núcleo de la misma versión que el que  está
              en  ejecución actualmente. Si se cambia la lista de módulos, las
              dependencias de módulos habrán cambiado, y los módulos del nuevo
              núcleo  podrían  no ejecutarse correctamente en el núcleo actual
              si el ABI del núcleo ha cambiado en el intermedio. Es una  buena
              idea  reiniciar,  y esto es una nota para recordarle. Si sabe lo
              que hace puede definir esta variable a No.  Esta  variable  está
              definida por omisión.

       do_bootloader
              Si es NO, hace que el postinst no ejecute el gestor de arranque.
              Por omisión es Yes.

       relative_links
              Si es Yes, el script de postinst de la imagen del núcleo  tomará
              medidas  adicionales  para que el enlace simbólico sea relativo.
              Normalmente el enlace es relativo sólo si es relativamente fácil
              saber que el enlace relativo funcionará. Por omisión es No.

       do_initrd
              Si  es  YES  el script de postinst de kernel-image no avisará de
              que está instalando un núcleo que usa initrd. Esto asume que  ha
              configurado   correctamente  su  gestor  de  arranque  para  que
              arranque la imagen initrd. Por omisión es No. Esta  opción  está
              desaconsejada  en favor de la opción más descriptiva warn_initrd
              (dese cuenta que el sentido de la opción es el contrario).

       warn_initrd
              Si es NO el script de postinst de kernel-image no avisará de que
              está  instalando  un  núcleo  que  usa initrd. Esto asume que ha
              configurado  correctamente  su  gestor  de  arranque  para   que
              arranque  la  imagen  initrd. Esta opción se prefiere respecto a
              do_initrd, ya que lo que se previene son los avisos
               . Por omisión es Yes.

       use_hard_links
              Esta  opción  es  para  aquellos  que  no  puedan  usar  enlaces
              simbólicos  (por  ejemplo,  si  el  gestor  de  arranque  no los
              soporta). Si es YES, esto hará que el postinst de la imagen  del
              núcleo  use  enlaces duros en vez de los enlaces simbólicos para
              los ficheros /vmlinuz y /vmlinuz.old, manejados automáticamente.
              He   tratado   de   que   sea   compatible   con   move_image  y
              reverse_symlinks  Precaución:  Es  trabajo  del  usuario   final
              asegurarse  de  que  el  directorio  image_dest y el lugar de la
              imagen (normalmente /boot) se encuentran en el mismo sistema  de
              ficheros (ya que no se pueden crear enlaces duros entre sistemas
              de ficheros).  Está avisado.

       relink_build_link
              Esta opción manipula el enlace de construcción  creado  por  los
              núcleos  recientes.  Si  el  enlace  es un enlace colgante, y si
              parece que el correspondiente kernel-headers está  instalado  en
              el  sistema,  se creará un nuevo enlace apuntándolo. Por omisión
              se reenlazará el directorio de construcción (YES).

       force_build_link
              Esta opción manipula el enlace de construcción  creado  por  los
              núcleos  recientes. Si el enlace es un enlace colgante se creará
              un nuevo enlace a /usr/src/kernel-headers-X.Y.ZZ,  sin  importar
              que  estén  o no instalados. Por omisión está sin establecer, ya
              que no creamos enlaces colgantes de forma predeterminada.

       relink_src_link
              Esta opción manipula el enlace al código fuente creado  por  los
              últimos  núcleos.  Si el enlace es un enlace colgante se elimina
              durante la instalación.   Por  omisión  re-enlaza  (elimina)  el
              enlace «source» («YES»).

       mkimage
              Debe  ser  una  orden  que  produzca  una  imagen initrd dado un
              directorio. Se pasa a la opción -m del programa  mkinitrd.   Por
              ejemplo, puede ser
               mkimage="genromfs -d %s -f %s" o
               mkimage="mkcramfs %s %s"

       silent_modules
              Está opción es para aquellos a quienes les molesta cuando se les
              avisa    de    módulos    existentes    en     el     directorio
              /lib/modules/$version.  Este directorio probablemente pertenezca
              a un paquete kernel-image-$version viejo o que ya no existe,  en
              cuyo  caso  pueden  aparecer  problemas  con  módulos  que hayan
              quedado en ese directorio, o  puede  que  el  directorio  exista
              legítimamente  porque se haya instalado un paquete independiente
              con módulos para la misma versión del  núcleo.  En  este  último
              caso  la  existencia  del  directorio  es totalmente benigna. Si
              establece esta variable, nunca más podrá cancelar la instalación
              si  se  detecta  previamente un directorio /lib/modules/$version
              existente. Por omisión no está establecido.

       silent_loader
              Si está establecida, está opción hará que se omita  la  pregunta
              realizada  antes  de  ejecutar  el gestor de arranque durante el
              proceso de instalación. Esta opción no afecta a que el gestor de
              arranque  sea  o no ejecutado (véase do_bootloader para entender
              como controlarlo, la ausencia de  un  fichero  de  configuración
              hará el proceso de instalación ameno e interactivo).

       ignore_depmod_error
              Si está establecida, no pide confirmación para continuar después
              de un problema con depmod en el script de post-instalación. Esto
              facilita   las   instalaciones   automatizadas,   aunque   puede
              enmascarar algún problema con la imagen  del  núcleo.  De  todas
              formas todavía se muestra un diagnóstico.

FICHEROS

       El fichero descrito en este documento es /etc/kernel-img.conf.

VÉASE TAMBIÉN

       make-kpkg(1), kernel-pkg.conf(5), make(1), El manual de GNU Make.

FALLOS

       No  tiene  fallos.  Cualquier  cosa que se lo parezca es un delirio, de
       verdad.

AUTOR

       Esta   página   del   manual   fue   escrita   por   Manoj   Srivastava
       <srivasta@debian.org>, para el sistema Debian GNU/Linux.

TRADUCTOR

       Traducción de Rubén Porras Campo <debian-l10n-spanish@lists.debian.org>
       Revisión y actualización de Rudy Godoy <rudy@kernel-panik.org>