dracut.conf.5.xml

   1 <?xml version='1.0' encoding='UTF-8'?>
   2 <!-- This document was created with Syntext Serna Free. --><!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>
   3 <!-- vim: set ts=8 sts=2 sw=2 et: -->
   4 <refentry id="dracutconf5">
   5   <refentryinfo>
   6     <title>dracut.conf</title>
   7     <productname>dracut</productname>
   8     <authorgroup>
   9       <author>
  10         <contrib>Developer</contrib>
  11         <firstname>Harald</firstname>
  12         <surname>Hoyer</surname>
  13         <email>harald@redhat.com</email>
  14       </author>
  15     </authorgroup>
  16   </refentryinfo>
  17   <refmeta>
  18     <refentrytitle>dracut.conf</refentrytitle>
  19     <manvolnum>5</manvolnum>
  20   </refmeta>
  21   <refnamediv>
  22     <refname>dracut.conf</refname>
  23     <refpurpose>configuration file(s) for dracut</refpurpose>
  24   </refnamediv>
  25   <refsynopsisdiv>
  26     <cmdsynopsis>
  27       <command>/etc/dracut.conf</command>
  28       <arg choice="plain">
  29         <replaceable>/etc/dracut.conf.d/*.conf</replaceable>
  30       </arg>
  31       <sbr/>
  32     </cmdsynopsis>
  33   </refsynopsisdiv>
  34   <refsect1>
  35     <title>Description</title>
  36     <para><filename>dracut.conf</filename>
  37 is loaded during the initialisation phase of dracut.
  38 Command line parameter will overwrite any values set here.
  39 <emphasis><filename>dracut.conf.d/*.conf</filename> files are read in alphanumerical order and will</emphasis>
  40 overwrite parameters set in <filename>/etc/dracut.conf</filename>. Each line specifies an attribute and a value. A &apos;#&apos; indicates the beginning of a comment; following characters, up to the end of the line are not interpreted.</para>
  41     <variablelist>
  42       <varlistentry>
  43         <term>
  44           <envar>dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
  45         </term>
  46         <listitem>
  47           <para>Specify a space-separated list of dracut modules to
  48 call when building the initramfs. Modules are located
  49 in <filename>/usr/lib/dracut/modules.d</filename>.</para>
  50         </listitem>
  51       </varlistentry>
  52       <varlistentry>
  53         <term>
  54           <envar>omit_dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
  55         </term>
  56         <listitem>
  57           <para>Omit a space-separated list of dracut modules.</para>
  58         </listitem>
  59       </varlistentry>
  60       <varlistentry>
  61         <term>
  62           <envar>add_dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
  63         </term>
  64         <listitem>
  65           <para>Add a space-separated list of dracut modules.</para>
  66         </listitem>
  67       </varlistentry>
  68       <varlistentry>
  69         <term>
  70           <envar>drivers+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
  71         </term>
  72         <listitem>
  73           <para>Specify a space-separated list of kernel modules to
  74 exclusively include in the initramfs.
  75 The kernel modules have to be specified without the &quot;.ko&quot; suffix.</para>
  76         </listitem>
  77       </varlistentry>
  78       <varlistentry>
  79         <term>
  80           <envar>add_drivers+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
  81         </term>
  82         <listitem>
  83           <para>Specify a space-separated list of kernel
  84 modules to add to the initramfs.
  85 The kernel modules have to be specified without the &quot;.ko&quot; suffix.</para>
  86         </listitem>
  87       </varlistentry>
  88       <varlistentry>
  89         <term>
  90           <envar>omit_drivers+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
  91         </term>
  92         <listitem>
  93           <para>Specify a space-separated list of kernel
  94 modules not to add to the initramfs.
  95 The kernel modules have to be specified without the &quot;.ko&quot; suffix.</para>
  96         </listitem>
  97       </varlistentry>
  98       <varlistentry>
  99         <term>
 100           <envar>install_items+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
 101         </term>
 102         <listitem>
 103           <para>Specify a space-separated list of files, which are added to the initramfs image.</para>
 104         </listitem>
 105       </varlistentry>
 106       <varlistentry>
 107         <term>
 108           <envar>filesystems+=&quot;&nbsp;<replaceable>&lt;filesystem names&gt;</replaceable>&nbsp;&quot;</envar>
 109         </term>
 110         <listitem>
 111           <para>Specify a space-separated list of kernel filesystem
 112 modules to exclusively include in the generic
 113 initramfs.</para>
 114         </listitem>
 115       </varlistentry>
 116       <varlistentry>
 117         <term>
 118           <envar>drivers_dir=&quot;<replaceable>&lt;kernel modules directory&gt;</replaceable>&quot;</envar>
 119         </term>
 120         <listitem>
 121           <para>Specify the directory, where to look for kernel modules</para>
 122         </listitem>
 123       </varlistentry>
 124       <varlistentry>
 125         <term>
 126           <envar>fw_dir+=&quot;&#160;:<replaceable>&lt;dir&gt;</replaceable>[:<replaceable>&lt;dir&gt;</replaceable>&nbsp;...]&nbsp;&quot;</envar>
 127         </term>
 128         <listitem>
 129           <para>Specify additional directories, where to look for firmwares, separated by <constant>:</constant></para>
 130         </listitem>
 131       </varlistentry>
 132       <varlistentry>
 133         <term>
 134           <envar>install_items+=&quot;&#160;<replaceable>&lt;file&gt;</replaceable>[ <replaceable>&lt;file&gt;</replaceable>&nbsp;...]&nbsp;&quot;</envar>
 135         </term>
 136         <listitem>
 137           <para>Specify additional files to include in the initramfs, separated by spaces.</para>
 138         </listitem>
 139       </varlistentry>
 140       <varlistentry>
 141         <term>
 142           <envar>do_strip=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 143         </term>
 144         <listitem>
 145           <para>Strip binaries in the initramfs (default=yes)</para>
 146         </listitem>
 147       </varlistentry>
 148       <varlistentry>
 149         <term>
 150           <envar>hostonly=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 151         </term>
 152         <listitem>
 153           <para>Host-Only mode: Install only what is needed for booting
 154    the local host instead of a generic host.
 155    <warning><para>If chrooted to another root other than the real root device, use <option>--fstab</option> and provide a valid <filename>/etc/fstab</filename>.</para>
 156             </warning>
 157    </para>
 158         </listitem>
 159       </varlistentry>
 160       <varlistentry>
 161         <term>
 162           <envar>use_fstab=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 163         </term>
 164         <listitem>
 165           <para>Use <filename>/etc/fstab</filename> instead of <filename>/proc/self/mountinfo</filename>.</para>
 166         </listitem>
 167       </varlistentry>
 168       <varlistentry>
 169         <term>
 170           <envar>add_fstab+=&quot;&nbsp;<replaceable>&lt;filename&gt;</replaceable>&nbsp;&quot;</envar>
 171         </term>
 172         <listitem>
 173           <para>Add entries of <replaceable>&lt;filename&gt;</replaceable> to the initramfs /etc/fstab.</para>
 174         </listitem>
 175       </varlistentry>
 176       <varlistentry>
 177         <term>
 178           <envar>mdadmconf=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 179         </term>
 180         <listitem>
 181           <para>Include local <filename>/etc/mdadm.conf</filename> (default=yes)</para>
 182         </listitem>
 183       </varlistentry>
 184       <varlistentry>
 185         <term>
 186           <envar>lvmconf=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 187         </term>
 188         <listitem>
 189           <para>Include local <filename>/etc/lvm/lvm.conf</filename> (default=yes)</para>
 190         </listitem>
 191       </varlistentry>
 192       <varlistentry>
 193         <term>
 194           <envar>fscks=&quot;&nbsp;<replaceable>&lt;fsck tools&gt;</replaceable>&nbsp;&quot;</envar>
 195         </term>
 196         <listitem>
 197           <para>Add a space-separated list of fsck tools. If nothing is
 198             specified, the default is: &quot;<replaceable>umount mount
 199             /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck jfs_fsck
 200             reiserfsck btrfsck</replaceable>&quot;
 201           </para>
 202           <para>The installation is opportunistic (non-existing tools are ignored).</para>
 203         </listitem>
 204       </varlistentry>
 205       <varlistentry>
 206         <term>
 207           <envar>nofscks=&quot;<replaceable>{yes}</replaceable>&quot;</envar>
 208         </term>
 209         <listitem>
 210           <para>If specified, inhibit installation of any fsck tools.</para>
 211         </listitem>
 212       </varlistentry>
 213       <varlistentry>
 214         <term>
 215           <envar>kernel_only=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 216         </term>
 217         <listitem>
 218           <para>Only install kernel drivers and firmware files. (default=no)</para>
 219         </listitem>
 220       </varlistentry>
 221       <varlistentry>
 222         <term>
 223           <envar>no_kernel=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 224         </term>
 225         <listitem>
 226           <para>Do not install kernel drivers and firmware files (default=no)</para>
 227         </listitem>
 228       </varlistentry>
 229       <varlistentry>
 230         <term>
 231           <envar>stdloglvl=&quot;<replaceable>{0-6}</replaceable>&quot;</envar>
 232         </term>
 233         <listitem>
 234           <para>Set logging to standard error level.</para>
 235         </listitem>
 236       </varlistentry>
 237       <varlistentry>
 238         <term>
 239           <envar>sysloglvl=&quot;<replaceable>{0-6}</replaceable>&quot;</envar>
 240         </term>
 241         <listitem>
 242           <para>Set logging to syslog level.</para>
 243         </listitem>
 244       </varlistentry>
 245       <varlistentry>
 246         <term>
 247           <envar>fileloglvl=&quot;<replaceable>{0-6}</replaceable>&quot;</envar>
 248         </term>
 249         <listitem>
 250           <para>Set logging to file level.</para>
 251         </listitem>
 252       </varlistentry>
 253       <varlistentry>
 254         <term>
 255           <envar>logfile=&quot;<replaceable>&lt;file&gt;</replaceable>&quot;</envar>
 256         </term>
 257         <listitem>
 258           <para>Path to log file.</para>
 259         </listitem>
 260       </varlistentry>
 261       <varlistentry>
 262         <term>
 263           <envar>show_modules=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 264         </term>
 265         <listitem>
 266           <para>Print included module's name to standard output during build.</para>
 267         </listitem>
 268       </varlistentry>
 269     </variablelist>
 270   </refsect1>
 271   <refsect1>
 272     <title>Files</title>
 273     <variablelist>
 274       <varlistentry>
 275         <term>
 276           <filename>/etc/dracut/conf.d/</filename>
 277         </term>
 278         <listitem>
 279           <para>Any <filename>/etc/dracut/conf.d/*.conf</filename> file can overwrite the values in <filename>/etc/dracut.conf</filename>.
 280 The configuration files are read in alphanumerical order.</para>
 281         </listitem>
 282       </varlistentry>
 283     </variablelist>
 284   </refsect1>
 285   <refsect1>
 286     <title>See Also</title>
 287     <para><citerefentry>
 288         <refentrytitle>dracut</refentrytitle>
 289         <manvolnum>8</manvolnum>
 290       </citerefentry>
 291       <citerefentry>
 292         <refentrytitle>dracut.cmdline</refentrytitle>
 293         <manvolnum>7</manvolnum>
 294       </citerefentry>
 295     </para>
 296   </refsect1>
 297 </refentry>