depmod.conf.5

   1 .\\" auto-generated by docbook2man-spec $Revision: 1.2 $
   2 .TH "DEPMOD.CONF" "5" "2010-03-01" "" ""
   3 .SH NAME
   4 depmod.conf, depmod.d \- Configuration file/directory for depmod
   5 .SH "DESCRIPTION"
   6 .PP
   7 The order in which modules are processed by the
   8 \fBdepmod\fR command can be altered on a global or
   9 per-module basis. This is typically useful in cases where built-in
  10 kernel modules are complemented by custom built versions of the
  11 same and the user wishes to affect the priority of processing in
  12 order to override the module version supplied by the kernel.
  13 .PP
  14 The format of \fIdepmod.conf\fR and files under \fIdepmod.d\fR is simple: one
  15 command per line, with blank lines and lines starting with '#'
  16 ignored (useful for adding comments). A '\\' at the end of a line
  17 causes it to continue on the next line, which makes the file a
  18 bit neater.
  19 .SH "COMMANDS"
  20 .TP
  21 \fBsearch \fIsubdirectory...\fB\fR
  22 This allows you to specify the order in which /lib/modules
  23 (or other configured module location) subdirectories will
  24 be processed by \fBdepmod\fR\&. Directories are
  25 listed in order, with the highest priority given to the
  26 first listed directory and the lowest priority given to the last
  27 directory listed. The special keyword \fBbuilt-in\fR
  28 refers to the standard module directories installed by the kernel.
  29
  30 By default, depmod will give a higher priority to
  31 a directory with the name \fBupdates\fR
  32 using this built-in search string: "updates built-in"
  33 but more complex arrangements are possible and are
  34 used in several popular distributions.
  35 .TP
  36 \fBoverride \fImodulename\fB \fIkernelversion\fB \fImodulesubdirectory\fB\fR
  37 This command allows you to override which version of a
  38 specific module will be used when more than one module
  39 sharing the same name is processed by the
  40 \fBdepmod\fR command. It is possible to
  41 specify one kernel or all kernels using the * wildcard.
  42 \fImodulesubdirectory\fR is the
  43 name of the subdirectory under /lib/modules (or other
  44 module location) where the target module is installed.
  45
  46 For example, it is possible to override the priority of
  47 an updated test module called \fBkmod\fR by
  48 specifying the following command: "override kmod * extra".
  49 This will ensure that any matching module name installed
  50 under the \fBextra\fR subdirectory within
  51 /lib/modules (or other module location) will take priority
  52 over any likenamed module already provided by the kernel.
  53 .SH "COPYRIGHT"
  54 .PP
  55 This manual page Copyright 2006-2010, Jon Masters, Red Hat, Inc.
  56 .SH "SEE ALSO"
  57 .PP
  58 \fBdepmod\fR(8)