sys-kernel: Update README for current implementation

This commit is contained in:
Benjamin Gilbert 2017-01-19 16:31:59 -08:00
parent 60e48323b6
commit 04b06091d2

View File

@ -1,11 +1,11 @@
The kernel is provided in two parts: coreos-sources and coreos-kernel. The kernel is provided in three parts: coreos-sources, coreos-modules,
and coreos-kernel.
coreos-sources is a traditional Gentoo kernel source ebuild, which coreos-sources is a traditional Gentoo kernel source ebuild, which
installs to ${ROOT}/usr/src/linux-${PV}. No extra revision or name is installs to ${ROOT}/usr/src/linux-${PV}-coreos${COREOS_SOURCE_REVISION}.
added since, like the upstream vanilla-sources, we don't ship patches.
coreos-kernel uses the installed sources to build a kernel image and all coreos-modules uses the installed sources to build the kernel modules.
modules. The kernel config is searched for in the files directory based The kernel config is searched for in the files directory based
on the ebuild version and revision. For example version 3.12.4-r2: on the ebuild version and revision. For example version 3.12.4-r2:
- amd64_defconfig-3.12.4-r2 - amd64_defconfig-3.12.4-r2
- amd64_defconfig-3.12.4 - amd64_defconfig-3.12.4
@ -19,7 +19,10 @@ for using the same rules - for example:
- commonconfig-3.12 - commonconfig-3.12
- commonconfig - commonconfig
Currently our dracut based initrd (bootengine) gets built directly into coreos-kernel uses the installed sources and coreos-modules to build the
kernel image and initramfs.
Currently our dracut based initramfs (bootengine) gets built directly into
the kernel image, including all kernel modules. (go go modular kernels!) the kernel image, including all kernel modules. (go go modular kernels!)
This reason for this screwy scheme never came to pass and should be This reason for this screwy scheme never came to pass and should be
fixed eventually. The current grub bootloader already includes logic for fixed eventually. The current grub bootloader already includes logic for
@ -27,5 +30,5 @@ initrds but the old configure_bootloaders and coreos-postinst scripts
need to be updated in order to support existing installs. need to be updated in order to support existing installs.
The coreos-firmware package is a magic version of the upstream The coreos-firmware package is a magic version of the upstream
linux-firmware ebuild which scans the modules installed by coreos-kernel linux-firmware ebuild which scans the modules installed by coreos-modules
and only installs files modules declare as required. and only installs files modules declare as required.