dracut.conf.5.asc

   1 DRACUT.CONF(5)
   2 ==============
   3 :doctype: manpage
   4 :man source:   dracut
   5 :man manual:   dracut
   6 :man version:  {version}
   7
   8 NAME
   9 ----
  10 dracut.conf - configuration file(s) for dracut
  11
  12 SYNOPSIS
  13 --------
  14 _/etc/dracut.conf_
  15 _/etc/dracut.conf.d/\*.conf_
  16 _/usr/lib/dracut/dracut.conf.d/*.conf_
  17
  18 Description
  19 -----------
  20 _dracut.conf_ is loaded during the initialisation phase of dracut. Command line
  21 parameter will override any values set here.
  22
  23 _*.conf_ files are read from /usr/lib/dracut/dracut.conf.d and
  24 /etc/dracut.conf.d. Files with the same name in /etc/dracut.conf.d will replace
  25 files in /usr/lib/dracut/dracut.conf.d.
  26 The files are then read in alphanumerical order and will override parameters
  27 set in _/etc/dracut.conf_. Each line specifies an attribute and a value. A '#'
  28 indicates the beginning of a comment; following characters, up to the end of the
  29 line are not interpreted.
  30
  31 dracut command line options will override any values set here.
  32
  33 Configuration files must have the extension .conf; other extensions are ignored.
  34
  35 *add_dracutmodules+=*" __<dracut modules>__ "::
  36     Add a space-separated list of dracut modules to call when building the
  37     initramfs. Modules are located in _/usr/lib/dracut/modules.d_.
  38
  39 *dracutmodules+=*" __<dracut modules>__ "::
  40     Specify a space-separated list of dracut modules to call when building the
  41     initramfs. Modules are located in _/usr/lib/dracut/modules.d_.
  42     This option forces dracut to only include the specified dracut modules.
  43     In most cases the "add_dracutmodules" option is what you want to use.
  44
  45 *omit_dracutmodules+=*" __<dracut modules>__ "::
  46     Omit a space-separated list of dracut modules to call when building the
  47     initramfs. Modules are located in _/usr/lib/dracut/modules.d_.
  48
  49 *drivers+=*" __<kernel modules>__ "::
  50     Specify a space-separated list of kernel modules to exclusively include in
  51     the initramfs. The kernel modules have to be specified without the ".ko"
  52     suffix.
  53
  54 *add_drivers+=*" __<kernel modules>__ "::
  55     Specify a space-separated list of kernel modules to add to the initramfs.
  56     The kernel modules have to be specified without the ".ko" suffix.
  57
  58 *force_drivers+=*" __<list of kernel modules>__ "::
  59     See add_drivers above. But in this case it is ensured that the drivers
  60     are tried to be loaded early via modprobe.
  61
  62 *omit_drivers+=*" __<kernel modules>__ "::
  63     Specify a space-separated list of kernel modules not to add to the
  64     initramfs. The kernel modules have to be specified without the ".ko" suffix.
  65
  66 *filesystems+=*" __<filesystem names>__ "::
  67     Specify a space-separated list of kernel filesystem modules to exclusively
  68     include in the generic initramfs.
  69
  70 *drivers_dir=*"__<kernel modules directory>__"::
  71     Specify the directory, where to look for kernel modules
  72
  73 *fw_dir+=*" :__<dir>__[:__<dir>__ ...] "::
  74     Specify additional directories, where to look for firmwares, separated by :
  75
  76 *install_items+=*" __<file>__[ __<file>__ ...] "::
  77     Specify additional files to include in the initramfs, separated by spaces.
  78
  79 *install_optional_items+=*" __<file>__[ __<file>__ ...] "::
  80     Specify additional files to include in the initramfs, separated by spaces,
  81     if they exist.
  82
  83 *compress=*"__{bzip2|lzma|xz|gzip|lzo|lz4|zstd|<compressor [args ...]>}__"::
  84     Compress the generated initramfs using the passed compression program. If
  85     you pass it just the name of a compression program, it will call that
  86     program with known-working arguments. If you pass arguments, it will be called
  87     with exactly those arguments. Depending on what you pass, this may result in
  88     an initramfs that the kernel cannot decompress.
  89
  90 *do_strip=*"__{yes|no}__"::
  91     Strip binaries in the initramfs (default=yes)
  92
  93 *hostonly=*"__{yes|no}__"::
  94     Host-Only mode: Install only what is needed for booting the local host
  95     instead of a generic host and generate host-specific configuration.
  96
  97 *hostonly_cmdline=*"__{yes|no}__"::
  98     If set to "yes", store the kernel command line arguments needed in the initramfs
  99
 100 *persistent_policy=*"__<policy>__"::
 101     Use _<policy>_ to address disks and partitions.
 102     _<policy>_ can be any directory name found in /dev/disk.
 103     E.g. "by-uuid", "by-label"
 104
 105 *tmpdir=*"__<temporary directory>__"::
 106     Specify temporary directory to use.
 107
 108 [WARNING]
 109 ====
 110 If chrooted to another root other than the real root device, use --fstab and
 111 provide a valid _/etc/fstab_.
 112 ====
 113
 114 *use_fstab=*"__{yes|no}__"::
 115     Use _/etc/fstab_ instead of _/proc/self/mountinfo_.
 116
 117 *add_fstab+=*" __<filename>__ "::
 118     Add entries of __<filename>__ to the initramfs /etc/fstab.
 119
 120 *add_device+=*" __<device>__ "::
 121     Bring up _<device>_ in initramfs, _<device>_ should be the device name.
 122     This can be useful in hostonly mode for resume support when your swap is on
 123     LVM an encrypted partition.
 124
 125 *mdadmconf=*"__{yes|no}__"::
 126     Include local _/etc/mdadm.conf_ (default=yes)
 127
 128 *lvmconf=*"__{yes|no}__"::
 129     Include local _/etc/lvm/lvm.conf_ (default=yes)
 130
 131 *fscks=*" __<fsck tools>__ "::
 132     Add a space-separated list of fsck tools. If nothing is specified, the
 133     default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck
 134     jfs_fsck reiserfsck btrfsck". The installation is opportunistic
 135     (non-existing tools are ignored).
 136
 137 *nofscks=*"__{yes|no}__"::
 138     If specified, inhibit installation of any fsck tools.
 139
 140 *ro_mnt=*"__{yes|no}__"::
 141     Mount _/_ and _/usr_ read-only by default.
 142
 143 *kernel_cmdline=*"__parameters__"::
 144     Specify default kernel command line parameters
 145
 146 *kernel_only=*"__{yes|no}__"::
 147     Only install kernel drivers and firmware files. (default=no)
 148
 149 *no_kernel=*"__{yes|no}__"::
 150     Do not install kernel drivers and firmware files (default=no)
 151
 152 *acpi_override=*"__{yes|no}__"::
 153     [WARNING] ONLY USE THIS IF YOU KNOW WHAT YOU ARE DOING! +
 154     Override BIOS provided ACPI tables. For further documentation read
 155     Documentation/acpi/initrd_table_override.txt in the kernel sources.
 156     Search for ACPI table files (must have .aml suffix) in acpi_table_dir=
 157     directory (see below) and add them to a separate uncompressed cpio
 158     archive. This cpio archive gets glued (concatenated, uncompressed one
 159     must be the first one) to the compressed cpio archive. The first,
 160     uncompressed cpio archive is for data which the kernel must be able
 161     to access very early (and cannot make use of uncompress algorithms yet)
 162     like microcode or ACPI tables (default=no).
 163
 164 *acpi_table_dir=*"__<dir>__"::
 165     Directory to search for ACPI tables if acpi_override= is set to yes.
 166
 167 *early_microcode=*"{yes|no}"::
 168     Combine early microcode with ramdisk (default=yes)
 169
 170 *stdloglvl*="__\{0-6\}__"::
 171     Set logging to standard error level.
 172
 173 *sysloglvl*="__\{0-6\}__"::
 174     Set logging to syslog level.
 175
 176 *fileloglvl=*"__\{0-6\}__"::
 177     Set logging to file level.
 178
 179 *logfile=*"__<file>__"::
 180     Path to log file.
 181
 182 *show_modules=*"__{yes|no}__"::
 183     Print the name of the included modules to standard output during build.
 184
 185 *i18n_vars=*"__<variable mapping>__"::
 186     Distribution specific variable mapping.
 187     See dracut/modules.d/10i18n/README for a detailed description.
 188
 189 *i18n_default_font=*"__<fontname>__"::
 190     The font <fontname> to install, if not specified otherwise.
 191     Default is "eurlatgr".
 192
 193 *i18n_install_all=*"__{yes|no}__"::
 194     Install everything regardless of generic or hostonly mode.
 195
 196 *reproducible=*"__{yes|no}__"::
 197     Create reproducible images.
 198
 199 *loginstall=*"__<DIR>__"::
 200     Log all files installed from the host to _<DIR>_.
 201
 202 *uefi_stub=*"_<FILE>_"::
 203     Specifies the UEFI stub loader, which will load the attached kernel, initramfs and
 204     kernel command line and boots the kernel. The default is
 205     _/lib/systemd/boot/efi/linux<EFI-MACHINE-TYPE-NAME>.efi.stub_
 206     or _/usr/lib/gummiboot/linux<EFI-MACHINE-TYPE-NAME>.efi.stub_
 207
 208 *uefi_splash_image=*"_<FILE>_"::
 209     Specifies the UEFI stub loader's splash image. Requires bitmap (**.bmp**) image format.
 210
 211 *uefi_secureboot_cert=*"_<FILE>_", *uefi_secureboot_key=*"_<FILE>_"::
 212     Specifies a certificate and corresponding key, which are used to sign the created UEFI executable.
 213     Requires both certificate and key need to be specified and _sbsign_ to be installed.
 214
 215 *kernel_image=*"_<FILE>_"::
 216     Specifies the kernel image, which to include in the UEFI executable. The default is
 217     _/lib/modules/<KERNEL-VERSION>/vmlinuz_ or _/boot/vmlinuz-<KERNEL-VERSION>_
 218
 219 Files
 220 -----
 221 _/etc/dracut.conf_::
 222     Old configuration file. You better use your own file in
 223     _/etc/dracut.conf.d/_.
 224
 225 _/etc/dracut.conf.d/_::
 226     Any _/etc/dracut.conf.d/*.conf_ file can override the values in
 227     _/etc/dracut.conf_. The configuration files are read in alphanumerical
 228     order.
 229
 230 AUTHOR
 231 ------
 232 Harald Hoyer
 233
 234 See Also
 235 --------
 236 *dracut*(8) *dracut.cmdline*(7)
 237