Genkernel/es

es una herramienta que se utiliza para automatizar el proceso de construcción del núcleo e initramfs. Algunas de las características generales incluyen:


 * Configuring the kernel sources.
 * Building the compressed kernel and copying it to.
 * Creating an initramfs and copying it to.
 * Creating symlinks in.
 * Adding custom content to the initramfs such as encryption related files, boot splash images, extra modules, and more.
 * Compressing the initramfs.
 * Configuring the bootloader.

Emerge
Lance la instalación de genkernel:

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

Opciones
The actual behavior of genkernel depends on a large variety of options, the majority of which can be set/unset in the file or passed via the  command on each invocation. Options passed over the command line take precedence over options defined in. The configuration file is very well documented, however some of the most commonly used options will be explored in this article. The goal is for the reader to be familiar with common genkernel invocations. For a more complete set of explanations refer to the comments in itself or to the output of.

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.

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.

Acciones
The action passed on the command line with the tells genkernel what action to perform. The following actions are supported:

Comenzar
Although there are several ways to run genkernel, the least-intrusive approach recommended for most users is provided by. 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 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
The first thing that should be done is to allow the triggering of in the  file:

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
After an, 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, el enlace simbólico  se actualiza automáticamente para que apunte al los nuevos ficheros fuente instalados.


 * If the  USE is not set, the user can change the destination of the symlink using the  followed by the  command.

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.

It is this file that is used as a starting configuration when running .

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

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.

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

{{Cmd|ls -al /boot|output= total 41336 drwxr-xr-x 3 root root    4096 20 abril 17:23. drwxr-xr-x 24 root root   4096 15 sept. 12:31 .. lrwxrwxrwx 1 root root       1 24 febr. 2013 boot ->. drwxr-xr-x 2 root root    4096 24 febr. 2013 grub lrwxrwxrwx 1 root root      40 20 abril 17:23 initramfs -> initramfs-genkernel-x86_64-3.7.10-gentoo -rw-r--r-- 1 root root 1314412 20 abril 17:23 initramfs-genkernel-x86_64-3.7.10-gentoo -rw-r--r-- 1 root root 1313548 21 marzo 2013  initramfs-genkernel-x86_64-3.7.10-gentoo.old -rw-r--r-- 1 root root 1295344 25 febr. 2013 initramfs-genkernel-x86_64-3.7.9-gentoo -rw-r--r-- 1 root root 3310324 25 febr. 2013 initramfs-genkernel-x86_64-3.7.9-gentoo.old lrwxrwxrwx 1 root root      44 20 abril 17:23 initramfs.old -> initramfs-genkernel-x86_64-3.7.10-gentoo.old lrwxrwxrwx 1 root root      37 20 abril 17:23 kernel -> kernel-genkernel-x86_64-3.7.10-gentoo -rw-r--r-- 1 root root 4866656 20 abril 17:23 kernel-genkernel-x86_64-3.7.10-gentoo -rw-r--r-- 1 root root 4866560 21 marzo 2013  kernel-genkernel-x86_64-3.7.10-gentoo.old -rw-r--r-- 1 root root 4552288 25 febr. 2013 kernel-genkernel-x86_64-3.7.9-gentoo -rw-r--r-- 1 root root 3400736 25 febr. 2013 kernel-genkernel-x86_64-3.7.9-gentoo.old lrwxrwxrwx 1 root root      41 20 abril 17:23 kernel.old -> kernel-genkernel-x86_64-3.7.10-gentoo.old }}

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.

To allow the kernel and intird provided by genkernel to run correctly, provide a minimum information in bootloader's configuration file:


 * Add  to the kernel parameters passed to the kernel image, where  points to the root partition (  is the number of the partition if a partition exists).
 * 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 the bootloader initrd-aware.

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.


 * 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 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  variable in  as follows:

Desde un CD de instalación
The 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.

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:

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

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.

This can be experienced when booting from a x86_64 livecd on a system that is capable of operating in 64-bits, however the target to be installed or repaired is 32-bits. After the compilation process begins, will attempt to automatically detect the architecture for the target based on the currently running kernel. If the currently running kernel is 64-bit, then, unless it is told otherwise, will presume it should be looking for a 64-bit kernel.

Suppose then that the kernel's file has x64 disabled. The command will execute and the resulting kernel binary will be placed in the associated  directory. When goes to install (move and rename) the kernel it cannot find the kernel because it expected a 64-bit kernel.

The solution to this failure is to set 's  option to, in this case, the  architecture. The final command could look like this:

Para marcar permanentemente la opción de la arquitectura deseada, se debe modificar la variable  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.