| .\\" auto-generated by docbook2man-spec $Revision: 1.2 $ |
| .TH "DEPMOD.CONF" "5" "2010-03-01" "" "" |
| .SH NAME |
| depmod.conf, depmod.d \- Configuration file/directory for depmod |
| .SH "DESCRIPTION" |
| .PP |
| The order in which modules are processed by the |
| \fBdepmod\fR command can be altered on a global or |
| per-module basis. This is typically useful in cases where built-in |
| kernel modules are complemented by custom built versions of the |
| same and the user wishes to affect the priority of processing in |
| order to override the module version supplied by the kernel. |
| .PP |
| The format of \fIdepmod.conf\fR and files under \fIdepmod.d\fR is simple: one |
| command per line, with blank lines and lines starting with '#' |
| ignored (useful for adding comments). A '\\' at the end of a line |
| causes it to continue on the next line, which makes the file a |
| bit neater. |
| .SH "COMMANDS" |
| .TP |
| \fBsearch \fIsubdirectory...\fB\fR |
| This allows you to specify the order in which /lib/modules |
| (or other configured module location) subdirectories will |
| be processed by \fBdepmod\fR\&. Directories are |
| listed in order, with the highest priority given to the |
| first listed directory and the lowest priority given to the last |
| directory listed. The special keyword \fBbuilt-in\fR |
| refers to the standard module directories installed by the kernel. |
| |
| By default, depmod will give a higher priority to |
| a directory with the name \fBupdates\fR |
| using this built-in search string: "updates built-in" |
| but more complex arrangements are possible and are |
| used in several popular distributions. |
| .TP |
| \fBoverride \fImodulename\fB \fIkernelversion\fB \fImodulesubdirectory\fB\fR |
| This command allows you to override which version of a |
| specific module will be used when more than one module |
| sharing the same name is processed by the |
| \fBdepmod\fR command. It is possible to |
| specify one kernel or all kernels using the * wildcard. |
| \fImodulesubdirectory\fR is the |
| name of the subdirectory under /lib/modules (or other |
| module location) where the target module is installed. |
| |
| For example, it is possible to override the priority of |
| an updated test module called \fBkmod\fR by |
| specifying the following command: "override kmod * extra". |
| This will ensure that any matching module name installed |
| under the \fBextra\fR subdirectory within |
| /lib/modules (or other module location) will take priority |
| over any likenamed module already provided by the kernel. |
| .SH "COPYRIGHT" |
| .PP |
| This manual page Copyright 2006-2010, Jon Masters, Red Hat, Inc. |
| .SH "SEE ALSO" |
| .PP |
| \fBdepmod\fR(8) |