Home | History | Annotate | Download | only in man 
      1 <?xml version="1.0"?>
      2 <!--*-nxml-*-->
      3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
      4 <refentry id="depmod.d">
      5   <refentryinfo>
      6     <title>depmod.d</title>
      7     <productname>kmod</productname>
      8 
      9     <authorgroup>
     10       <author>
     11         <contrib>Developer</contrib>
     12         <firstname>Jon</firstname>
     13         <surname>Masters</surname>
     14         <email>jcm (a] jonmasters.org</email>
     15       </author>
     16       <author>
     17         <contrib>Developer</contrib>
     18         <firstname>Robby</firstname>
     19         <surname>Workman</surname>
     20         <email>rworkman (a] slackware.com</email>
     21       </author>
     22       <author>
     23         <contrib>Developer</contrib>
     24         <firstname>Lucas</firstname>
     25         <surname>De Marchi</surname>
     26         <email>lucas.de.marchi (a] gmail.com</email>
     27       </author>
     28     </authorgroup>
     29   </refentryinfo>
     30 
     31   <refmeta>
     32     <refentrytitle>depmod.d</refentrytitle>
     33     <manvolnum>5</manvolnum>
     34   </refmeta>
     35 
     36   <refnamediv>
     37     <refname>depmod.d</refname>
     38     <refpurpose>Configuration directory for depmod</refpurpose>
     39   </refnamediv>
     40 
     41   <refsynopsisdiv>
     42     <para><filename>/usr/lib/depmod.d/*.conf</filename></para>
     43     <para><filename>/etc/depmod.d/*.conf</filename></para>
     44     <para><filename>/run/depmod.d/*.conf</filename></para>
     45   </refsynopsisdiv>
     46 
     47   <refsect1><title>DESCRIPTION</title>
     48     <para>The order in which modules are processed by the
     49       <command>depmod</command> command can be altered on a global or
     50       per-module basis. This is typically useful in cases where built-in
     51       kernel modules are complemented by custom built versions of the
     52       same and the user wishes to affect the priority of processing in
     53       order to override the module version supplied by the kernel.
     54     </para>
     55     <para>
     56       The format of files under <filename>depmod.d</filename> is simple: one
     57       command per line, with blank lines and lines starting with '#'
     58       ignored (useful for adding comments).  A '\' at the end of a line
     59       causes it to continue on the next line, which makes the files a
     60       bit neater.
     61     </para>
     62   </refsect1>
     63   <refsect1>
     64     <title>COMMANDS</title>
     65     <variablelist>
     66       <varlistentry>
     67         <term>search <replaceable>subdirectory...</replaceable>
     68         </term>
     69         <listitem>
     70           <para>
     71             This allows you to specify the order in which /lib/modules
     72             (or other configured module location) subdirectories will
     73             be processed by <command>depmod</command>. Directories are
     74             listed in order, with the highest priority given to the
     75             first listed directory and the lowest priority given to the last
     76             directory listed. The special keyword <command>built-in</command> 
     77             refers to the standard module directories installed by the kernel.
     78           </para>
     79           <para>
     80             By default, depmod will give a higher priority to 
     81             a directory with the name <command>updates</command>
     82             using this built-in search string: "updates built-in"
     83             but more complex arrangements are possible and are
     84             used in several popular distributions.
     85           </para>
     86         </listitem>
     87       </varlistentry>
     88       <varlistentry>
     89         <term>override <replaceable>modulename</replaceable> <replaceable>kernelversion</replaceable> <replaceable>modulesubdirectory</replaceable>
     90         </term>
     91         <listitem>
     92           <para>
     93             This command allows you to override which version of a
     94             specific module will be used when more than one module
     95             sharing the same name is processed by the
     96             <command>depmod</command> command. It is possible to
     97             specify one kernel or all kernels using the * wildcard.
     98             <replaceable>modulesubdirectory</replaceable> is the
     99             name of the subdirectory under /lib/modules (or other
    100             module location) where the target module is installed.
    101           </para>
    102           <para>
    103             For example, it is possible to override the priority of
    104             an updated test module called <command>kmod</command> by
    105             specifying the following command: "override kmod * extra".
    106             This will ensure that any matching module name installed
    107             under the <command>extra</command> subdirectory within
    108             /lib/modules (or other module location) will take priority
    109             over any likenamed module already provided by the kernel.
    110           </para>
    111         </listitem>
    112       </varlistentry>
    113     </variablelist>
    114   </refsect1>
    115 
    116   <refsect1><title>COPYRIGHT</title>
    117     <para>
    118       This manual page Copyright 2006-2010, Jon Masters, Red Hat, Inc.
    119     </para>
    120   </refsect1>
    121   <refsect1><title>SEE ALSO</title>
    122     <para>
    123       <citerefentry>
    124         <refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum>
    125       </citerefentry>
    126     </para>
    127   </refsect1>
    128 </refentry>
    129