.\" This manpage has been automatically generated by docbook2man .\" from a DocBook document.  This tool can be found at:.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>..TH "MODPROBE.CONF" "5" "22 December 2003" "" "".SH NAMEmodprobe.conf \- Configuration file for modprobe.SH "DESCRIPTION".PPBecause the \fBmodprobe\fR command can add orremove extra more than one module, due to module dependencies,we need a method of specifying what options are to be used withthose modules.  \fImodprobe.conf\fR specifiesthose options, as required.  It can also be used to createconvenient aliases: alternate names for a module.  Finally, itcan override the normal \fBmodprobe\fR behavioraltogether, for those with very special requirements (such asinserting more than one module)..PPNote that module and alias names (like other module names) canhave - or _ in them: both are interchangable throughout all themodule commands..PPThe format of \fImodprobe.conf\fR is simple: onecommand per line, with blank lines and lines starting with #ignored (useful for adding comments).  A \\ at the end of a linecauses it to continue on the next line, which makes the file abit neater..PPThe syntax is a simplification of \fImodules.conf\fR.SH "COMMANDS".TP\fBalias \fIwildcard\fB \fImodulename\fB \fRThis allows you to give alternate names for a module.  Forexample: "alias my-mod really_long_modulename"means you can use "modprobe my-mod" instead of "modprobereally_long_modulename".  You can also use shell-stylewildcards, so "alias my-mod* really_long_modulename"means that "modprobe my-mod-something" has the sameeffect.  You can't have aliases to other aliases (thatway lies madness), but aliases can have options, whichwill be added to any other options..TP\fBoptions \fImodulename\fB \fIoption...\fB \fRThis command allows you to add options to the module\fImodulename\fR (which might be analias) every time it is inserted into the kernel: whetherdirectly (using \fBmodprobe\fR \fImodulename\fR, or because themodule being inserted depends on this module.All options are added together: they can come from an\fBoption\fR for the module itself, for analias, and on the command line..TP\fBinstall \fImodulename\fB \fIcommand...\fB \fRThis is the most powerful primitive in\fImodprobe.conf\fR: it tells\fBmodprobe\fR to run your command instead ofinserting the module in the kernel as normal.  The commandcan be any shell command: this allows you to do any kindof complex processing you might wish.  For example, if themodule "fred" worked better with the module "barney"already installed (but it didn't depend on it, so\fBmodprobe\fR won't automatically load it),you could say "install fred /sbin/modprobe barney;/sbin/modprobe --ignore-install fred", which would do whatyou wanted.  Note the \fB--ignore-install\fR,which stops the second \fBmodprobe\fR fromre-running the same \fBinstall\fR command.See also \fBremove\fR below.You can also use \fBinstall\fR to make upmodules which don't otherwise exist.  For example:"install probe-ethernet /sbin/modprobe e100 ||/sbin/modprobe eepro100", which will try first the e100driver, then the eepro100 driver, when you do "modprobeprobe-ethernet"..TP\fBremove \fImodulename\fB \fIcommand...\fB \fRThis is similar to the \fBinstall\fR commandabove, except it is invoked when "modprobe -r" is run.The removal counterparts to the two examples above wouldbe: "remove fred /sbin/modprobe -r --ignore-remove fred &&/sbin/modprobe -r barney", and "remove probe-ethernet/sbin/modprobe -r eepro100 || /sbin/modprobe -r e100"..TP\fBinclude \fIfilename\fB \fRUsing this command, you can include other configurationfiles, which is occasionally useful.  Note that aliases inthe included file will override aliases previouslydeclared in the current file..SH "BACKWARDS COMPATIBILITY".PPThere is a \fBgenerate_modprobe.conf\fR programwhich should do a reasonable job of generating\fImodprobe.conf\fR from your current (2.4 or2.2) modules setup..PPAlthough the syntax is similar to the older\fI/etc/modules.conf\fR, there are many featuresmissing.  There are two reasons for this: firstly, install andremove commands can do just about anything, and secondly, themodule-init-tools modprobe is designed to be simple enough thatit can be easily replaced..PPWith the complexity of actual module insertion reduced to threesystem calls (open, read, init_module), and the\fImodules.dep\fR file being simple and open,producing a more powerful modprobe variant can be doneindependently if there is a need..SH "COPYRIGHT".PPThis manual page Copyright 2002, Rusty Russell, IBM Corporation..SH "SEE ALSO".PP\fBmodprobe\fR(8),\fBmodules.dep\fR(5)