[Summary view] [Print] [Text view]

   1  .\" This manpage has been automatically generated by docbook2man 
   2  .\" from a DocBook document.  This tool can be found at:
   3  .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
   4  .\" Please send any bug reports, improvements, comments, patches, 
   5  .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6  .TH "DEPMOD.CONF" "5" "13 October 2008" "" ""
   7  
   8  .SH NAME
   9  depmod.conf, depmod.d \- Configuration file/directory for depmod
  10  .SH "DESCRIPTION"
  11  .PP
  12  The order in which modules are processed by the
  13  \fBdepmod\fR command can be altered on a global or
  14  per-module basis. This is typically useful in cases where built-in
  15  kernel modules are complemented by custom built versions of the
  16  same and the user wishes to affect the priority of processing in
  17  order to override the module version supplied by the kernel.
  18  .PP
  19  The format of \fIdepmod.conf\fR and files under \fIdepmod.d\fR is simple: one
  20  command per line, with blank lines and lines starting with #
  21  ignored (useful for adding comments).  A \\ at the end of a line
  22  causes it to continue on the next line, which makes the file a
  23  bit neater.
  24  .SH "COMMANDS"
  25  .TP
  26  \fBsearch \fIsubdirectory...\fB \fR
  27  This allows you to specify the order in which /lib/modules
  28  (or other configured module location) subdirectories will
  29  be processed by \fBdepmod\fR\&. Directories are
  30  listed in order, with the highest priority given to the
  31  first listed directory and the lowest to the last. The
  32  special keyword \fBbuilt-in\fR refers to
  33  the standard module directories installed by the kernel.
  34  
  35  By default, depmod will give a higher priority to 
  36  a directory with the name \fBupdates\fR
  37  using this built-in search string: "updates built-in"
  38  but more complex arrangements are possible and are
  39  used in several popular distributions.
  40  .TP
  41  \fBoverride \fImodulename\fB \fIkernelversion\fB \fImodulesubdirectory\fB \fR
  42  This command allows you to override which version of a
  43  specific module will be used when more than one module
  44  sharing the same name is processed by the
  45  \fBdepmod\fR command. It is possible to
  46  specify one kernel or all kernels using the * wildcard.
  47  \fImodulesubdirectory\fR is the
  48  name of the subdirectory under /lib/modules (or other
  49  module location) where the target module is installed.
  50  
  51  For example, it is possible to override the priority of
  52  an updated test module called \fBkmp\fR by
  53  specifying the following command: "override kmp * extra".
  54  This will ensure that any matching module name installed
  55  under the \fBextra\fR subdirectory within
  56  /lib/modules (or other module location) will take priority
  57  over any likenamed module already provided by the kernel.
  58  .TP
  59  \fBinclude \fIfilename\fB \fR
  60  Using this command, you can include other configuration
  61  files, or whole directories, which is occasionally useful.
  62  .SH "COPYRIGHT"
  63  .PP
  64  This manual page Copyright 2006, Jon Masters, Red Hat, Inc.