diff options
| author |   Thomas Deutschmann <whissi@gentoo.org> | 2019-07-28 22:56:30 +0200 |
|---|---|---|
| committer | Thomas Deutschmann <whissi@gentoo.org> | 2019-07-29 22:00:26 +0200 |
| commit | c452f3d690dc695a55aee63f0f2e4ab0cbb7b93a (patch) | |
| tree | c7278cc815e28883cda9e5172d6694735d98978e /doc/genkernel.8.txt | |
| parent | Make initramfs and kernel filename customizable (diff) | |
| download | genkernel-c452f3d690dc695a55aee63f0f2e4ab0cbb7b93a.tar.gz genkernel-c452f3d690dc695a55aee63f0f2e4ab0cbb7b93a.tar.bz2 genkernel-c452f3d690dc695a55aee63f0f2e4ab0cbb7b93a.zip | |
Change kernel and initramfs default filename in $BOOTDIR
This commit will change default kernel and initramfs filename:
kernel-genkernel-%%ARCH%%-%%KV%% -> vmlinuz-%%KV%%
System.map-genkernel--%%ARCH%%-%%KV%% -> System.map-%%KV%%
initramfs-genkernel-%%ARCH%%-%%KV%% -> initramfs-%%KV%%.img
The new naming will be consistent with kernel's "make install" and
will allow to match files in /lib/modules with actual kernel.
In addition, $ARCH value was moved to kernel's LOCALVERSION. This will
ensure that this information is still present and when you do
cross-compilation, that /lib/modules content don't get mixed.
Bug: https://bugs.gentoo.org/390407
Signed-off-by: Thomas Deutschmann <whissi@gentoo.org>
Diffstat (limited to 'doc/genkernel.8.txt')
| -rw-r--r-- | doc/genkernel.8.txt | 21 |
1 files changed, 16 insertions, 5 deletions
diff --git a/doc/genkernel.8.txt b/doc/genkernel.8.txt index e94fa120..35762a2d 100644 --- a/doc/genkernel.8.txt +++ b/doc/genkernel.8.txt @@ -125,8 +125,19 @@ KERNEL CONFIGURATION Adds, or skip adding VirtIO support to kernel configuration. *--kernel-localversion*=<...>:: - Set kernel option CONFIG_LOCALVERSION. Use special value "UNSET" to - unset any already set LOCALVERSION. +Set kernel option *LOCALVERSION*. Use special value *UNSET* to +unset any already set *LOCALVERSION*. The following placeholders are +available: ++ +[horizontal] +*%%ARCH%%*::: +Will be replaced with genkernel arch value, for example 'x86_64'. + ++ +*LOCALVERSION* is only allowed to contain characters like 'a-z' or 'A-Z', +'0-9', '_', '.' and '-'. ++ +By default, *LOCALVERSION* will be set to '-%%ARCH%%'. KERNEL COMPILATION @@ -437,7 +448,7 @@ Set initramfs filename which will be used when initramfs will be installed into *BOOTDIR* (implies *--install* option). Please see *--kernel-filename* option for available placeholders and restrictions. + -By default, initramfs filename will be set to 'initramfs-genkernel-%%ARCH%%-%%KV%%'. +By default, initramfs filename will be set to 'initramfs-%%KV%%.img'. *--initramfs-symlink-name*=<...>:: Set initramfs symlink name which will be used when initramfs will be @@ -477,7 +488,7 @@ Will be replaced with kernel version, for example '5.2.3-gentoo'. Kernel filename is only allowed to contain characters like 'a-z' or 'A-Z', '0-9', '_', '.' and '-'. + -By default, kernel name will be set to 'kernel-genkernel-%%ARCH%%-%%KV%%'. +By default, kernel name will be set to 'vmlinuz-%%KV%%'. NOTE: When setting a custom kernel name make sure that your bootloader and tools like *kexec* when used are recognizing your custom kernel name. @@ -502,7 +513,7 @@ Set System.map filename which will be used when kernel will be installed into *BOOTDIR* (implies *--install* option). Please see *--kernel-filename* option for available placeholders and restrictions. + -By default, System.map filename will be set to 'System.map-genkernel-%%ARCH%%-%%KV%%'. +By default, System.map filename will be set to 'System.map-%%KV%%'. *--systemmap-symlink-name*=<...>:: Set System.map symlink name which will be used when kernel will be |