DIST-KERNEL-UTILS.ECLASS

Section: eclass-manpages (5)
Updated: Sep 2023
Index Return to Main Contents

NAME

dist-kernel-utils.eclass - Utility functions related to Distribution Kernels

This eclass provides various utility functions related to Distribution Kernels.

7 8

dist-kernel_build_initramfs <output> <version>: Build an initramfs for the kernel. <output> specifies the absolute path where initramfs will be created, while <version> specifies the kernel version, used to find modules.
Note: while this function uses dracut at the moment, other initramfs variants may be supported in the future.
dist-kernel_get_image_path: Get relative kernel image path specific to the current ${ARCH}.
dist-kernel_install_kernel <version> <image> <system.map>: Install kernel using installkernel tool. <version> specifies the kernel version, <image> full path to the image, <system.map> full path to System.map.
dist-kernel_reinstall_initramfs <kv-dir> <kv-full>: Rebuild and install initramfs for the specified dist-kernel. <kv-dir> is the kernel source directory (${KV_DIR} from linux-info), while <kv-full> is the full kernel version (${KV_FULL}). The function will determine whether <kernel-dir> is actually a dist-kernel, and whether initramfs was used.
This function is to be used in pkg_postinst() of ebuilds installing kernel modules that are included in the initramfs.
dist-kernel_PV_to_KV <pv>: Convert a Gentoo-style ebuild version to kernel "x.y.z[-rcN]" version.

KERNEL_IUSE_SECUREBOOT (SET BEFORE INHERIT): If set to a non-null value, inherits secureboot.eclass and allows signing of generated kernel images.
KERNEL_EFI_ZBOOT: If set to a non-null value, it is assumed the kernel was built with CONFIG_EFI_ZBOOT enabled. This effects the name of the kernel image on arm64 and riscv. Mainly useful for sys-kernel/gentoo-kernel-bin.

Michał Górny <mgorny@gentoo.org>

Distribution Kernel Project <dist-kernel@gentoo.org>

Please report bugs via https://bugs.gentoo.org/

dist-kernel-utils.eclass

This document was created by man2html, using the manual pages.
Time: 03:27:01 GMT, September 22, 2023