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 *omit_drivers+=*" __<kernel modules>__ "::
  53     Specify a space-separated list of kernel modules not to add to the
  54     initramfs. The kernel modules have to be specified without the ".ko" suffix.
  55
  56 *filesystems+=*" __<filesystem names>__ "::
  57     Specify a space-separated list of kernel filesystem modules to exclusively
  58     include in the generic initramfs.
  59
  60 *drivers_dir=*"__<kernel modules directory>__"::
  61     Specify the directory, where to look for kernel modules
  62
  63 *fw_dir+=*" :__<dir>__[:__<dir>__ ...] "::
  64     Specify additional directories, where to look for firmwares, separated by :
  65
  66 *install_items+=*" __<file>__[ __<file>__ ...] "::
  67     Specify additional files to include in the initramfs, separated by spaces.
  68
  69 *install_optional_items+=*" __<file>__[ __<file>__ ...] "::
  70     Specify additional files to include in the initramfs, separated by spaces,
  71     if they exist.
  72
  73 *do_strip=*"__{yes|no}__"::
  74     Strip binaries in the initramfs (default=yes)
  75
  76 *do_prelink=*"__{yes|no}__"::
  77     Prelink binaries in the initramfs (default=yes)
  78
  79 *hostonly=*"__{yes|no}__"::
  80     Host-Only mode: Install only what is needed for booting the local host
  81     instead of a generic host and generate host-specific configuration.
  82
  83 *hostonly_cmdline*"__{yes|no}__"::
  84     If set, store the kernel command line arguments needed in the initramfs
  85
  86 *persistent_policy=*"__<policy>__"::
  87     Use _<policy>_ to address disks and partitions.
  88     _<policy>_ can be any directory name found in /dev/disk.
  89     E.g. "by-uuid", "by-label"
  90
  91 *tmpdir=*"__<temporary directory>__"::
  92     Specify temporary directory to use.
  93
  94 [WARNING]
  95 ====
  96 If chrooted to another root other than the real root device, use --fstab and
  97 provide a valid _/etc/fstab_.
  98 ====
  99
 100 *use_fstab=*"__{yes|no}__"::
 101     Use _/etc/fstab_ instead of _/proc/self/mountinfo_.
 102
 103 *add_fstab+=*" __<filename>__ "::
 104     Add entries of __<filename>__ to the initramfs /etc/fstab.
 105
 106 *add_device+=*" __<device>__ "::
 107     Bring up _<device>_ in initramfs, _<device>_ should be the device name.
 108     This can be useful in hostonly mode for resume support when your swap is on
 109     LVM an encrypted partition.
 110
 111 *mdadmconf=*"__{yes|no}__"::
 112     Include local _/etc/mdadm.conf_ (default=yes)
 113
 114 *lvmconf=*"__{yes|no}__"::
 115     Include local _/etc/lvm/lvm.conf_ (default=yes)
 116
 117 *fscks=*" __<fsck tools>__ "::
 118     Add a space-separated list of fsck tools. If nothing is specified, the
 119     default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck
 120     jfs_fsck reiserfsck btrfsck". The installation is opportunistic
 121     (non-existing tools are ignored).
 122
 123 *nofscks=*"__{yes|no}__"::
 124     If specified, inhibit installation of any fsck tools.
 125
 126 *ro_mnt=*"__{yes|no}__"::
 127     Mount _/_ and _/usr_ read-only by default.
 128
 129 *kernel_cmdline=*"__parameters__"::
 130     Specify default kernel command line parameters
 131
 132 *kernel_only=*"__{yes|no}__"::
 133     Only install kernel drivers and firmware files. (default=no)
 134
 135 *no_kernel=*"__{yes|no}__"::
 136     Do not install kernel drivers and firmware files (default=no)
 137
 138 *acpi_override=*"__{yes|no}__"::
 139     [WARNING] ONLY USE THIS IF YOU KNOW WHAT YOU ARE DOING! +
 140     Override BIOS provided ACPI tables. For further documentation read
 141     Documentation/acpi/initrd_table_override.txt in the kernel sources.
 142     Search for ACPI table files (must have .aml suffix) in acpi_table_dir=
 143     directory (see below) and add them to a separate uncompressed cpio
 144     archive. This cpio archive gets glued (concatenated, uncompressed one
 145     must be the first one) to the compressed cpio archive. The first,
 146     uncompressed cpio archive is for data which the kernel must be able
 147     to access very early (and cannot make use of uncompress alogrithms yet)
 148     like microcode or ACPI tables (default=no).
 149
 150 *acpi_table_dir=*"__<dir>__"::
 151     Directory to search for ACPI tables if acpi_override= is set to yes.
 152
 153 *early_microcode=*"{yes|no}"::
 154     Combine early microcode with ramdisk (default=no)
 155
 156 *stdloglvl*="__\{0-6\}__"::
 157     Set logging to standard error level.
 158
 159 *sysloglvl*="__\{0-6\}__"::
 160     Set logging to syslog level.
 161
 162 *fileloglvl=*"__\{0-6\}__"::
 163     Set logging to file level.
 164
 165 *logfile=*"__<file>__"::
 166     Path to log file.
 167
 168 *show_modules=*"__{yes|no}__"::
 169     Print the name of the included modules to standard output during build.
 170
 171 *i18n_vars="__<variable mapping>__"::
 172     Distribution specific variable mapping.
 173     See dracut/modules.d/10i18n/README for a detailed description.
 174
 175 *i18n_default_font=*"__<fontname>__"::
 176     The font <fontname> to install, if not specified otherwise.
 177     Default is "LatArCyrHeb-16".
 178
 179 *i18n_install_all=*"__{yes|no}__"::
 180     Install everything regardless of generic or hostonly mode.
 181
 182 *reproducible=*"__{yes|no}__"::
 183     Create reproducible images.
 184
 185 Files
 186 -----
 187 _/etc/dracut.conf_::
 188     Old configuration file. You better use your own file in
 189     _/etc/dracut.conf.d/_.
 190
 191 _/etc/dracut.conf.d/_::
 192     Any _/etc/dracut.conf.d/*.conf_ file can overwrite the values in
 193     _/etc/dracut.conf_. The configuration files are read in alphanumerical
 194     order.
 195
 196 AUTHOR
 197 ------
 198 Harald Hoyer
 199
 200 See Also
 201 --------
 202 *dracut*(8) *dracut.cmdline*(7)
 203