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 ficheros fuente 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 genkernel. 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 man genkernel.

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
 * Activates [ or deactivates] the make menuconfig command (which invokes an interactive configuration menu) before building the kernel.


 * --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 la pantalla de inicio del framebuffer Fbsplash 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; 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.


 * --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;algúnMake&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   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>
 * Activates [or deactivates] the make clean command before compiling your kernel. The make clean command removes all object files and dependencies from the kernel's source tree.


 * <tt>--[no-]mrproper</tt>
 * Activates [or deactivates] the make mrproper command before kernel compilation. Like the make clean command, make mrproper removes all object files and dependencies from the kernel's source tree. However, any previous configuration files (in or ) will also be purged from the kernel's source tree.


 * <tt>--oldconfig</tt>
 * Issues the make oldconfig command, which attempts to collect configuration information for the system's architecture from a generic script in . This is a non-interactive process; no user input is entertained. Also, if <tt>--oldconfig</tt> is used in conjunction with <tt>--clean</tt>, the latter option is negated, resulting in the activation of the <tt>--no-clean</tt> option.


 * <tt>--callback="echo hello"</tt>
 * Calls the specified arguments ( echo hello, in this case) after the kernel and the relevant modules have been built, but before building the initrd image. This may be useful if you want to install external modules in the initrd image by emerging the relevant item(s) with the callback feature, and then redefining a genkernel module group.


 * <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 <tt>--loglevel</tt> 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
The action passed on the command line with the <tt>genkernel [options …] action</tt> command, tells genkernel what to do. The following <tt>actions</tt> are supported:


 * all
 * Builds all stages — the initrd, kernel image and modules.


 * bzImage
 * Only builds the kernel image


 * kernel
 * Only builds the kernel image and modules


 * initramfs
 * Only builds the initramfs/ramdisk image


 * ramdisk
 * Only builds the initramfs/ramdisk image

La primera invocación de Genkernel
Although there are several ways to run genkernel, the least-intrusive approach recommended for most users is provided by genkernel all. Here, a generic configuration which works well for most systems is used. As was mentioned earlier, this approach is not without drawbacks; most of the modules created are useless to the average user and may increase compile time. Below is an illustration of a more efficient approach, achieved by passing certain options to genkernel as 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
The first thing that should be done is to allow the triggering of make menuconfig in the file:

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 fichero fuente del núcleo.

Ficheros fuente utilizado por genkernel
After an emerge -u gentoo-sources, whenever new sources are available, a new kernel source directory is created under to host them. Normally, the active kernel sources directory is pointed to by the symlink.

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 ficheros fuente instalados.


 * If the previous USE flag is not set, the user can change the destination of the symlink using the eselect kernel list command.

Whatever it is, genkernel always uses the sources pointed by this symlink.

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 fuente que está utilizando y r1 es la "release" de los fuentes.

It is this file that is used as a starting configuration when running  genkernel --menuconfig all.

If it is the first time that genkernel is run with the new kernel sources, or if the previous result has not been saved, this file is substituted with a default configuration file that resides at where x86_64 is substituted with the actual architecture.

Guardar la configuración compilada
If the <tt>save-config</tt> 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 genkernel all run.

Instalar el núcleo y el initramfs en el directorio /boot
The <tt>all</tt> action specified when invoking genkernel, ask genkernel 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:


 * El primer parámetro no requiere explicación.


 * El segundo parámetro le indica a genkernel que guarde la configuración del núcleo que se ha compilado en.


 * Las dos últimas opciones le indican a genkernel que actualice automáticamente la configuración de grub. En la práctica sucede lo siguiente:
 * Si existe una imagen previa del núcleo con el mismo nombre, se renombra añadiendo <tt>.old</tt>. Un enlace simbólico se crea automáticamente apuntando a ella.
 * El nuevo núcleo toma el lugar de cualquier núcleo con el mismo nombre dentro de . Si es la primera vez que se compila un núcleo, se crea automáticamente un enlaces simbólico que apunta al nuevo núcleo.

After running genkernel --menuconfig all, the directory might look like this:

Configurar el gestor de arranque
Los enlaces simbólicos que se muestran arriba en la configuración del gestor de arranque se pueden utilizar tal cual, incluso cuando el núcleo no se puede arrancar, el usuario siempre podrá arrancar el antiguo.

Para permitir que el núcleo y el initrd ofrecido por genkernel funcione correctamente, deberá ofrecer a su gestor de arranque una información mínima en su fichero de configuración: Capítulo de Configuración del Gestor de Arranque del manual de Gentoo para obtener detallas sobre la configuración de su gestor de arranque con initrd.
 * Añada, a los parámetros del núcleo que se pasan a la imagen, donde  apunta a la partición raíz.
 * Si está utilizando la pantalla de presentación de arranque (splash), añada un parámetro correcto para el modo de pantalla, por ejemplo, así como   o   dependiendo del nivel de detalle que desee a lo largo del proceso de arranque.
 * Añada la información sobre initrd que requiera la configuración de su gestor de arranque. Consulte el

A continuación se muestra un ejemplo del aspecto que debería tener el fichero.

Conservar sus ficheros de trabajo
La aplicación genkernel guarda automáticamente los cambios realizados en los ficheros. Si se necesita conservar cambios realizados anteriormente se deberán realizar las siguientes acciones.


 * El primer fichero a conservar es la configuración del núcleo en . Si los ficheros fuente no han cambiado antes de la reconstrucción del núcleo, se usará el nombre utilizado anteriormente para este fichero. Por lo que si se copia la configuración anterior a un nuevo nombre, se podrá conservar la información para utilizar este fichero como punto de partida para una nueva configuración.


 * 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 genkernel 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 genkernel, 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.

Utilizar el núcleo anterior mientras se cambian los ficheros fuente
The previous configuration can be used through the make menuconfig option in your as follows:

Arranque desde la red con Genkernel desde un CD de instalación
La utilidad genkernel puede construir el núcleo y las imágenes initrd que ofrecen soporte para arranque por red netbooting. Con un poco de suerte, los usuarios deberían poder arrancar desde la red con cualquier ordenador reciente dentro del entorno que ofrece el CD de instalación.

La magia está en el guión linuxrc de genkernel: Este intentará montar el CD de instalación en la red (netmount) usando NFS. A partir de aquí los guiones de inicio del CD de instalación pueden tomar el control como si el CD estuviera presente localmente.

Construir el núcleo y las imágenes initrd con soporte para arranque por red
Para habilitar el soporte de arranque por red, incluya las siguientes opciones mientras configura su núcleo:

En primer lugar, la imagen del núcleo debe incluir los controladores para sus tarjetas de interfaz de red (NIC). Normalmente, los controladores para estos dispositivos se compilarán como módulos. Sin embargo, es esencial (para el arranque por red) tener dichos controladores compilados directamente en la imagen del núcleo y no como módulos.

Asegúrese de seleccionar <tt>&lt;*&gt;</tt> y no <tt>&lt;M&gt;</tt>.

En segundo lugar, se sugiere que se habilite la opción IP: kernel level autoconfiguration así como IP: DHCP support options. Esto evita una capa innecesaria de complejidad ya que la dirección IP y la ruta NFS al CD de instalación se pueden configurar en un servidor DHCP. Por supuesto, esto significa que la línea de órdenes del núcleo permanecerá constante para todas las máquinas, lo cual es muy importante para realizar etherbooting (arranque vía ethernet).

Estas opciones le indican al núcleo que envíe una petición DHCP en el momento del arranque.

Adicionalmente, debería activar SquashFS ya que la mayoría de los CD de instalación actuales de Gentoo así lo requieren. El soporte para SquashFS no se incluye en el árbol genérico de fuentes del núcleo. Para activar SquashFS, debe aplicar los parches necesarios para las fuentes genéricas del núcleo o instalar el paquete gentoo-sources.

Una vez completado el proceso de compilación, cree un tarball (tar.gz) que contenga los módulos del núcleo. Este paso es solo es necesario si su versión del núcleo no concuerda con la versión de la imagen del núcleo del CD de Instalación.

Para crear un archivo que contenga todos los módulos:

Dependiendo de su mecanismo de arranque por red necesitará seguir alguno de los siguientes pasos:

Para crear una imagen etherboot:

Para crear una imagen TFTP OpenBoot/SPARC64

El fichero es la imagen de inicio.

Para terminar, copie este núcleo al servidor TFTP. Los detalles de este paso dependen de la arquitectura y están fuera de la intención de esta guía. Por favor, consulte la documentación de su plataforma.

Configurar NFS
Para configurar un recurso compartido de NFS que contenga el CD de instalación, use el dispositivo loop para montar la imagen ISO y a continuación copie los contenidos del CD en el recurso NFS. Como característica extra, los guiones initrd de genkernel extraerán todos los archivos tar.gz ubicados en el directorio. Todo lo que debe hacer aquí es copiar el fichero al directorio.

Lo que sigue asume que es un recurso NFS compartido:

Ahora copie el fichero a :

Configurar DHCP
Las imágenes del arranque por red (netboot) solicitarán a su servidor DHCP una dirección IP así como el parámetro <tt>root-path</tt>. Ambos se especificar en cada máquina usando un dirección MAC para identificarlas:

Instrucciones de Arranque por Red
De nuevo indicaremos que el arranque por red depende en gran medida de la plataforma. La parte importante es especificar los parámetros  y  en la línea de órdenes del núcleo pues esto activará la interfaz de red y le indicará a los guiones initrd que monten el CD de instalación a través de NFS. Se muestran a continuación algunos consejos que dependen de la plataforma:

Para etherboot, inserte el disco de etherboot en la unidad y reinicie. La línea de órdenes del núcleo se especificó cuando se construyó la imagen.

En Sparc64, pulse - en la línea de órdenes de arranque y teclee:

Para PXE, configure pxelinux (que es parte de syslinux) y a continuación cree un fichero con las siguientes líneas:

Introducción
Si instaló un initramfs con genkernel, eche un vistazo a las diversas opciones de inicio que puede (o debería) definir en la configuración de su gestor de arranque. Las más comunes se han incluido en esta guía.

Cargar LVM o software RAID
Si el sistema utiliza LVM o software RAID, tendrá que construir el initramfs utilizando las opciones <tt>--lvm</tt> y <tt>--mdadm</tt>. No olvide habilitar este soporte durante el inicio. Esto se puede hacer mediante las opciones dolvm y domdadm.

Iniciar en modo de único usuario (single-user)
Si, por alguna razón, el inicio falla, debería poder rescatar su sistema iniciando en modo único usuario (single-user). Esto carga únicamente los servicios necesarios y a continuación ofrece un intérprete de órdenes de rescate (root).

Agradecimientos
Nos gustaría dar las gracias a los siguientes autores y editores por sus contribuciones a esta guía:


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