dracut.conf.5.asc

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