X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=dracut.8.asc;h=2e974fb0b632680494146d56f962def6515a9745;hb=5e0f8c8a4ced36268d0077acafa1db2402776fa6;hp=d22c1cb76ac9d82e6eac60f07227c406669a89fa;hpb=e330912be5e063e115ae5513b53e2165245bc344;p=thirdparty%2Fdracut.git diff --git a/dracut.8.asc b/dracut.8.asc index d22c1cb76..2e974fb0b 100644 --- a/dracut.8.asc +++ b/dracut.8.asc @@ -6,7 +6,7 @@ DRACUT(8) NAME ---- -dracut - low-level tool for generating an initramfs image +dracut - low-level tool for generating an initramfs/initrd image SYNOPSIS -------- @@ -28,6 +28,8 @@ At boot time, the kernel unpacks that archive into RAM disk, mounts and uses it as initial root file system. All finding of the root device happens in this early userspace. +Initramfs images are also called "initrd". + For a complete list of kernel command line options see *dracut.cmdline*(7). If you are dropped to an emergency shell, while booting your initramfs, @@ -54,57 +56,59 @@ OPTIONS **-f, --force**:: overwrite existing initramfs file. -**-m, --modules** __:: - specify a space-separated list of dracut modules to call when building the - initramfs. Modules are located in _/usr/lib/dracut/modules.d_. This - parameter can be specified multiple times. +**-a, --add** __:: + add a space-separated list of dracut modules to the default set of modules. + This parameter can be specified multiple times. + [NOTE] =============================== If [LIST] has multiple arguments, then you have to put these in quotes. For example: ---- -# dracut --modules "module1 module2" ... +# dracut --add "module1 module2" ... ---- =============================== -**-o, --omit** __:: - omit a space-separated list of dracut modules. This parameter can be - specified multiple times. +**--force-add** __:: + force to add a space-separated list of dracut modules to the default set of + modules, when -H is specified. This parameter can be specified multiple + times. + [NOTE] =============================== If [LIST] has multiple arguments, then you have to put these in quotes. For example: ---- -# dracut --omit "module1 module2" ... +# dracut --force-add "module1 module2" ... ---- =============================== -**-a, --add** __:: - add a space-separated list of dracut modules to the default set of modules. - This parameter can be specified multiple times. +**-o, --omit** __:: + omit a space-separated list of dracut modules. This parameter can be + specified multiple times. + [NOTE] =============================== If [LIST] has multiple arguments, then you have to put these in quotes. For example: ---- -# dracut --add "module1 module2" ... +# dracut --omit "module1 module2" ... ---- =============================== -**--force-add** __:: - force to add a space-separated list of dracut modules to the default set of - modules, when -H is specified. This parameter can be specified multiple - times. +**-m, --modules** __:: + specify a space-separated list of dracut modules to call when building the + initramfs. Modules are located in _/usr/lib/dracut/modules.d_. This + parameter can be specified multiple times. + This option forces dracut to only include the specified dracut modules. + In most cases the "--add" option is what you want to use. + [NOTE] =============================== If [LIST] has multiple arguments, then you have to put these in quotes. For example: ---- -# dracut --force-add "module1 module2" ... +# dracut --modules "module1 module2" ... ---- =============================== @@ -239,12 +243,6 @@ example: **--nostrip**:: do not strip binaries in the initramfs -**--prelink**:: - prelink binaries in the initramfs (default) - -**--noprelink**:: - do not prelink binaries in the initramfs - **--hardlink**:: hardlink files in the initramfs (default) @@ -319,6 +317,16 @@ provide a valid _/etc/fstab_. **--no-hostonly-cmdline**: Do not store kernel command line arguments needed in the initramfs +**--no-hostonly-default-device**: + Do not generate implicit host devices like root, swap, fstab, etc. + Use "--mount" or "--add-device" to explicitly add devices as needed. + +**--hostonly-i18n**: + Install only needed keyboard and font files according to the host configuration (default). + +**--no-hostonly-i18n**: + Install all keyboard and font files available. + **--persistent-policy** __:: Use __ to address disks and partitions. __ can be any directory name found in /dev/disk. @@ -418,12 +426,21 @@ Make sure your kernel has lz4 decompression support compiled in, otherwise you will not be able to boot. ==== +**--zstd**:: + Compress the generated initramfs using Zstandard. +[WARNING] +==== +Make sure your kernel has zstd decompression support compiled in, otherwise you +will not be able to boot. +==== + **--compress** __:: Compress the generated initramfs using the passed compression program. If you pass it just the name of a compression program, it will call that program with known-working arguments. If you pass a quoted string with arguments, it will be called with exactly those arguments. Depending on what you pass, this may result in an initramfs that the kernel cannot decompress. + The default value can also be set via the _INITRD_COMPRESS_ environment variable. **--no-compress**:: Do not compress the generated initramfs. This will override any other @@ -474,18 +491,32 @@ will not be able to boot. **--uefi**:: Instead of creating an initramfs image, dracut will create an UEFI executable, - which can be executed by an UEFI BIOS. + which can be executed by an UEFI BIOS. The default output filename is + _/EFI/Linux/linux-$kernel$--.efi_. might be + _/efi_, _/boot_ or _/boot/efi_ depending on where the ESP partition is mounted. + The is taken from BUILD_ID in _/usr/lib/os-release_ or if it exists + _/etc/os-release_ and is left out, if BUILD_ID is non-existant or empty. + +**--no-machineid**:: + affects the default output filename of **--uefi** and will discard the + part. **--uefi-stub __**:: Specifies the UEFI stub loader, which will load the attached kernel, initramfs and kernel command line and boots the kernel. The default is - _/lib/systemd/boot/efi/linux.efi.stub_ - or _/usr/lib/gummiboot/linux.efi.stub_ + _$prefix/lib/systemd/boot/efi/linux.efi.stub_ + or _$prefix/lib/gummiboot/linux.efi.stub_ **--kernel-image __**:: Specifies the kernel image, which to include in the UEFI executable. The default is _/lib/modules//vmlinuz_ or _/boot/vmlinuz-_ +ENVIRONMENT +----------- + +_INITRD_COMPRESS_:: + sets the default compression program. See **--compress**. + FILES ----- _/var/log/dracut.log_::