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 <refentry id="dracutconf5">
   4   <refentryinfo>
   5     <title>dracut.conf</title>
   6     <productname>dracut</productname>
   7     <authorgroup>
   8       <author>
   9         <contrib>Developer</contrib>
  10         <firstname>Harald</firstname>
  11         <surname>Hoyer</surname>
  12         <email>harald@redhat.com</email>
  13       </author>
  14     </authorgroup>
  15   </refentryinfo>
  16   <refmeta>
  17     <refentrytitle>dracut.conf</refentrytitle>
  18     <manvolnum>5</manvolnum>
  19   </refmeta>
  20   <refnamediv>
  21     <refname>dracut.conf</refname>
  22     <refpurpose>configuration file(s) for dracut</refpurpose>
  23   </refnamediv>
  24   <refsynopsisdiv>
  25     <cmdsynopsis>
  26       <command>/etc/dracut.conf</command>
  27       <arg choice="plain">
  28         <replaceable>/etc/dracut.conf.d/*.conf</replaceable>
  29       </arg>
  30       <sbr/>
  31     </cmdsynopsis>
  32   </refsynopsisdiv>
  33   <refsect1>
  34     <title>Description</title>
  35     <para><filename>dracut.conf</filename>
  36 is loaded during the initialisation phase of dracut.
  37 Command line parameter will overwrite any values set here.
  38 <emphasis><filename>dracut.conf.d/*.conf</filename> files are read in alphanumerical order and will</emphasis>
  39 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>
  40     <variablelist>
  41       <varlistentry>
  42         <term>
  43           <envar>dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
  44         </term>
  45         <listitem>
  46           <para>Specify a space-separated list of dracut modules to
  47 call when building the initramfs. Modules are located
  48 in <filename>/usr/share/dracut/modules.d</filename>.</para>
  49         </listitem>
  50       </varlistentry>
  51       <varlistentry>
  52         <term>
  53           <envar>omit_dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
  54         </term>
  55         <listitem>
  56           <para>Omit a space-separated list of dracut modules.</para>
  57         </listitem>
  58       </varlistentry>
  59       <varlistentry>
  60         <term>
  61           <envar>add_dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
  62         </term>
  63         <listitem>
  64           <para>Add a space-separated list of dracut modules.</para>
  65         </listitem>
  66       </varlistentry>
  67       <varlistentry>
  68         <term>
  69           <envar>drivers+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
  70         </term>
  71         <listitem>
  72           <para>Specify a space-separated list of kernel modules to
  73 exclusively include in the initramfs.
  74 The kernel modules have to be specified without the &quot;.ko&quot; suffix.</para>
  75         </listitem>
  76       </varlistentry>
  77       <varlistentry>
  78         <term>
  79           <envar>add_drivers+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
  80         </term>
  81         <listitem>
  82           <para>Specify a space-separated list of kernel
  83 modules to add to the initramfs.
  84 The kernel modules have to be specified without the &quot;.ko&quot; suffix.</para>
  85         </listitem>
  86       </varlistentry>
  87       <varlistentry>
  88         <term>
  89           <envar>filesystems+=&quot;&nbsp;<replaceable>&lt;filesystem names&gt;</replaceable>&nbsp;&quot;</envar>
  90         </term>
  91         <listitem>
  92           <para>Specify a space-separated list of kernel filesystem
  93 modules to exclusively include in the generic
  94 initramfs.</para>
  95         </listitem>
  96       </varlistentry>
  97       <varlistentry>
  98         <term>
  99           <envar>drivers_dir=&quot;<replaceable>&lt;kernel modules directory&gt;</replaceable>&quot;</envar>
 100         </term>
 101         <listitem>
 102           <para>Specify the directory, where to look for kernel modules</para>
 103         </listitem>
 104       </varlistentry>
 105       <varlistentry>
 106         <term>
 107           <envar>fw_dir+=&quot;&#160;:<replaceable>&lt;dir&gt;</replaceable>[:<replaceable>&lt;dir&gt;</replaceable>&nbsp;...]&nbsp;&quot;</envar>
 108         </term>
 109         <listitem>
 110           <para>Specify additional directories, where to look for firmwares, separated by <constant>:</constant></para>
 111         </listitem>
 112       </varlistentry>
 113       <varlistentry>
 114         <term>
 115           <envar>do_strip=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 116         </term>
 117         <listitem>
 118           <para>Strip binaries in the initramfs (default=yes)</para>
 119         </listitem>
 120       </varlistentry>
 121       <varlistentry>
 122         <term>
 123           <envar>hostonly=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 124         </term>
 125         <listitem>
 126           <para>Host-Only mode: Install only what is needed for booting
 127    the local host instead of a generic host.
 128    <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>
 129             </warning>
 130    </para>
 131         </listitem>
 132       </varlistentry>
 133       <varlistentry>
 134         <term>
 135           <envar>use_fstab=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 136         </term>
 137         <listitem>
 138           <para>Use <filename>/etc/fstab</filename> instead of <filename>/proc/self/mountinfo</filename>.</para>
 139         </listitem>
 140       </varlistentry>
 141       <varlistentry>
 142         <term>
 143           <envar>mdadmconf=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 144         </term>
 145         <listitem>
 146           <para>Include local <filename>/etc/mdadm.conf</filename> (default=yes)</para>
 147         </listitem>
 148       </varlistentry>
 149       <varlistentry>
 150         <term>
 151           <envar>lvmconf=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 152         </term>
 153         <listitem>
 154           <para>Include local <filename>/etc/lvm/lvm.conf</filename> (default=yes)</para>
 155         </listitem>
 156       </varlistentry>
 157       <varlistentry>
 158         <term>
 159           <envar>kernel_only=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 160         </term>
 161         <listitem>
 162           <para>Only install kernel drivers and firmware files. (default=no)</para>
 163         </listitem>
 164       </varlistentry>
 165       <varlistentry>
 166         <term>
 167           <envar>no_kernel=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
 168         </term>
 169         <listitem>
 170           <para>Do not install kernel drivers and firmware files (default=no)</para>
 171         </listitem>
 172       </varlistentry>
 173     </variablelist>
 174   </refsect1>
 175   <refsect1>
 176     <title>Files</title>
 177     <variablelist>
 178       <varlistentry>
 179         <term>
 180           <filename>/etc/dracut/conf.d/</filename>
 181         </term>
 182         <listitem>
 183           <para>Any <filename>/etc/dracut/conf.d/*.conf</filename> file can overwrite the values in <filename>/etc/dracut.conf</filename>.
 184 The configuration files are read in alphanumerical order.</para>
 185         </listitem>
 186       </varlistentry>
 187     </variablelist>
 188   </refsect1>
 189   <refsect1>
 190     <title>See Also</title>
 191     <para><citerefentry>
 192         <refentrytitle>dracut</refentrytitle>
 193         <manvolnum>8</manvolnum>
 194       </citerefentry>
 195       <citerefentry>
 196         <refentrytitle>dracut.kernel</refentrytitle>
 197         <manvolnum>7</manvolnum>
 198       </citerefentry>
 199     </para>
 200   </refsect1>
 201 </refentry>