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 KernelsDESCRIPTION
This eclass provides various utility functions related to Distribution Kernels.SUPPORTED EAPIS
7 8FUNCTIONS
- 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.
ECLASS VARIABLES
- 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.
AUTHORS
Michał Górny <mgorny@gentoo.org>MAINTAINERS
Distribution Kernel Project <dist-kernel@gentoo.org>REPORTING BUGS
Please report bugs via https://bugs.gentoo.org/FILES
dist-kernel-utils.eclassSEE ALSO
ebuild(5)https://gitweb.gentoo.org/repo/gentoo.git/log/eclass/dist-kernel-utils.eclass
Index
- NAME
- DESCRIPTION
- SUPPORTED EAPIS
- FUNCTIONS
- ECLASS VARIABLES
- AUTHORS
- MAINTAINERS
- REPORTING BUGS
- FILES
- SEE ALSO
This document was created by man2html, using the manual pages.
Time: 03:27:01 GMT, September 22, 2023