Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
depmod(8)
Edit
PageHistory
Diff
Info
LikePages
DEPMOD !!!DEPMOD NAME SYNOPSIS DESCRIPTION OPTIONS CONFIGURATION STRATEGY FILES SEE ALSO BUGS AUTHORS ---- !!NAME depmod - handle dependency descriptions for loadable kernel modules !!SYNOPSIS __depmod__ [[-aA] [[-ehnqrsuvV] [[-C ''configfile''] [[-F ''kernelsyms''] [[-b ''basedirectory''] [[''forced_version'']__ depmod__ [[-enqrsuv] [[-F ''kernelsyms''] module1.o module2.o ... !!DESCRIPTION The __depmod__ and __modprobe__ utilities are intended to make a Linux modular kernel manageable for all users, administrators and distribution maintainers. __Depmod__ creates a __modprobe__ to automatically load the correct module or stack of modules. The normal use of __depmod__ is to include the line __/sbin/depmod -a__ somewhere in the rc-files in ''/etc/rc.d'', so that the correct module dependencies will be available immediately after booting the system. Note that the option __-a__ is now optional. For boot-up purposes, the option __-q__ might be more appropriate since that makes depmod silent about unresolved symbols. It is also possible to create the dependency file immediately after compiling a new kernel. If you do depmod -a 2.2.99__ __-F__, __-C__ and __-b__ above for more information on handling this. While building the relationship between modules and the symbols exported by other modules, __depmod__ does not consider the GPL status of the modules nor of the exported symbols. That is, depmod will not flag an error if a module without a GPL compatible license refers to a GPL only symbol (EXPORT_SYMBOL_GPL in the kernel). However insmod will refuse to resolve GPL only symbols for non-GPL modules so the actual load will fail. !!OPTIONS __-a__, __--all__ Search for modules in all directories specified in the (optional) configuration file ''/etc/modules.conf''. __-A__, __--quick__ Compare file timestamps and, if necessary, act like __depmod -a__. This option only updates the dependency file if anything has changed. __-e__, __--errsyms__ Show all the unresolved symbols for each module. __-h__, __--help__ Display a summary of options and immediately exit. __-n__, __--show__ Write the dependency file on stdout instead of in the ''/lib/modules'' tree. __-q__, __--quiet__ Tell depmod to keep quiet and not to complain about missing symbols. __-r__, __--root__ Some users compile modules under a non-root userid then install the modules as root. This process can leave the modules owned by the non-root userid, even though the modules directory is owned by root. If the non-root userid is compromised, an intruder can overwrite existing modules owned by that userid and use this exposure to bootstrap up to root access. By default, modutils will reject attempts to use a module that is not owned by root. Specifying __-r__ will suppress the error and allow root to load modules that are not owned by root. __Use of -r is a major security exposure and is not recommended.__ __-s__, __--syslog__ Write all error messages via the syslog daemon instead of stderr. __-u__, __--unresolved-error__ __depmod__ 2.4 does not set a return code when there are any unresolved symbols. The next major release of modutils (2.5) will set a return code for unresolved symbols. Some distributions want a non-zero return code in modutils 2.4 but that change might cause problems for users who expect the old behaviour. If you want a non-zero return code in depmod 2.4, specify __-u__. __depmod__ 2.5 will silently ignore the __-u__ flag and will always give a non-zero return code for unresolved symbols. __-v__, __--verbose__ Show the name of each module as it is being processed. __-V__, __--version__ Display the version of __depmod__. The following options are useful for people managing distributions: __-b__ ''basedirectory'', __--basedir__ ''basedirectory'' If the directory tree ''/lib/modules'' containing the sub-trees of modules is moved somewhere else in order to handle modules for a different environment, the __-b__ option tells depmod where to find the moved image of the ''/lib/modules'' tree. The file references in the depmod output file that is built, ''modules.dep'', will not contain the ''basedirectory'' path. This means that when the file tree is moved back from ''basedirectory/lib/modules'' into ''/lib/modules'' in the final distribution, all references will be correct. __-C__ ''configfile'', __--config__ ''configfile'' Use the file ''configfile'' instead of ''/etc/modules.conf''. The environment variable __MODULECONF__ can also be used to select a different configuration file from the default ''/etc/modules.conf'' (or ''/etc/conf.modules'' (deprecated)). __-F kernelsyms__,__--filesyms__ ''kernelsyms'' When building dependency files for a different kernel than the currently running kernel, it is important that __depmod__ uses the correct set of kernel symbols to resolve the kernel references in each module. These symbols can either be a copy of ''System.map'' from the other kernel, or a copy of the output from ''/proc/ksyms''. If your kernel uses versioned symbols, it is best to use a copy of the ''/proc/ksyms'' output, since that file contains the symbol versions of the kernel symbols. However you can use a ''System.map'' even with versioned symbols. !!CONFIGURATION The behavior of __depmod__ and __modprobe__ can be adjusted by the (optional) configuration file ''/etc/modules.conf''. See modprobe(8) and modules.conf(5) for a complete description. !!STRATEGY Each time you compile a new kernel, the command make modules_install__ __ When you get a module unrelated to the kernel distribution you should place it in one of the version-independent directories under ''/lib/modules''. This is the default strategy, which can be overridden in ''/etc/modules.conf''. !!FILES ''/etc/modules.conf'' (alternatively but deprecated ''/etc/conf.modules'') ''/lib/modules/*/modules.dep'', ''/lib/modules/* '' !!SEE ALSO modules.conf(5), modprobe(8), modinfo(8), lsmod(8), ksyms(8) !!BUGS __depmod__ [[ -V | --version ] should exit immediately. Instead, it prints the version information and behaves as if no options were given. !!AUTHORS Jacques Gelinas (jack@solucorp.qc.ca) Bjorn Ekwall (bj0rn@blox.se) ----
7 pages link to
depmod(8)
:
modprobe(8)
Man8d
insmod(8)
ksyms(8)
lsmod(8)
modinfo(8)
modules.conf(5)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
