Linux Certif

Toute la documentation sur la certification Linux LPI

kernel-img.conf

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 versión de la imagen del núcleo, el segundo es la localización 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 versión de la imagen del núcleo, el segundo es la localización 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 versión de la imagen del núcleo, el segundo es la localización 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 versión de la imagen del núcleo, y el segundo es la localización 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 versión del paquete que esta siendo instalado. Los errores en el script causarán el fallo de postinst.

header_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 versión 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>