• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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@jonmasters.org</email>
15      </author>
16      <author>
17        <contrib>Developer</contrib>
18        <firstname>Robby</firstname>
19        <surname>Workman</surname>
20        <email>rworkman@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@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