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