Genkernel/es

genkernel se usa para automatizar el proceso de construcción del Núcleo e initramfs. Algunas de las características generales incluyen:
 * Configurar los fuentes del núcleo
 * Construir el núcleo comprimido y copiarlo a
 * Crear un initramfs y copiarlo a
 * Crear enlaces simbólicos en
 * Añadir código del usuario al initramfs tal como ficheros de cifrado, imágenes de inicio (splash), módulos añadidos y demás
 * Comprimir el initramfs
 * Configurar el Gestor de arranque

Instalación
Para instalar, seleccione en primer lugar los ajustes USE adecuados.

A continuación se puede realizar la instalación del software de genkernel.

Invocación de Genkernel
La forma general de invocar a genkernel se muestra a continuación:

Opciones
El comportamiento actual de genkernel depende de un gran número de opciones, la mayoría de las cuales se pueden activar o desactivar en el fichero o pasarse a través de la orden. La opciones que se pasan como parámetros a la orden son preferentes a las definidas en. Este fichero está muy bien documentado, sin embargo, aquí echaremos un vistazo a las opciones más comunes. Para una explicación más completa, por favor, lea los comentarios en el propio fichero o la salida de la orden.

Opciones que actúan en la interactividad del usuario
Las opciones de configuración listadas abajo ayudan a decidir cómo interaccionar con el proceso de configuración. Los usuarios pueden incluso escoger si el archivo de configuración creado en el proceso se debería guardar. La siguientes son las opciones de configuración principales:


 * --[no-]menuconfig
 * Activa [o desactiva] la orden  (que invoca a la utilidad de configuración interactiva del núcleo basada en menús de pantalla) antes de compilar el núcleo.


 * --gconfig
 * Ofrece una utilidad de configuración del núcleo que depende de las bibliotecas GTK+-. La ventaja de esta opción es que la mayoría de los usuarios piensan que el uso esta herramienta hace más fácil y clara la configuración del núcleo ya que se basa en el sistema X-Window. Su desventaja es que se necesita el sistema X-Window para usarla, así que no funcionará en la línea de órdenes.

--xconfig Ofrece una utilidad de configuración del núcleo que depende de las bibliotecas QT. La ventaja de esta opción es que el uso de esta herramienta para configurar el núcleo es para la mayoría de los usuarios más sencilla y clara, ya que se basa en el sistema X-Window. Su desventaja es que necesita el sistema X-Window para utilizarla, así que no funcionará en la línea de órdenes.

Guarda [o no] la configuración del núcleo a un fichero en el directorio para un uso posterior.
 * --[no-]save-config


 * --kernname=&lt;SobreNombre&gt;: Permite la modificación del nombre del núcleo y las imágenes initrd en el directorio de forma que la imágenes producidas son de la forma  e.

Opciones que afectan al sistema resultante
Las opciones de configuración mostradas a continuación definen características que podrán ser o no activadas en el núcleo e initrd resultantes.


 * --[no-]splash
 * Activa [o desactiva] el soporte para el framebuffer splash en el initrd que genkernel va a construir. Para anular el tema por defecto usado por fbsplash use el parámetro --splash=&lt;TemaPreferido&gt; (donde &lt;TemaPreferido&gt;</tt> es el título de uno de los directorios ubicados dentro del directorio ).


 * --splash-res=&lt;ResoluciónPreferida&gt;</tt>
 * Esta opción le permite seleccionar las resoluciones de pantalla de arranque soportadas en el initrd mientras se inicia el sistema. Esto es útil por dos motivos: el primero, que puede seleccionar las resoluciones de pantalla de arranque que se pueden aplicar a su sistema. Segundo, evita hacer uso de mayor espacio en disco requerido por initrd (puesto que initrd no ofrece soporte para aquellas resoluciones irrelevantes a la configuración de su sistema). No obstante, puede que desee omitir esta opción si construye el núcleo para un CD de Instalación; esto permite soporte de splash para todas las resoluciones posibles.


 * --do-keymap-auto</tt>
 * Forzar la sección del mapa del teclado durante la secuencia de inicio


 * --lvm</tt>
 * Incluye soporte de almacenamiento a través de

Gestión de Volúmenes Lógicos (LVM2) a partir de binarios estáticos, si están disponibles en el sistema. Los binarios (estáticos) de LVM2 se compilan si no están presentes. Asegúrese de instalar el paquete lvm2 en su sistema con emerge lvm2 antes de habilitar esta opción y revise el artículo sobre LVM en el wiki de Gentoo.


 * --dmraid</tt>
 * Incluye suporte para DMRAID, la utilidad que crea mapas RAID usando el subsistema de mapa de dispositivos (device-mapper) del núcleo. DMRAID descubre, activa, desactiva y muestra las propiedades de conjuntos de software RAID (por ejemplo, ATARAID) y particiones DOS contenidas.


 * --luks</tt>
 * Incluye soporte para la configuración unificada de claves Linux (Linux Unified Key Setup) o LUKS. Esto le permitirá usar un dispositivo cifrado con LUKS que contenga el sistema de archivos raíz. En el gestor de arranque se define el dispositivo cifrado como el valor de de crypt_root (y real_root será el dispositivo descifrado que creará LUKS).


 * --disklabel</tt>
 * Añade soporte para etiquetas de disco y UUID al initrd.


 * --iscsi</tt>
 * Añade soporte para iSCSI al initrd.


 * --multipath</tt>
 * Añade soporte para Multipath al initrd.


 * --linuxrc=/camino/a/su/linuxrc</tt>
 * Especifica la ruta al archivo creado por el usuario y denominado linuxrc, un guión inicializado durante la etapa de inicio del núcleo previo

al proceso de arranque real. (La ubicación por defecto del guión linuxrc debería ser el directorio ). Este guión le permite iniciar el arranque de un pequeño núcleo modular y cargar los controladores necesitados (como módulos) por el sistema.


 * --cachedir=/camino/a/camino/alternativo</tt>
 * Permite cambiar la localización de la caché que se utiliza por defecto para compilar el núcleo.


 * --tempdir=/camino/al/nuevo/directoriotemporal</tt>
 * Especifica la localización del directorio temporal utilizado por genkernel para compilar el núcleo.


 * --unionfs</tt>
 * Incluye soporte para el Sistema de Ficheros Unificado en la imagen initrd.


 * --mountboot</tt>
 * Detecta si el directorio necesita o no montarse en una partición separada. Revisará el

fichero para obtener instrucciones acerca de cómo montar la partición boot en un sistema de archivos (si esto es necesario).

Opciones que actúan en la elección de las herramientas utilizadas para la construcción
Las siguientes opciones están soportadas por genkernel y se pasan a las aplicaciones relevantes mientras se ensambla el núcleo. Estas opciones afectan a las herramientas de compilación utilizadas en el proceso de compilación del núcleo aunque a un nivel mucho más bajo.


 * --kernel-cc=&lt;algúnCompilador&gt;</tt>
 * Especifica el compilador que se empleará durante el proceso de construcción del núcleo.


 * --kernel-ld=&lt;algúnEnlazador&gt;</tt>
 * Especifica el enlazador que se utilizará en el proceso de construcción del núcleo.


 * <tt>--kernel-as=&lt;algúnEnsamblador&gt;</tt>
 * Especifica el ensamblador que se utilizará en el proceso de construcción del núcleo.


 * <tt>--kernel-make=&lt;algúnMake&gt;</tt>
 * Especifica una alternativa a la utilidad GNU make que se empleará en el proceso de construcción del núcleo.


 * <tt>--utils-cc=&lt;algúnCompilador&gt;</tt>
 * Especifica el compilador que se utilizará para construir la utilidades de soporte a la construcción.


 * <tt>--utils-ld=&lt;algúnEnlazador&gt;</tt>
 * Especifica el enlazador que se utilizará en el proceso de construcción de las utilidades de soporte.


 * <tt>--utils-as=&lt;algúnEnsamblador&gt;</tt>
 * Especifica el ensamblador que se utilizará para la construcción de las utilidades de soporte.


 * <tt>--utils-make=&lt;someMake&gt;</tt>
 * Especifica una alternativa a la utilidad GNU make que se empleará para la construcción de las utilidades de soporte.


 * <tt>--makeopts=-jX</tt>
 * Especifica el número de hilos concurrentes que puede implementar la utilidad make mientras se compila el núcleo (y sus utilidades). La variable  es un número que se obtiene al sumar uno (1) al número de procesadores usados por el sistema. Así, para un sistema que tenga un núcleo, el parámetro apropiado es   o , un sistema con dos procesadores usará probablemente el parámetro <c>-j3</c> o   y así sucesivamente (Se puede asumir que un sistema con un solo procesador que soporte la tecnología Hyper-Threading&trade; (HT) tiene dos núcleos, siempre y cuando el multiprocesamiento paralelo (Symmetric Multi-Processing o SMP) esté habilitado en el núcleo).

Opciones que actúan en el proceso de compilación
Las siguientes opciones normalmente actúan durante el proceso de compilación:


 * <tt>--kerneldir=/camino/a/los/fuentes/</tt>
 * Especifica una localización alternativa a los ficheros fuente del núcleo en lugar de la localización por defecto.


 * <tt>--kernel-config=/camino/al/fichero-de-configuración</tt>
 * Especifica qué configuración alternativa se utilizará para el núcleo en lugar del fichero de configuración por defecto.


 * <tt>--module-prefix=/camino/al/prefijo-de-directorio/</tt>
 * Especifica un prefijo del directorio donde se instalarán los módulos del núcleo (el camino por defecto es el directorio ).


 * <tt>--[no-]clean</tt>
 * Activa [o desactiva] la orden  antes de compilar su núcleo. La orden   elimina todos los ficheros objeto y dependencias del árbol de fuentes del núcleo.


 * <tt>--[no-]mrproper</tt>
 * Activa [o desactiva] la orden  antes de la compilación del núcleo. Al igual que la orden ,   elimina todos los ficheros objeto y dependencias del árbol de fuentes del núcleo. Sin embargo, también se eliminarán del árbol cualquier configuración previa (in  o ).


 * <tt>--oldconfig</tt>
 * Lanza la orden, la cual intenta reunir información de configuración de la arquitectura del sistema a partir del guión genérico ubicado en . Este no es un proceso interactivo, no se requiere intervención del usuario. Si se usa <tt>--oldconfig</tt> junto a <tt>--clean</tt>, la última opción se cambia, lo que resulta en la habilitación de la orden <tt>--no-clean</tt>.


 * <tt>--callback="echo hola"</tt>
 * Realiza una llamada a los argumentos especificados (, en este caso) después de que se hayan compilado el núcleo y los módulos relevantes, pero antes de compilar la imagen de initrd. Esto puede ser útil si quiere instalar módulos externos en la imagen initrd instalando los componentes relevantes con la característica "callback" y redefiniendo a continuación el grupo de módulos de genkernel.


 * <tt>--[no-]install</tt>
 * Activa [o desactiva] la orden, que instala su nueva imagen del núcleo, el fichero de configuración, la imagen initrd y el mapa del sistema en su partición boot ya montada. Así mismo se instalarán los módulos compilados.


 * <tt>--no-ramdisk-modules</tt>
 * Evita copiar cualquier módulo a la imagen initrd creada por genkernel. Esta opción es una excepción a la regla del prefijo <tt>no-</tt>; la omisión de este prefijo resultará en un opción inválida en genkernel.


 * <tt>--all-ramdisk-modules</tt>
 * Copia todos los módulos disponibles a la imagen initrd creada por genkernel.


 * <tt>--genzimage</tt>
 * Crea la imagen initrd previa a la imagen del núcleo. (Este truco actualmente solo es válido en los sistemas Pegasos PPC).

Depurar opciones
El uso de opciones de depuración durante el proceso de construcción del núcleo controla la cantidad de información que se muestra, así como la presentación de dicha información.


 * <tt>--loglevel=&lt;nivelinformación&gt;</tt>
 * Controla la cantidad (nivel) de información de salida que ofrece genkernel. La variable  es un número entero cuyo valor está entre 0 y 5. El nivel '0' representa una cantidad mínima de información de    salida mientras que '5' entrega la mayor cantidad de información posible acerca de las actividades de genkernel durante el proceso de construcción del núcleo.


 * <tt>--logfile=/camino/al/fichero-de-salida</tt>
 * Ignora el valor definido por la opción <c>--loglevel</c> y envía toda la información de depuración generada por genkernel al fichero de salida especificado, el cual se ubica por defecto en.


 * <tt>--[no-]color</tt>
 * Activa [o desactiva] la salida a color de la información de depuración (generada por genkernel), para ello utiliza secuencias de escape.

Acción
Una acción enviada a genkernel en la línea de comandos mediante, le indica a   qué debe hacer. Se ofrecen las siguientes acciones:


 * Construye todas los pasos: el initrd, el núcleo, la imagen y los módulos.
 * Construye todas los pasos: el initrd, el núcleo, la imagen y los módulos.


 * Únicamente construye la imagen del núcleo
 * Únicamente construye la imagen del núcleo


 * Únicamente construye la imagen del núcleo y los módulos
 * Únicamente construye la imagen del núcleo y los módulos


 * Únicamente construye la imagen initramfs/ramdisk
 * Únicamente construye la imagen initramfs/ramdisk


 * Únicamente construye la imagen initramfs/ramdisk
 * Únicamente construye la imagen initramfs/ramdisk

La primera invocación de Genkernel
Aunque hay varias formas de lanzar genkernel, el enfoque menos intrusivo y recomendado para la mayoría de los usuarios es mediante. En este caso se utiliza una configuración genérica que funciona bien en la mayoría de los sistemas. Tal como se mencionaba arriba, este enfoque presenta ciertas desventajas pues la mayor parte de los módulos creados no son útiles para el usuario promedio y puede incrementar el tiempo de compilación. Abajo se muestra un ejemplo de un enfoque más eficiente el cual se logra al pasar ciertos parámetros a genkernel cuando se lanza con el usuario root:

La operación descrita arriba provoca que genkernel cree un núcleo con pantalla una pantalla de bienvenida (<tt>--splash</tt>) que se deberá instalar de forma manual (<tt>--no-install</tt>). Mientras se prepara el árbol de fuentes del núcleo, genkernel evitará eliminar cualquiera de los archivos objeto preexistentes en el árbol de los fuentes (<tt>--no-clean</tt>). Se ofrecerá al usuario una herramienta de configuración basada en menús para seleccionar qué módulos se construirán en el sistema (<tt>--menuconfig</tt>).

Si se reemplaza la opción <tt>--no-install</tt> por <tt>--install</tt> se le indicará a genkernel que instale el nuevo núcleo en el directorio de forma automática y se crearán los enlaces simbólicos se se especifica <tt>--symlink</tt>. El uso de la opción <tt>--mountboot</tt> le indica a genkernel que monte la partición de forma automática si es necesario.

Usar Genkernel para cambiar su núcleo
Lo primero que se debe hacer es permitir que se lance  en el fichero :

Gestión de ficheros realizada por genkernel
Mientras utiliza genkernel, debe tener en cuenta varios aspectos relacionados con su configuración y los ficheros de imagen del núcleo así como la forma en la que el sistema gestiona los fuentes del núcleo.

Ficheros fuente utilizado por genkernel
Después de lanzar la orden, siempre que los nuevos fuentes estén disponibles, se creará un nuevo directorio de fuentes del núcleo en  para almacenarlos. Normalmente los fuentes activos del núcleo se definen con el enlace simbólico.

El directorio debería un aspecto similar a este:

El enlace simbólico se puede cambiar de diferentes formas:


 * Si el ajuste USE  está definido en, el enlace simbólico  se actualiza automáticamente para que apunte al los nuevos fuentes instalados.


 * Si el ajuste USE indicado arriba no se ha definido, el usuario puede cambiar el destino del enlaces simbólica con la orden.

De cualquier forma,  siempre utliza los fuentes a los que apunta este enlace simbólico.

Fichero de configuración utilizado por genkernel
Si ya se ha realizado una construcción del núcleo con los fuentes activos, debería aparecer un fichero dentro del directorio que contiene al configuración del núcleo que se ha aplicado mientras se creó la última bzimage del núcleo. Este fichero se llama, por ejemplo, donde x86_64 es el nombre de su arquitectura, 3.7.9 es la versión de los ficheros fuentes que está utilizando y r1 es la "release" de los fuentes.

Es este fichero el que se utiliza como configuración cuando se realiza la llamada a.

Si es la primera vez que se lanza  o si no se ha guardado el resultado previo este fichero se sustituye por un fichero de configuración por defecto que se encuentra en  donde hay que sustituir x86_64 por la arquitectura en la que se está trabajando.

Saving the compiled configuration
If the  genkernel option  is activated, either from the command line or inside, the compiled kernel configuration is saved (with the name given above) into the  directory. At the same time, the configuration is saved in the file in  directory but this file is not reused on the next   run.

Installing the kernel and initramfs into the /boot directory
The  action specified when invoking genkernel, ask   to install the kernel image and the initramfs into the  directory. In order to do it in a convenient manner, set the following in the  file:


 * The first parameter speaks by itself.


 * The second parameter tells genkernel to save the compiled kernel configuration into.


 * The last two options tell genkernel to automatically update the grub configuration. In practice, the following happens:
 * if a previous kernel image with the same name already exist, it is renamed by appending <tt>.old</tt> to its name. A symlink is automatically created that points to it.
 * the new kernel takes the place of any kernel with the same name into . If it is the first time a kernel is compiled, a symlink kernel is automatically created that points to the new kernel.

After running, the  directory might look like this:

Configuring the bootloader
The symlinks presented above in the bootloader's configuration can be used so that, even if the new kernel is not bootable, the user can always boot on the old one.

To allow the kernel and intird provided by genkernel to run correctly, provide a minimum information in your bootloader configuration file :
 * Add  to the kernel parameters passed to the kernel image, where  points to the root partition.
 * If splash is used, add a suitable mode line such as  to the parameters passed to the kernel and also add   or   depending on the verboseness required through the boot process.
 * Add the initrd information as required by the bootloader. Consult the Bootloader Configuration Chapter of the Gentoo Handbook for details on how to make your bootloader initrd-aware.

Here is how the file might look.

Preserving your working files
The genkernel application automatically saves new changes to the files. If previous changes are to be preserved, then the following actions need to be taken.


 * The first file to preserve is the kernel configuration file in . If the source hasn't changed prior to the recompilation of the kernel, the previously used name for this file will be used. So copying the previous configuration file under a different name helps in preserving the information while keeping the file available as a starting point for a new configuration.


 * The second important thing is to preserve the already bootable kernel and initramfs images. The way to accomplish this depends on the context:
 * If the last kernel compiled is bootable, running  will rename this kernel (and similarly initramfs) image to  and create a new . This mean that even if the new kernel is not bootable, users will always be able to boot the old one.
 * If the last kernel compiled is not bootable and sources haven't changed since the user compiled a bootable one, prior to running, first delete the new kernel image and remove the <tt>.old</tt> suffix from the last bootable one. Without this, if the newly compiled kernel is not bootable for the second time, the bootable  will be kicked out by the renaming of the non bootable , giving the user an unbootable system. Use the same reasoning for initramfs.

Using previous kernel configuration while changing the sources
The previous configuration can be used through the  option in your  as follows:

Network Booting with Genkernel from an Installation CD
The genkernel utility can build kernel and initrd images that provide support for network booting, or netbooting. With any luck, users should be able to netboot any recent computer into the environment provided by the Installation CD.

The magic lies in genkernel's linuxrc script: it will try to netmount the Installation CD using NFS. From there, the init scripts of the Installation CD can take over, as if the CD was present locally.

Building Kernel and Initrd Images with Support for Netbooting
To enable support for netbooting, include the following options while configuring the kernel:

First, the kernel image must include the drivers for your Network Interface Cards (NIC). Normally, drivers for such devices will be compiled as modules. However, it is essential (for netbooting) that such drivers are compiled directly into the kernel image and not as modules.

Be sure to select <tt>&lt;*&gt;</tt> and not <tt>&lt;M&gt;</tt>.

Secondly, it is suggested that IP: kernel level autoconfiguration is enabled as well as IP: DHCP support options. This avoids an unnecessary layer of complexity since the IP address and the NFS path to the Installation CD can be configured on a DHCP server. Of course, this means the kernel command line will remain constant for any machine — which is very important for etherbooting.

These options tell the kernel to send a DHCP request at bootup.

Additionally, enable SquashFS because most modern Gentoo Installation CDs require it. Support for SquashFS is not included with the generic kernel source tree. To enable SquashFS, apply the necessary patches to the generic kernel source or install gentoo-sources.

Once the compilation process is completed, create a compressed tarball (tar.gz) that contains the kernel's modules. This step is only necessary if the kernel version does not match the kernel image version on the Installation CD.

To create an archive containing all the modules:

Depending on the network boot mechanism, one of the following steps need to be followed:

To create an etherboot image:

To create a OpenBoot / SPARC64 TFTP image:

The file is the boot image.

Finally, copy this kernel to the TFTP server. The details are architecture-dependent and are beyond the scope of this guide. Please refer to the documentation for your platform.

NFS setup
To setup a NFS share that contains the Installation CD, use the loop device to mount the ISO image and then copy the contents of the CD into the NFS share. As a nice extra, genkernel's initrd scripts will extract all tar.gz files located in the directory. All that needs to be done here is copy the archive to the  directory.

The following assumes that is an exported NFS share:

Now copy the file into :

DHCP setup
The netboot images will ask the DHCP server on the network for an IP as well as a <tt>root-path</tt> parameter. Both can be specified per host using a MAC address to identify machines:

Netbooting Instructions
Netbooting itself is again very platform-specific. The important part is to specify the  and   parameters on the kernel command line, as this will bring up the network interface and tell the initrd scripts to mount the Installation CD via NFS. Here are some platform-specific tips.

For etherboot, insert the etherboot disk into the drive and reboot. The kernel command line was specified when the image was constructed. With Sparc64, hit - at the boot prompt and enter:

For PXE, setup pxelinux (part of syslinux), then create a along the lines of:

Introduction
If an initramfs is installed with genkernel, then take a look at the various boot options that can (or should) be defined in the bootloader configuration. The most common ones are added to this guide.

Loading LVM or software-RAID
If the system uses LVM or software-RAID, the initramfs has to be built using the <tt>--lvm</tt> and <tt>--mdadm</tt> options. Don't forget to enable support during boot as well. This can be done using the dolvm and domdadm options.

Booting in single-user mode
If for some reason boot-up fails, rescuing the system by booting in the single-user mode is still possible. This will only load the really necessary services and then drop the user to a rescue (root) shell.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Tim Yamin
 * Jimi Ayodele
 * Thomas Seiler
 * Joshua Saddler
 * Sebastian Pipping
 * José Fournier