Genkernel

• Deutsch
• English
• español
• français
• italiano
• magyar
• português do Brasil
• русский
• தமிழ்
• 中文(中国大陆)‎
• 日本語
• 한국어

Ugyanez igaz a genkernel initramfs képfájljára is: Elsődleges feladata, hogy csak az alapvető dolgokat hozza létre, amelyek szükségesek egy (blokk) eszköz felcsatolásához, amely tartalmazza a gyökérfájlrendszert, hogy a lehető leggyorsabban átadhassa az irányítást az igazi rendszernek.

Where options have only a negative effect, the no-, and its effect, which are not optional in this case, are figured without square brackets. }}

--config=/path/to/genkernel.conf

Points to the Genkernel configuration file to use (defaults to /etc/genkernel.conf).

--kernel-config=/path/to/kernel.config

Points to the kernel configuration file to use. To re-use the kernel configuration from the currently running kernel, it is possible to specify /proc/config.gz if it exists. By default, genkernel uses the config from the previous build of the same kernel version or a default kernel config if there isn't a previous config. Use the special value default to force usage of genkernel's generic kernel config. This location must not be /usr/src/linux/.config as it risks being lost or causing errors.

--[no-]menuconfig

Activates (or deactivates) the make menuconfig command (which invokes an interactive configuration menu) before building the kernel.

--gconfig

Provides a kernel configuration utility which depends on the GTK libraries. The advantage of this option is that most users find it easier and clearer to configure the kernel using this tool, since it relies on the X-windowing system. The disadvantage of this option is that the X-windowing system is required to use it, so it will not work on the command line.

--xconfig

Provides a kernel configuration utility which depends on the QT libraries. The advantage of this option is that most users find it easier and clearer to configure the kernel using this tool, since it relies on the X-windowing system. The disadvantage of this option is that the X-windowing system is needed to use it, so it will not work on the command line.

--[no-]save-config

Saves [or does not save] the kernel configuration to a file in the /etc/kernels directory for later use.

--kernel-append-localversion=-mycfg42

Allows the modification of kernel's LOCALVERSION value which will affect kernel's and and initramfs' filename in /boot and modules in /lib/modules/ directory. This is especially helpful to build a new independent revision with its own kernel binary, initramfs and modules. The example above, with =sys-kernel/gentoo-sources-5.4.2, would create /boot/vmlinuz-5.4.2-gentoo-x86_64-mycfg42, /boot/initramfs-5.4.2-gentoo-x86_64-mycfg42.img and /lib/modules/4.19.88-gentoo-x86_64-mycfg42 on amd64 with default settings.

--[no-]splash

Aktiválja (vagy deaktiválja) a Fbsplash framebuffer splash támogatását a genkernel által létrehozott initrd bináris képfájlon. Az fbsplash által használt alapértelmezett téma felülbírálásához használja a --splash=PreferredTheme opciót (ahol a PreferredTheme a /etc/splash könyvtáron belüli egyik könyvtár neve).

--splash-res=PreferredResolution

Ez az opció lehetővé teszi annak kiválasztását, hogy mely indítóképernyő-felbontások legyenek támogatottak az initrd bináris képfájlban a rendszer indításakor. Ez két okból hasznos. Először is, lehetőség nyílik csak a rendszerhez kapcsolódó indítóképernyő-felbontások kiválasztására. Másodszor, elkerülhető az initrd által igényelt lemezterület felesleges növekedése (mivel az initrd fájlnak nem kell támogatnia a rendszer beállításához nem releváns felbontásokat). Azonban ezt az opciót célszerű elhagyni, ha a kernelt telepítő CD lemezhez állítják össze, mivel ez lehetővé teszi az indítóképernyő minden lehetséges felbontásának támogatását.

--do-keymap-auto

Kényszeríti a billentyűzetkiosztás kiválasztását az indítási folyamat során.

--keymap

Aktiválja a billentyűzetkiosztás kiválasztását indításkor (például LUKS konténer jelszó megadásához). A kívánt billentyűzetkiosztás az indítási opciókban adható meg keymap értékeként (a billentyűzetkiosztás fájl neve ".map" nélkül). Az elérhető billentyűzetkiosztási fájlok megtalálhatók a /usr/share/genkernel/defaults/keymaps/ könyvtárban.

Ha egy szükséges billentyűzetkiosztás nem érhető el a genkernelben, akkor lehetőség van az egyik meglévő sys-apps/kbd billentyűzetkiosztás (ami a /usr/share/genkernel/defaults/keymaps/ elérhető) konvertálására a loadkeys --bkeymap parancs segítségével. További részletekért tekintse meg a loadkeys man súgóját.

--lvm

Tartalmazza az adathordozó támogatást a Logical Volume Management (LVM2) számára statikus bináris fájlok segítségével, ha az elérhető a rendszeren. Ha nem állnak rendelkezésre releváns (statikus) LVM2 bináris fájlok, akkor azok le lesznek fordítva. Az opció engedélyezése előtt győződjön meg arról, hogy telepítve van a sys-fs/lvm2 szoftvercsomag az operációs rendszeren (emerge sys-fs/lvm2), majd tekintse át a Gentoo wiki LVM cikkét.

--dmraid

Tartalmazza a DMRAID támogatását, az eszközt, amely RAID leképezéseket hoz létre a kernel eszköz-leképezési alrendszer segítségével. A DMRAID felismeri, aktiválja, deaktiválja és megjeleníti a szoftver RAID készletek (például ATARAID) és a bennük található DOS partíciók tulajdonságait.

--luks

Tartalmazza a Linux Unified Key Setup vagy LUKS támogatását. Ez lehetővé teszi egy olyan adathordozó használatát, amelyet LUKS titkosított, és amely tartalmazza a root fájlrendszert. A bootloadernél a titkosított adathordozót állítsa be crypt_root értékeként, míg a root az a nem titkosított adathordozó lesz, amelyet a LUKS létrehoz (például: /dev/mapper/root lesz a felcsatolandó útvonal, és a helyes bootloader paraméterek sora így nézhet ki: GRUB_CMDLINE_LINUX="... crypt_root=UUID=<crypto_LUKS uuid> root=/dev/mapper/root ...").

--iscsi

iSCSI támogatást ad az initrd bináris képfájlhoz.

--multipath

Multipath támogatást ad az initrd bináris képfájlhoz.

--linuxrc=/path/to/the/linuxrc_file

Megad egy felhasználó által létrehozott linuxrc-t — egy olyan szkriptet, amely a kernel indítási szakaszában inicializálódik, az aktuális boot folyamat előtt. Egy alapértelmezett linuxrc szkript megtalálható a /usr/share/genkernel/ könyvtárban. Ez a szkript lehetővé teszi egy kis, modularizált kernel indítását, megpróbálja betölteni a rendszer számára szükséges legkevesebb mennyiségű illesztőprogramot (kernelmodulok formájában).

--cachedir=/path/to/alt/dir

Felülírja az alapértelmezett gyorsítótár helyét a kernel forráskódjának a bináris kódra történő fordítása közben.

--tmpdir=/path/to/new/tempdir

Megadja annak az ideiglenes könyvtárnak a helyét, amelyet a genkernel a kernel forráskódjának a fordítása közben használ.

--unionfs

Támogatást nyújt a Unification File System számára az initrd bináris képfájlon belül.

--mountboot

Érzékeli, hogy a /boot könyvtárat külön partícióra kell-e felcsatolni. Ellenőrzi az /etc/fstab szkriptet, hogy hogyan kell (ha szükséges) a boot partíciót a fájlrendszerre felcsatolni.

--microcode

Létrehoz egy korai cpio fájlt, amely Intel/AMD processzorok mikrokódját tartalmazza a Xen és a Linux korai mikrokód támogatásához.

--splash-res=PreferredResolution

This option allows to select which splash screen resolutions will be supported in the initrd during the start-up of the system. This is useful for two reasons. First, to be able to select only the splash screen resolution(s) relevant to the system. Second, to avoid the unnecessary increase in the disk space required by initrd (since the initrd does not have to support resolutions that are irrelevant for the system's configuration.) However, the option is best omitted if the kernel is being compiled for an Installation CD; this allows splash support for all possible resolutions.

--do-keymap-auto

Force keymap selection during the boot sequence.

--keymap

Enables keymap selection at boot (e.g. for LUKS container password input). The desired keymap can be passed in boot options as the value of keymap (name of the keymap file without .map). Available keymap files can be found in /usr/share/genkernel/defaults/keymaps/.

If a needed keymap is not available in genkernel, it is possible to convert one of the existing sys-apps/kbd keymaps (available in /usr/share/genkernel/defaults/keymaps/) using loadkeys --bkeymap. See loadkeys man page for details.

--lvm

Includes support for storage using via Logical Volume Management (LVM2) from static binaries, if available to the system. Relevant (static) LVM2 binaries are compiled when unavailable. Be sure to install the sys-fs/lvm2 package on the system (emerge sys-fs/lvm2) before enabling this option.

--dmraid

Includes support for DMRAID; the utility which creates RAID mappings using the kernel device-mapper subsystem. DMRAID discovers, activates, deactivates and displays properties of software RAID sets (ATARAID, for example) and contained DOS partitions.

--luks

Includes support for Linux Unified Key Setup. This will allow to use a device encrypted by LUKS which contains the root filesystem. On the bootloader, set that encrypted device as the value of crypt_root, and root shall be the unencrypted device LUKS creates ( i.e /dev/mapper/root will be path to mount, and proper boot parameters line will look, like this: GRUB_CMDLINE_LINUX="... crypt_root=UUID=<crypto_LUKS uuid> root=/dev/mapper/root ...").

--iscsi

Adds support for iSCSI to the initrd.

--multipath

Adds support for Multipath to the initrd.

--linuxrc=/path/to/the/linuxrc_file

Specifies a user-created linuxrc — a script that is initialized during the start-up stage of the kernel, prior to the actual boot process. A default linuxrc script can be found in the /usr/share/genkernel/ directory. This script allows booting into a small, modularized kernel; it tries to load the minimum amount of drivers that are needed (as modules) by the system.

--cachedir=/path/to/alt/dir

Overrides the default cache location used while compiling the kernel.

--tmpdir=/path/to/new/tempdir

Specifies the location of the temporary directory used by genkernel while compiling the kernel.

--unionfs

Includes support for the Unification File System in the initrd image.

--mountboot

Detects whether or not the /boot directory needs to be mounted on a separate partition. It will check /etc/fstab script for instructions on how to mount the boot partition on a file system (if needed).

--microcode

Creates an early cpio filled with microcode for Intel/AMD processors for Linux early microcode support.

--kernel-cc=someCompiler

Specifies the compiler employed during the kernel compilation process.

--kernel-ld=someLinker

Specifies the linker employed during the kernel compilation process.

--kernel-as=someAssembler

Specifies the assembler employed during the kernel compilation process.

--kernel-make=someMake

Specifies an alternative to the GNU make utility employed during the kernel compilation process.

--utils-cc=someCompiler

Specifies the compiler employed during the compilation of support utilities.

--utils-ld=someLinker

Specifies the linker employed during the compilation of support utilities.

--utils-as=someAssembler

Specifies the assembler employed during the compilation of support utilities.

--utils-make=someMake

Specifies an alternative to the GNU make utility employed during the compilation of support utilities.

--makeopts=-jX

Specifies the number of concurrent threads that the make utility can implement while the kernel (and utilities) are being compiled. The variable X is a number to be freely chosen, although the most common values are obtained by adding one (1) to the number of cores used by the system, or just use the number of cores on the system. So, for a system with one core, most common option values are -j2 or -j1; a system with two cores most likely uses the -j3 or -j2 options, and so on. (A system with one processor that supports Hyper-ThreadingTM (HT) Technology can be assumed to have 2 cores, provided Symmetric Multi-Processing (SMP) support is enabled in the kernel.)

--kerneldir=/path/to/sources/

Specifies an alternative kernel source location, rather than the default /usr/src/linux/ location.

--kernel-config=/path/to/config-file

Specifies which kernel configuration will be used. By default, genkernel will determine kernel version found in --kerneldir and look for kernel config (KV) in /etc/kernels/kernel-config-$KV. If no kernel configuration was found, genkernel will look for a generic kernel configuration in /usr/share/genkernel/$ARCH. A special value default can be used to force usage of genkernel's generic kernel configuration.

Tip
Use --kernel-config=/proc/config.gz to start building a new kernel based on kernel configuration from currently running kernel.
Note: This will only work if current active kernel was built with CONFIG_IKCONFIG=y which is normally the case.

--module-prefix=/path/to/prefix-directory/

Specifies a prefix to the directory where kernel modules will be installed (default path is the /lib/modules directory.)

--[no-]clean

Activates (or deactivates) the make clean command before compiling the kernel. The make clean command removes all object files and dependencies from the kernel's source tree.

--[no-]mrproper

Activates (or deactivates) the make mrproper command before kernel compilation. Like the make clean command listed above, make mrproper removes all object files and dependencies from the kernel's source tree. However, any previous configuration files (in /path/to/sources/.config or /path/to/sources/.config.old) will also be purged from the kernel's source tree. If it is undesirable that the kernel's .config file keeps disappearing, be sure to disable this option!

--oldconfig

Issues the make oldconfig command, which attempts to collect configuration information for the system's architecture from a generic script in /usr/share/genkernel. This is a non-interactive process; no user input is entertained. Also, if --oldconfig is used in conjunction with --clean, the latter option is negated, resulting in the activation of the --no-clean option.

--[no-]module-rebuild

Runs, or does not run emerge @module-rebuild to build out-of-tree modules after kernel and kernel modules have been built. This option is enabled by default.

--callback="echo hello"

Calls the specified arguments (echo hello, in this case) after the kernel and the relevant modules have been built, but before building the initramfs.

Note
Before genkernel-4, this callback was used to trigger rebuild of out-of-tree modules. Since genkernel-4, a dedicated command-line parameter --module-rebuild was introduced, see above.

--[no-]install

Activates (or deactivates) the make install command, which installs the new kernel image, configuration file, initrd image and system map onto the boot partition. Any compiled modules will be installed as well. By default genkernel will attempt mount /boot if it is on a separate partition before running the install command.

--no-ramdisk-modules

Refrains from copying any modules to the genkernel-created initrd image. This option is an exception to the rule about the no- prefix; omission of this prefix creates an invalid genkernel option.

--all-ramdisk-modules

Copies all available modules to the genkernel-created initrd image.

--genzimage

Creates the initrd image, prior to the kernel image (this hack currently applies only to PPC Pegasos systems).

--loglevel=<0|1|2|3|4|5>

Controls the level of verbosity for information printed by genkernel. The variable LOGLEVEL is an integer between 0 and 5. The level '0' represents minimal output (=no output), while '5' provides as much information as possible about genkernel's activities during the kernel compilation and initramfs assemble process.

Note
Genkernel will always log complete output to /var/log/genkernel.log by default. --loglevel only controls output shown on screen.

--logfile=/path/to/output_file

Log file where genkernel outputs to by default. Defaults to /var/log/genkernel.log.

--[no-]color

Activates (or deactivates) colored output.

--[no-]cleanup

Activates (or deactivates) the full post-run cleanup for debug purposes.

Alapértelmezés szerint a kernel a /boot könyvtárba kerül, amely bizonyos beállításokban korábban az ESP volt, de most a gyökérpartíción található. Az okok, amelyek miatt érdemes a kernelt a /efi könyvtárba írni, a következők lehetnek:

• A Secure Boot egy előre megadott ESP kernel útvonalat vár el.
• A GRUB2 függetlenné tétele a gyökérpartíciótól a stabilitás vagy biztonság érdekében.
• A GRUB2 nem támogatja a gyökérfájlrendszert (bcachefs).
• A grub-mkconfig által nem generált grub.cfg használata.

• Secure Boot expecting a hard coded ESP kernel path
• Making GRUB2 independent of the root partition for stability or security
• GRUB2 not supporting the root file-system (bcachefs)
• Using a grub.cfg not generated by grub-mkconfig

A genkernel a /efi helyre való mutatásához adja hozzá a --bootdir=/efi opciót a genkernel parancshoz, vagy a BOOTDIR="/efi" beállítást a /etc/genkernel.conf fájlhoz.

# Állítsa be a boot könyvtárat. Alapértelmezett érték a /boot könyvtár.
BOOTDIR="/efi"

# Fut-e a 'make menuconfig', mielőtt lefordítja ezt a kernelt?"
MENUCONFIG="yes"

total 24
drwxr-xr-x 6 root root 4096 Dec 16 00:56 .
drwxr-xr-x 12 root root 4096 Dec 15 12:42 ..
-rw-r--r-- 1 root root 0 Mar 19 2015 .keep
lrwxrwxrwx 1 root root 22 Dec 16 00:56 linux -> linux-5.3.14-gentoo-r1
drwxr-xr-x 26 root root 4096 Nov 24 03:33 linux-4.19.85-gentoo
drwxr-xr-x 27 root root 4096 Dec 9 15:10 linux-4.19.88-gentoo
drwxr-xr-x 27 root root 4096 Dec 16 00:51 linux-4.19.89-gentoo
drwxr-xr-x 25 root root 4096 Dec 16 00:58 linux-5.3.14-gentoo-r1

# BOOTDIR automatikus felcsatolása, ha az még nincs felcsatolva.
MOUNTBOOT="yes"

# Mentse el az új konfigurációt az /etc/kernels könyvtárba
# a fordítás sikeres befejezése után.
SAVE_CONFIG="yes"

# Készítsen szimbolikus linkeket a BOOTDIR-ben automatikusan.
SYMLINK="yes"

# Új kernel hozzáadása a grub bootloaderhez:
# Lehetséges értékek: empty/"no", "grub", "grub2"
BOOTLOADER="grub2"

total 69388
lrwxrwxrwx 1 root root 44 Dec 16 00:58 System.map -> System.map-5.3.14-gentoo-r1-x86_64-wifitest2
-rw-r--r-- 1 root root 3465443 Dec 9 15:05 System.map-4.19.88-gentoo-x86_64
-rw-r--r-- 1 root root 3465554 Dec 16 00:45 System.map-4.19.89-gentoo-x86_64
-rw-r--r-- 1 root root 3645309 Dec 15 16:07 System.map-5.3.14-gentoo-r1-x86_64
-rw-r--r-- 1 root root 3645309 Dec 15 16:07 System.map-5.3.14-gentoo-r1-x86_64.old
-rw-r--r-- 1 root root 3645309 Dec 16 00:58 System.map-5.3.14-gentoo-r1-x86_64-wifitest2
drwxr-xr-x 2 root root 4096 Mar 21 2015 efi
drwxr-xr-x 6 root root 4096 Dec 16 01:02 grub
lrwxrwxrwx 1 root root 47 Dec 16 01:02 initramfs -> initramfs-5.3.14-gentoo-r1-x86_64-wifitest2.img
-rw-r--r-- 1 root root 3631084 Dec 9 15:34 initramfs-4.19.88-gentoo-x86_64.img
-rw-r--r-- 1 root root 3637148 Dec 16 00:54 initramfs-4.19.89-gentoo-x86_64.img
-rw-r--r-- 1 root root 3670176 Dec 15 17:41 initramfs-5.3.14-gentoo-r1-x86_64.img
-rw-r--r-- 1 root root 3669692 Dec 16 01:02 initramfs-5.3.14-gentoo-r1-x86_64-wifitest2.img
-rw-r--r-- 1 root root 168960 Nov 16 19:10 intel-uc.img
lrwxrwxrwx 1 root root 41 Dec 16 00:58 kernel -> vmlinuz-5.3.14-gentoo-r1-x86_64-wifitest2
-rw-r--r-- 1 root root 7509552 Dec 9 15:05 vmlinuz-4.19.88-gentoo-x86_64
-rw-r--r-- 1 root root 7509552 Dec 16 00:45 vmlinuz-4.19.89-gentoo-x86_64
-rw-r--r-- 1 root root 7784496 Dec 15 16:07 vmlinuz-5.3.14-gentoo-r1-x86_64
-rw-r--r-- 1 root root 7784496 Dec 15 16:07 vmlinuz-5.3.14-gentoo-r1-x86_64.old
-rw-r--r-- 1 root root 7784496 Dec 16 00:58 vmlinuz-5.3.14-gentoo-r1-x86_64-wifitest2

# This is a sample grub.conf for use with Genkernel, per the Gentoo handbook 
# http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=10#doc_chap2
# When not using Genkernel, see the handbook.
# Alternatively, see grub.conf.sample in the GRUB documentation.

default0
timeout5
splashimage=(hd1,0)/boot/grub/splash.xpm.gz

titleGentooLinux
root(hd0,6)
kernel/boot/kernelinitrd=/dev/ram0root=/dev/sda7rootfstype=ext4
initrd/boot/initramfs

titleGentooLinuxoldkernel
root(hd0,6)
kernel/boot/kernel.oldinitrd=/dev/ram0root=/dev/sda7rootfstype=ext4
initrd/boot/initramfs.old

# Futtassa a 'make menuconfig' parancsot a kernel kódfordítása előtt.
MENUCONFIG="yes"

-rwxr-xr-x 1 root root 2813384 Dec 16 01:49 sbin/cryptsetup

# Add firmware(s) to initramfs
FIRMWARE="yes"

# Adja meg a könyvtárat, ahonnan a fájlokat be kell tölteni
FIRMWARE_DIR="/lib/firmware"

# Specify a comma-separated list of firmware files or directories to include,
# relative to FIRMWARE_DIR. If empty or unset, the full contents of 
# FIRMWARE_DIR will be included (if FIRMWARE option above is set to YES).
FIRMWARE_FILES="<comma-separated list of firmware files here>"

Abban az esetben, ha a sys-kernel/gentoo-sources szoftvercsomag telepítve van USE="experimental" beállítással, és a kernel be van állítva a CONFIG_GENTOO_PRINT_FIRMWARE_INFO=y opcióval, akkor a következő parancs segítségével egy vesszővel elválasztott lista generálható az összes jelenleg betöltött firmware fájlról. Ez a lista felhasználható a /etc/genkernel.conf fájl FIRMWARE_FILES változójában, ahogyan azt korábban bemutattuk. (A kimenet csak példa.) :

amdgpu/green_sardine_sdma.bin,amdgpu/green_sardine_asd.bin,amdgpu/green_sardine_ta.bin,amdgpu/green_sardine_pfp.bin,amdgpu/green_sardine_me.bin,amdgpu/green_sardine_ce.bin,amdgpu/green_sardine_rlc.bin,amdgpu/green_sardine_mec.bin,amdgpu/green_sardine_dmcub.bin,amdgpu/green_sardine_vcn.bin,regulatory.db,regulatory.db.p7s,rtw89/rtw8852a_fw.bin,rtl_bt/rtl8852au_fw.bin,rtl_bt/rtl8852au_config.bin,rtl_nic/rtl8168h-2.fw

• initramfs: >> Initializing ...
• >> Appending devices cpio data ...
• >> Appending base_layout cpio data ...
• >> Appending auxilary cpio data ...
• >> Appending blkid cpio data ...
• >> Appending busybox cpio data ...
• >> Appending dropbear cpio data ...

=====================================================

This initramfs' sshd will use the following host key(s): 256 MD5:a5:13:09:90:5b:f6:a1:95:49:9f:87:d9:fa:e5:d8:02 (ECDSA) 256 SHA256:5dxNGEOwH9hvX4+sV4WtzRV/9m8/hrhgnNtTplZf5x8 (ECDSA) 2048 MD5:1d:e6:cc:ce:c8:96:a0:73:3e:4c:2a:56:ce:b9:10:26 (RSA) 2048 SHA256:V4WrMKhfVSxSeW3XIbW8dSaAmXiwN6jiMA/geNKLcqA (RSA)

=====================================================

• >> Appending modprobed cpio data ...
• >> Appending modules cpio data ...
• >> Appending linker cpio data ...
• >> Deduping cpio ...
• >> Pre-generating initramfs' /etc/ld.so.cache ...
• >> Compressing cpio data (.xz) ...
• You will find the initramfs in '/boot/initramfs-5.3.14-gentoo-r1-x86_64.img'.

>> Welcome to Genkernel 4.0.1 (2019年12月16日 22:34:14 UTC) remote rescue shell!
>> ...running Linux kernel 5.3.14-gentoo-r1-x86_64
</div>
{{Note|Ebben a példában a rendszer csak a <code>crypt_root{{=}}</code> beállítással indult a kernel parancssorában. Ha a rendszer a <code>crypt_swap{{=}}</code> beállítással indult, akkor egy további felszólítást fog kapni a swap feloldásának módjáról. A ZFS-felhasználók a <code>unlock-zfs</code> parancs használatára kapnak felszólítást.}}
===== Automatikus feloldás =====
Ez alapvetően ugyanaz, mint a manuális feloldás, csak nincs szükség a {{c|resume-boot}} kézi futtatására. Abban az esetben, ha a felhasználónak mindkettője van, titkosított root és swap kötet, akkor először a swap kötetet kell feloldania:
{{Cmd
|cat /path/to/secret.key/on/local/disk {{!}} ssh root@remote-system-running-genkernel-initramfs-with-dosshd post root
|collapse-output=true
|output=<pre>
>> Detected real_root as a md device. Setting up the device node ...
>> LUKS device /dev/md126 opened
>> Resuming boot process ...

Bootolás hálózatról

Telepítő CD lemezről

A genkernel segédprogram képes olyan bináris kernel képfájlokat és bináris initrd képfájlokat létrehozni, amelyek támogatják a hálózatról történő bootolást, vagy netbootot. Optimális esetben a felhasználók bármelyik újabb számítógépet hálózaton keresztül képesek bootolni a Gentoo telepítő CD által biztosított környezetbe.

A varázslat a genkernel linuxrc szkriptjében rejlik: Megpróbálja hálózaton keresztül felcsatolni a telepítő CD lemezt az NFS fájlrendszer használatával. Innen a telepítő CD init szkriptjei veszik át az irányítást, mintha a CD helyben lenne jelen.

Kernel és initramfs bináris képfájlok létrehozása netboot támogatással

A hálózati indítás (netbooting) támogatásának engedélyezéséhez a kernel beállításakor az alábbi opciókat kell beállítani:

Először is, a bináris kernelképfájlnak tartalmaznia kell a rendszer Hálózati Interfész Kártyáinak (NIC) az illesztőprogramjait. Általában az ilyen hálózati eszközökhöz tartozó illesztőprogramok kernelmodulokként kerülnek lefordításra. Azonban a hálózati indítás (netboot) érdekében alapvető fontosságú, hogy ezek az illesztőprogramok közvetlenül a bináris kernelképfájlba legyenek beágyazva, és ne külső modulokként legyenek létrehozva.

Device Drivers --->
 Networking Support --->
 Ethernet (10 or 100Mbit) --->
 [*] Ethernet (10 or 100Mbit)
 <*> The driver(s) for each network card

Másodszor, ajánlott engedélyezni az IP: kernel szintű automatikus konfiguráció és az IP: DHCP támogatási opciók funkciókat. Ez elkerüli az indokolatlan komplexitást, mivel az IP-cím és a telepítő CD lemezhez tartozó NFS-útvonal beállítható egy DHCP-szerveren. Természetesen ez azt is jelenti, hogy a kernel parancssora minden számítógépnél állandó marad, ami különösen fontos az etherboot szempontjából.

Device Drivers --->
 Networking Support --->
 Networking options
 [*] TCP/IP networking--->
 [*] IP: kernel level autoconfiguration
 [*] IP: DHCP support

Utasítja a kernelt, hogy indításkor DHCP-kérelmet küldjön.

Továbbá engedélyezze a SquashFS támogatását, mivel a legtöbb modern Gentoo telepítő CD megköveteli ezt. A SquashFS támogatás nem része az alapértelmezett kernelforráskód fájának. A SquashFS engedélyezéséhez alkalmazza a szükséges javításokat az általános kernel forráskód fájára, vagy telepítse a gentoo-sources szoftvercsomagot.

File systems--->
 Miscellaneous filesystems --->
 [*] SquashFS 2.X - Squashed file system support

Miután a forráskód fordítási folyamata befejeződött, hozzon létre egy tömörített tarball (tar.gz) fájlt, amely a kernel moduljait tartalmazza. Erre a lépésre csak akkor van szükség, ha a kernel verziója nem egyezik meg a telepítő CD lemezen található kernelképfájl verziójával.

Ahhoz, hogy létrehozzon egy tömörített fájlt, amely az összes modult tartalmazza, kövesse az alábbi lépéseket:

A hálózati indítási mechanizmustól függően az alábbi lépések egyikét kell követni:

Egy etherboot bináris képfájl létrehozásához kövesse az alábbi lépéseket:

Egy OpenBoot/SPARC64 TFTP bináris képfájl létrehozásához:

A openboot.img fájl maga a boot bináris képfájl.

Végül másolja át ezt a kernelt a TFTP szerverre. A részletek architektúrafüggőek, és túlmutatnak ezen útmutató keretein. Kérjük, hogy tekintse meg az adott platformhoz kapcsolódó dokumentációt.

NFS beállítása

Az NFS megosztás beállításához, amely tartalmazza a telepítő CD lemezképfájlt, használja a loop eszközt az ISO-képfájl felcsatolásához, majd másolja át a CD tartalmát az NFS megosztásba. Egy kellemes extra funkcióként a genkernel initrd szkriptjei automatikusan kicsomagolják az összes tar.gz tömörített fájlt, amelyek a /nfs/livecd/add/ könyvtárban találhatók. Az egyetlen teendő itt az, hogy a modules-X.Y.Z.tar.gz tömörített fájlt bemásolja a /nfs/livecd/add/ könyvtárba.

A következő lépések feltételezik, hogy a /nfs/livecd egy exportált NFS-megosztás:

Most másolja be a modules.tar.gz fájlt a /add könyvtárba:

DHCP beállítása

A netboot képfájlok kérni fognak a hálózaton lévő DHCP szervertől egy IP-címet, valamint egy root-path opciót. Mindkettőt meg lehet adni egyes host számítógépek esetében a számítógépek azonosítására használt MAC-cím alapján:

# Here, 192.168.1.2 is the NFS server while 192.168.1.10 will be the IP address of the netbooted machine
host netbootableMachine {
 hardware ethernet 11:22:33:44:55:66;
 fixed-address 192.168.1.10;
 option root-path "192.168.1.2:/nfs/livecd";
}

Netbooting utasítások

A hálózati indítás (netbooting) szintén nagyon platformspecifikus. A lényeg az, hogy a kernel parancssorában meg kell adni az ip=dhcp és init=/linuxrc paramétereket, mivel ezek indítják el a hálózati interfészt, és arra utasítják az initrd szkripteket, hogy az NFS-en keresztül csatolják a telepítő CD lemezt. Íme néhány platformspecifikus tipp.

Etherboot esetében helyezze be az etherboot lemezt a meghajtóba, majd indítsa újra a rendszert. A kernel parancssora a képfájl létrehozásakor lett meghatározva.

Sparc64 esetén nyomja meg a Stop+A billentyűgombokat a boot promptnál, majd írja be a következőt:

PXE esetében állítsa be a pxelinux-ot (a syslinux része), majd hozzon létre egy pxelinux.cfg/default fájlt, valami ilyesmi tartalommal:

DEFAULT gentoo
TIMEOUT 40
PROMPT 1
 
LABEL gentoo
 KERNEL kernel-X.Y.Z
 APPEND initrd=initrd-X.Y.Z root=/dev/ram0 init=/linuxrc ip=dhcp

Genkernel initramfs indítása

Bevezetés

Ha egy initramfs telepítve van a genkernel segítségével, akkor nézze meg a különböző boot opciókat, amelyeket meg kell (vagy ajánlott) határozni az bootloader beállításában. Az ebben az útmutatóban felsoroltak a leggyakoribbak közé tartoznak.

LVM vagy szoftver-RAID betöltése

Ha a rendszer LVM-et vagy szoftver-RAID-et használ, akkor az bináris initramfs képfájlt a --lvm és --mdadm opciók használatával kell létrehozni. Ne felejtse el az indítás során is engedélyezni a támogatást! Ezt a dolvm és domdadm opciókkal lehet megtenni.

# Example for GRUB 1.x
title Gentoo Linux
root (hd0,0)
kernel /vmlinuz root=/dev/md3 dolvm domdadm
initrd /initramfs-genkernel-x86_64-3.4.3

Egyszerfelhasználós módú bootolás

Ha valamilyen okból az indítás sikertelen, akkor a rendszer mentése még lehetséges az egyszerfelhasználós módú indítással. Ez csak a legszükségesebb szolgáltatásokat tölti be, majd a felhasználót egy mentő (root) shellbe helyezi.

# Example for GRUB 1.x
title Gentoo Linux
root (hd0,0)
kernel /vmlinuz root=/dev/md3 init_opts=S
initrd /initramfs-genkernel-x86_64-3.4.3

Keresztfordítás támogatása

A bináris kernelképfájl és/vagy bináris initramfs képfájl különböző platform számára történő létrehozásához, miközben a genkernel futtatása folyamatban van, a kernel/initramfs-t keresztfordítással kell elkészíteni.

A fentebb említett parancs arra készteti a genkernel szoftvert, hogy olyan bináris kernelképfájlt hozzon létre, amely támogatja az MD raidet, és beágyazza az mdadm-ot a bináris initramfs képfájlba (--mdadm). Mind az elkészült bináris kernelképfájl, mind az elkészült bináris initramfs képfájl kézi telepítést igényel majd (--no-install). A kernelképfájlba és az initramfs képfájlba ágyazott programok arm64 platformon futnak majd (--cross-compile=aarch64-linux-gnu).

--cross-compile=<target triplet>

A target triple-nek (pl. aarch64-linux-gnu) az a célja, hogy egy olyan architektúrára építsen, amely különbözik attól a rendszertől, amelyen a genkernel fut. Ez csak akkor szükséges, ha a létrehozott kernel/initramfs-t indító rendszer architektúrája eltér a jelenlegi rendszertől.

Az initramfs kernel parancssori paraméterei

Gyakran ismételt kérdések

Használható-e a genkernel systemd-alapú rendszerekhez?

Igen.

A sys-kernel/dracut egy általános szoftver az initramfs létrehozásához a sys-kernel/genkernel szoftverhez képest. Nem hoz létre kernelt, mint ahogy azt a genkernel teszi. Például, bár mind a genkernel, mind a dracut támogatja a LUKS-titkosított root kötetből történő indítást, csak a genkernel biztosítja, hogy a kernelhez minden szükséges opció be legyen állítva. Érdemes megemlíteni, hogy a genkernel saját maga fordítja le az initramfs fájlban használt legtöbb szoftvercsomagot (LVM, cryptsetup, mdadm, sshd...), míg a dracut a host számítógépes rendszerből másolja a bináris fájlokat, ami problémát okozhat bizonyos beállításoknál. Így a genkernel támogatja a kernel/initramfs létrehozását más rendszerhez (keresztfordítás), ellentétben a dracut szoftverrel vagy a genkernel-next szoftverrel.

Létrehozható külön kernel/initramfs tesztelési célokra?

A fenti parancs arra készteti a genkernel szoftvert, hogy új bináris kernelképfájlt és új bináris initramfs képfájlt készítsen (all), az aktuálisan futó kernelbeállítás alapján (--kernel-config=/proc/config.gz). Ezenkívül elindítja a menuconfig szoftvert (--menuconfig), amely lehetővé teszi a felhasználónak, hogy módosítsa a beállítást. A kernel LOCALVERSION változójához pedig hozzáfűzi a -test42 értéket (--kernel-append-localversion=-test42), amely alapértelmezés szerint hatással lesz a kernelképfájl, a kernelmodulok könyvtárának és az initramfs képfájl elnevezésére.

Hogyan lehet a külső kernelmodulokat (például xtables-addons, nvidia-drivers...) az új kernelhez újból létrehozni?

Alapértelmezés szerint a genkernel a emerge @module-rebuild parancsot hívja meg a kernel létrehozása során, hogy biztosítsa, hogy a szoftvercsomag-kezelőn keresztül telepített külső kernelmodulok továbbra is elérhetők legyenek az újra létrehozott kernelben. Ez a funkció a --[no-]module-rebuild parancssori argumentummal vagy a /etc/genkernel.conf fájlban található MODULEREBUILD beállítással kapcsolható ki és be.

Hogyan lehet további parancsokat futtatni a kernel fordítása után?

A Genkernel lehetőséget biztosít erre egy callback segítségével (a 4-es verzió előtt a callback-et külső kernelmodulok újbóli létrehozására használták). További részletekért tekintse meg a /etc/genkernel.conf fájlban található CMD_CALLBACK részt.

Hogyan használható a ccache vagy a distcc a genkernel szoftverrel?

ERROR: compile_kernel(): compile_generic() failed to compile the "bzImage" target!

Ellenőrizze először a /var/log/genkernel.log fájlt. A legtöbb esetben az alapvető probléma valami ilyesmi formájában fog megjelenni:

[...]
 AR drivers/usb/built-in.a
 AR drivers/built-in.a
 GEN .version
 CHK include/generated/compile.h
 AR built-in.a
 LD vmlinux.o
 MODPOST vmlinux.o
ld: .tmp_vmlinux1: final close failed: No space left on device
make: *** [Makefile:1032: vmlinux] Error 1
 
* ERROR: compile_kernel(): compile_generic() failed to compile the "bzImage" target!
* Please consult '/var/log/genkernel.log' for more information and any
* errors that were reported above.
*
* Report any genkernel bugs to bugs.gentoo.org and
* assign your bug to genkernel@gentoo.org. Please include
* as much information as you can in your bug report; attaching
* '/var/log/genkernel.log' so that your issue can be dealt with effectively.
*
* Please do *not* report kernel compilation failures as genkernel bugs!
*
 
* mount: >> Boot partition state on '/boot' was not changed; Skipping restore boot partition state ...
>>> Ended on: 2019年12月16日 02:30:19 (after 0 days 0 hours 07 minutes 49 seconds)
</pre>

Más szavakkal: A rendszer kifogyott a lemezterületből (No space left on device) a fordítás során.

Az ilyen problémák elkerülése érdekében állítsa be a CHECK_FREE_DISK_SPACE_BOOTDIR=50 és CHECK_FREE_DISK_SPACE_KERNELOUTPUTDIR=4000 értékeket a /etc/genkernel.conf fájlban, így a genkernel már korán hibát jelezne egy olyan üzenettel, mint például:

* Gentoo Linux Genkernel; Version 4.0.1
* Using genkernel configuration from '/etc/genkernel.conf' ...
* Running with options: --kernel-config=/proc/config.gz all
 
* Working with Linux kernel 4.19.89-gentoo-x86_64 for x86_64
* Using kernel config file '/proc/config.gz' ...
*
* Note: The version above is subject to change (depends on config and status of kernel sources).
* ERROR: 4000 MB free disk space is required in '/usr/src/linux' but only 1026 MB is available!
[...]

Fontos a kernel parancssori argumentumainak sorrendje?

Nem.

Hiányzó szükséges kernel opció: 'CONFIG_MICROCODE_INTEL' vagy 'CONFIG_MICROCODE_AMD', amelyet a genkernel megpróbált beállítani!

A kernel v6.6 véglegesen alkalmazta a kernel beállítási paramétereket (részletek: ezt a commitot). Ez a [https://packages.gentoo.org/packages/sys-kernel/genkernel sys-kernel/genkernel 4.3.10-es verziójában] került javításra.

Segítség! Valami nem működik!

A probléma bejelentéséhez mindig biztosítsa a /var/log/genkernel.log fájlt (előfordulhat, hogy a fájlt tömöríteni kell, mielőtt megosztaná vagy csatolná a hibajelentéshez), mivel ez nagymértékben segítheti a fejlesztőket. Még akkor is, ha a parancsot --loglevel=1 (alapértelmezett) opcióval futtatja, a naplófájl mindig tartalmazni fogja a teljes kimenetet (nincs szükség újrafuttatásra bekapcsolt naplózással). Ez segíti a fejlesztőket a probléma megértésében, reprodukálásában és esetlegesen a javításában is.

További olvasnivaló a témában

• Dracut — an initramfs infrastructure and aims to have as little as possible hard-coded into the initramfs.
• Kernel — a Gentoo operációs rendszer (OS) alapvető része
• Kernel/Configuration — leírja a Linux kernel kézi úton történő beállítását.
• Project:Distribution Kernel — maintains sys-kernel/*-kernel packages.