chiark / gitweb /
headers: fix git URLs for source files
[elogind.git] / man / modules-load.d.xml
index 47acc08..b633663 100644 (file)
@@ -4,7 +4,7 @@
 <!--
   This file is part of systemd.
 
 <!--
   This file is part of systemd.
 
-  Copyright 2010 Brandon Philips
+  Copyright 2011 Lennart Poettering
 
   systemd is free software; you can redistribute it and/or modify it
   under the terms of the GNU General Public License as published by
 
   systemd is free software; you can redistribute it and/or modify it
   under the terms of the GNU General Public License as published by
         </refnamediv>
 
         <refsynopsisdiv>
         </refnamediv>
 
         <refsynopsisdiv>
+                <para><filename>/usr/lib/modules-load.d/*.conf</filename></para>
                 <para><filename>/etc/modules-load.d/*.conf</filename></para>
                 <para><filename>/etc/modules-load.d/*.conf</filename></para>
+                <para><filename>/run/modules-load.d/*.conf</filename></para>
         </refsynopsisdiv>
 
         <refsect1>
                 <title>Description</title>
 
                <para><command>systemd</command> uses
         </refsynopsisdiv>
 
         <refsect1>
                 <title>Description</title>
 
                <para><command>systemd</command> uses
-               <filename>/etc/modules-load.d/</filename> to configure
+               files from the above directories to configure
                kernel modules to load during boot in a static list.
                Each configuration file is named in the style of
                <filename>/etc/modules-load.d/&lt;program&gt;.conf</filename>. Note
                kernel modules to load during boot in a static list.
                Each configuration file is named in the style of
                <filename>/etc/modules-load.d/&lt;program&gt;.conf</filename>. Note
-               that it is usally a better idea to use the automatic
+               that it is usually a better idea to use the automatic
                module loading by PCI ID, by DMI ID or similar
                triggers configured in the kernel modules themselves
                instead of relying on static configuration like
                module loading by PCI ID, by DMI ID or similar
                triggers configured in the kernel modules themselves
                instead of relying on static configuration like
                <title>Configuration Format</title>
 
                <para>The configuration files should simply contain a
                <title>Configuration Format</title>
 
                <para>The configuration files should simply contain a
-               list of kernel modul names to load, seperated by
+               list of kernel module names to load, separated by
                newlines. Empty lines and lines whose first
                non-whitespace character is # or ; are ignored.</para>
 
                newlines. Empty lines and lines whose first
                non-whitespace character is # or ; are ignored.</para>
 
+                <para>Each configuration file is named in the style of
+                <filename>&lt;program&gt;.conf</filename>.
+                Files in <filename>/etc/</filename> overwrite
+                files with the same name in <filename>/usr/lib/</filename>.
+                Files in <filename>/run</filename> overwrite files with
+                the same name in <filename>/etc/</filename> and
+                <filename>/usr/lib/</filename>. Packages should install their
+                configuration files in <filename>/usr/lib/</filename>, files
+                in <filename>/etc/</filename> are reserved for the local
+                administration, which possibly decides to overwrite the
+                configurations installed from packages. All files are sorted
+                by filename in alphabetical order, regardless in which of the
+                directories they reside, to ensure that a specific
+                configuration file takes precedence over another file with
+                an alphabetically later name.</para>
         </refsect1>
 
         <refsect1>
                 <title>Example</title>
                 <example>
         </refsect1>
 
         <refsect1>
                 <title>Example</title>
                 <example>
-                        <title>/etc/modules-load.d/uinput.conf example:</title>
+                        <title>/etc/modules-load.d/virtio-net.conf example:</title>
 
 
-                        <programlisting># Load uinput.ko at boot
-uinput</programlisting>
+                        <programlisting># Load virtio-net.ko at boot
+virtio-net</programlisting>
                 </example>
         </refsect1>
 
                 </example>
         </refsect1>