Genkernel/es

es una herramienta creada por Gentoo que se utiliza 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 (spla.github.io/sh), módulos añadidos y demás.
 * Comprimir el initramfs.
 * Configurar el Gestor de arranque para arrancar el núcleo e initramfs recientemente creados.

Emerge
Lance la instalación de genkernel:

Utilización
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  en cada invocación. La opciones que se pasan como parámetros a la orden son preferentes a las definidas en. El fichero de configuración está muy bien documentado, sin embargo, algunas de las opciones más usadas se explorarán en este artículo. El objetivo es que el lector se familiarice con las invocaciones comunes de genkernel. Para obtener explicaciones más completas, 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 al usuario 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 o no. La siguientes opciones de configuración se consideran principales:

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

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.


 * Specifies the compiler employed during the kernel compilation process.
 * Specifies the compiler employed during the kernel compilation process.


 * Specifies the linker employed during the kernel compilation process.
 * Specifies the linker employed during the kernel compilation process.


 * Specifies the assembler employed during the kernel compilation process.
 * Specifies the assembler employed during the kernel compilation process.


 * Specifies an alternative to the GNU make utility employed during the kernel compilation process.
 * Specifies an alternative to the GNU make utility employed during the kernel compilation process.


 * Specifies the compiler employed during the compilation of support utilities.
 * Specifies the compiler employed during the compilation of support utilities.


 * Specifies the linker employed during the compilation of support utilities.
 * Specifies the linker employed during the compilation of support utilities.


 * Specifies the assembler employed during the compilation of support utilities.
 * Specifies the assembler employed during the compilation of support utilities.


 * Specifies an alternative to the GNU make utility employed during the compilation of support utilities.
 * Specifies an alternative to the GNU make utility employed during the compilation of support utilities.


 * Specifies the number of concurrent threads that the make utility can implement while the kernel (and utilities) are being compiled. The variable  is a number to be freely chosen, although the most common values are obtained by adding one (1) to the number of cores used by the system, or just use the number of cores on the system. So, for a system with one core, most common option values are   or  ; a system with two cores most likely uses the   or   options, and so on. (A system with one processor that supports Hyper-Threading™ (HT) Technology can be assumed to have 2 cores, provided Symmetric Multi-Processing (SMP) support is enabled in the kernel.)
 * Specifies the number of concurrent threads that the make utility can implement while the kernel (and utilities) are being compiled. The variable  is a number to be freely chosen, although the most common values are obtained by adding one (1) to the number of cores used by the system, or just use the number of cores on the system. So, for a system with one core, most common option values are   or  ; a system with two cores most likely uses the   or   options, and so on. (A system with one processor that supports Hyper-Threading™ (HT) Technology can be assumed to have 2 cores, provided Symmetric Multi-Processing (SMP) support is enabled in the kernel.)

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

Opciones de depuración
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 esta información.


 * Controls the level of verbosity for information provided by genkernel. The variable  is an integer between 0 and 5. The level '0' represents minimal output, while '5' provides as much information as possible about genkernel's activities during the kernel compilation process.
 * Controls the level of verbosity for information provided by genkernel. The variable  is an integer between 0 and 5. The level '0' represents minimal output, while '5' provides as much information as possible about genkernel's activities during the kernel compilation process.


 * Ignores the value set by the  option (above) and sends all debugging data produced by genkernel to the specified output file. Outputs to  by default.
 * Ignores the value set by the  option (above) and sends all debugging data produced by genkernel to the specified output file. Outputs to  by default.


 * Activates (or deactivates) colored output of debugging information (reported by genkernel) using escape sequences.
 * Activates (or deactivates) colored output of debugging information (reported by genkernel) using escape sequences.


 * Activates (or deactivates) the full post-run cleanup for debug purposes.
 * Activates (or deactivates) the full post-run cleanup for debug purposes.

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

Comenzar
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 que se deberá instalar de forma manual. 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. Se ofrecerá al usuario una herramienta de configuración basada en menús para seleccionar qué módulos se construirán en el sistema.

Si se reemplaza la opción  por   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. El uso de la opción  le indica a genkernel que monte la partición  de forma automática si es necesario.

Cambiar el núcleo
Lo primero que se debe hacer es permitir que se lance en el fichero :

Gestión de ficheros
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
Después de lanzar la orden, siempre que los nuevos fuentes estén disponibles, se creará un nuevo directorio de ficheros fuente 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, el enlace simbólico  se actualiza automáticamente para que apunte al los nuevos ficheros fuente instalados.


 * Si el ajuste USE  no está definido, el usuario puede cambiar el destino del enlaces simbólico utilizando  seguido de la orden.

Genkernel utilizará siempre (exclusivamente) los fuentes a lo que apunta el enlace simbólico.

Fichero de configuración del núcleo
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   sería el nombre de la arquitectura del sistema,   sería la versión de los ficheros fuente utilizados, y   la revisión de los fuentes.

Es este fichero el que se utiliza como configuración cuando se lanza.

Si es la primera vez que se lanza genkernel con los nuevos fuentes del núcleo 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.

Guardar la configuración compilada
Si se activa la opción  de genkernel, bien desde la línea de órdenes, bien dentro de, la configuración del núcleo que se ha compilado se guardará (con el nombre indicado arriba) en el directorio. Al mismo tiempo, la configuración se guarda en el fichero dentro del directorio, sin embargo, este fichero no se reutilizará en la siguiente ejecución de.

Instalar el núcleo y el initramfs en el directorio
Si se especifica la opción  cuando se lanza genkernel, se le pedirá a genkernel que instale la imagen del núcleo y el initramfs en el directorio. Para lanzar  de una forma correcta, defina lo siguiente en el fichero :


 * 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 modifica su nombre añadiendo . 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.

Después de lanzar, el directorio tendrá un aspecto similar al siguiente:

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 el fichero de configuración:


 * Añadir, a los parámetros del núcleo que se pasan a la imagen, donde  apunta a la partición raíz (  es el número de partición si ésta existe).
 * Si está utilizando la pantalla de presentación de arranque (splash), se debe añadir una línea moda adecuada, como por ejemplo pasar  a los parámetros del núcleo y también   o   dependiendo del nivel de detalle que desee a lo largo del proceso de arranque.
 * Añadir la información sobre initrd que requiera la configuración del gestor de arranque. Consulte el capítulo de configuración del cargador de arranque del manual de Gentoo para obtener detallas sobre la configuración del gestor de arranque con initrd.

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

Conservar los 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.


 * El segundo aspecto importante es conservar las imágenes del núcleo e initramfs que arrancan correctamente. La forma de realizar esto depende del contexto:
 * Si el último núcleo que se construyó arranca correctamente, al lanzar se cambiará el nombre a la imagen este núcleo (y de igual forma al initramfs) a  y se creará un nuevo . Esto implica que, en caso de que el nuevo núcleo no arranque, los usuarios siempre podrán arrancar con el antiguo.
 * Si el último núcleo que se construyó no arranca y los ficheros fuente no han cambiado desde que el usuario construyó un nuevo núcleo, antes de lanzar, se deberá eliminar la nueva imagen del núcleo y quitar el sufijo del último núcleo que arrancara. Si no se hace esto y el nuevo núcleo construido no arranca en la segunda ocasión, el núcleo arrancable  será sustituido por el núcleo  que no arranca, por lo que usuario no podrá arrancar su sistema. Para initramfs se emplea el mismo razonamiento.

Utilizar el núcleo anterior mientras se cambian los ficheros fuente
Se puede utilizar la configuración anterior mediante la variable MENUCONFIG en tal y como se indica a continuación:

Desde un CD de instalación
La utilidad 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 e initramfs con soporte para arranque desde la 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 las tarjetas de interfaz de red (NIC) del sistema. 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.

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 la plataforma específica de su interés.

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 la opción. Ambos se especificar en cada máquina usando un dirección MAC para identificarlas:

Instrucciones de arranque desde 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 a continuación 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 y. 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).

compile failed: Kernel not found
Se puede experimentar este fallo cuando se intenta compilar un núcleo para una arquitectura con un fichero de configuración de un núcleo para una arquitectura diferente de la actual. Este caso podría ser tan simple como el de una máquina que correo un núcleo y se intenta construir un núcleo para una máquina.

Esto puede suceder cuando se inicia desde un LiveCD en un sistema que puede operar a 64 bits pero el destino a instalar o reparar es de 32 bits. Una vez comienza el proceso de compilación intentará detectar de forma automática la arquitectura del sistema destino basándose en el núcleo que está corriendo actualmente. Si el núcleo actual es de 64 bit, entonces, a menos que se indique lo contrario, asumirá que se desea un núcleo de 64 bits.

Se puede suponer entonces que en el fichero del núcleo se ha deshabilitado x64. La orden se lanzará y el binario del núcleo correspondiente se localizará en el directorio asociado. Cuando vaya a instalar (mover y renombrar) el núcleo, no lo podrá encontar ya que espera un núcleo de 64 bits.

La solución a este problema es definir la opción  de  a, en este caso, la arquitectura. La orden a lanzar podría tener el siguiente aspecto:

Para marcar permanentemente la opción de la arquitectura deseada, se debe modificar la variable ARCH_OVERRIDE en el fichero.

Véase también

 * Configuración manual del núcleo - Para cuando sea necesario hacer las cosas de forma manual.
 * Dracut - Otro constructor de initramfs disponible en Gentoo.