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