dracut-functions: only dinfo() about missing firmware files

[thirdparty/dracut.git] / dracut.conf.5.xml

<?xml version='1.0' encoding='UTF-8'?>
<!-- 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" []>
<refentry id="dracutconf5">
  <refentryinfo>
    <title>dracut.conf</title>
    <productname>dracut</productname>
    <authorgroup>
      <author>
        <contrib>Developer</contrib>
        <firstname>Harald</firstname>
        <surname>Hoyer</surname>
        <email>harald@redhat.com</email>
      </author>
    </authorgroup>
  </refentryinfo>
  <refmeta>
    <refentrytitle>dracut.conf</refentrytitle>
    <manvolnum>5</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>dracut.conf</refname>
    <refpurpose>configuration file(s) for dracut</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>/etc/dracut.conf</command>
      <arg choice="plain">
        <replaceable>/etc/dracut.conf.d/*.conf</replaceable>
      </arg>
      <sbr/>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>Description</title>
    <para><filename>dracut.conf</filename>
is loaded during the initialisation phase of dracut.
Command line parameter will overwrite any values set here.
<emphasis><filename>dracut.conf.d/*.conf</filename> files are read in alphanumerical order and will</emphasis>
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>
    <variablelist>
      <varlistentry>
        <term>
          <envar>dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
        </term>
        <listitem>
          <para>Specify a space-separated list of dracut modules to
call when building the initramfs. Modules are located
in <filename>/usr/share/dracut/modules.d</filename>.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>omit_dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
        </term>
        <listitem>
          <para>Omit a space-separated list of dracut modules.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>add_dracutmodules+=&quot;&nbsp;<replaceable>&lt;dracut modules&gt;</replaceable>&nbsp;&quot;</envar>
        </term>
        <listitem>
          <para>Add a space-separated list of dracut modules.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>drivers+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
        </term>
        <listitem>
          <para>Specify a space-separated list of kernel modules to
exclusively include in the initramfs.
The kernel modules have to be specified without the &quot;.ko&quot; suffix.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>add_drivers+=&quot;&nbsp;<replaceable>&lt;kernel modules&gt;</replaceable>&nbsp;&quot;</envar>
        </term>
        <listitem>
          <para>Specify a space-separated list of kernel 
modules to add to the initramfs.
The kernel modules have to be specified without the &quot;.ko&quot; suffix.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>filesystems+=&quot;&nbsp;<replaceable>&lt;filesystem names&gt;</replaceable>&nbsp;&quot;</envar>
        </term>
        <listitem>
          <para>Specify a space-separated list of kernel filesystem
modules to exclusively include in the generic
initramfs.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>drivers_dir=&quot;<replaceable>&lt;kernel modules directory&gt;</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Specify the directory, where to look for kernel modules</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>fw_dir+=&quot;&#160;:<replaceable>&lt;dir&gt;</replaceable>[:<replaceable>&lt;dir&gt;</replaceable>&nbsp;...]&nbsp;&quot;</envar>
        </term>
        <listitem>
          <para>Specify additional directories, where to look for firmwares, separated by <constant>:</constant></para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>do_strip=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Strip binaries in the initramfs (default=yes)</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>hostonly=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Host-Only mode: Install only what is needed for booting 
   the local host instead of a generic host.
   <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>
            </warning>
   </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>use_fstab=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Use <filename>/etc/fstab</filename> instead of <filename>/proc/self/mountinfo</filename>.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>mdadmconf=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Include local <filename>/etc/mdadm.conf</filename> (default=yes)</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>lvmconf=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Include local <filename>/etc/lvm/lvm.conf</filename> (default=yes)</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>kernel_only=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Only install kernel drivers and firmware files. (default=no)</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>no_kernel=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Do not install kernel drivers and firmware files (default=no)</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>stdloglvl=&quot;<replaceable>{0-6}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Set logging to standard error level.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>sysloglvl=&quot;<replaceable>{0-6}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Set logging to syslog level.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>fileloglvl=&quot;<replaceable>{0-6}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Set logging to file level.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>logfile=&quot;<replaceable>&lt;file&gt;</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Path to log file.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <envar>show_modules=&quot;<replaceable>{yes|no}</replaceable>&quot;</envar>
        </term>
        <listitem>
          <para>Print included module's name to standard output during build.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>Files</title>
    <variablelist>
      <varlistentry>
        <term>
          <filename>/etc/dracut/conf.d/</filename>
        </term>
        <listitem>
          <para>Any <filename>/etc/dracut/conf.d/*.conf</filename> file can overwrite the values in <filename>/etc/dracut.conf</filename>.
The configuration files are read in alphanumerical order.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>See Also</title>
    <para><citerefentry>
        <refentrytitle>dracut</refentrytitle>
        <manvolnum>8</manvolnum>
      </citerefentry>
      <citerefentry>
        <refentrytitle>dracut.kernel</refentrytitle>
        <manvolnum>7</manvolnum>
      </citerefentry>
    </para>
  </refsect1>
</refentry>