summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man8/depmod.8
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man8/depmod.8')
-rw-r--r--upstream/opensuse-leap-15-6/man8/depmod.8173
1 files changed, 173 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man8/depmod.8 b/upstream/opensuse-leap-15-6/man8/depmod.8
new file mode 100644
index 00000000..cd9239d2
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man8/depmod.8
@@ -0,0 +1,173 @@
+'\" t
+.\" Title: depmod
+.\" Author: Jon Masters <jcm@jonmasters.org>
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\" Date: 01/29/2021
+.\" Manual: depmod
+.\" Source: kmod
+.\" Language: English
+.\"
+.TH "DEPMOD" "8" "01/29/2021" "kmod" "depmod"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+depmod \- Generate modules\&.dep and map files\&.
+.SH "SYNOPSIS"
+.HP \w'\fBdepmod\fR\ 'u
+\fBdepmod\fR [\fB\-b\ \fR\fB\fIbasedir\fR\fR] [\fB\-e\fR] [\fB\-E\ \fR\fB\fIModule\&.symvers\fR\fR] [\fB\-F\ \fR\fB\fISystem\&.map\fR\fR] [\fB\-n\fR] [\fB\-v\fR] [\fB\-A\fR] [\fB\-P\ \fR\fB\fIprefix\fR\fR] [\fB\-w\fR] [\fB\fIversion\fR\fR]
+.HP \w'\fBdepmod\fR\ 'u
+\fBdepmod\fR [\fB\-e\fR] [\fB\-E\ \fR\fB\fIModule\&.symvers\fR\fR] [\fB\-F\ \fR\fB\fISystem\&.map\fR\fR] [\fB\-n\fR] [\fB\-v\fR] [\fB\-P\ \fR\fB\fIprefix\fR\fR] [\fB\-w\fR] [\fB\fIversion\fR\fR] [\fB\fIfilename\fR\fR...]
+.SH "DESCRIPTION"
+.PP
+Linux kernel modules can provide services (called "symbols") for other modules to use (using one of the EXPORT_SYMBOL variants in the code)\&. If a second module uses this symbol, that second module clearly depends on the first module\&. These dependencies can get quite complex\&.
+.PP
+\fBdepmod\fR
+creates a list of module dependencies by reading each module under
+/lib/modules/\fIversion\fR
+and determining what symbols it exports and what symbols it needs\&. By default, this list is written to
+modules\&.dep, and a binary hashed version named
+modules\&.dep\&.bin, in the same directory\&. If filenames are given on the command line, only those modules are examined (which is rarely useful unless all modules are listed)\&.
+\fBdepmod\fR
+also creates a list of symbols provided by modules in the file named
+modules\&.symbols
+and its binary hashed version,
+modules\&.symbols\&.bin\&. Finally,
+\fBdepmod\fR
+will output a file named
+modules\&.devname
+if modules supply special device names (devname) that should be populated in /dev on boot (by a utility such as systemd\-tmpfiles)\&.
+.PP
+If a
+\fIversion\fR
+is provided, then that kernel version\*(Aqs module directory is used rather than the current kernel version (as returned by
+\fBuname \-r\fR)\&.
+.SH "OPTIONS"
+.PP
+\fB\-a\fR, \fB\-\-all\fR
+.RS 4
+Probe all modules\&. This option is enabled by default if no file names are given in the command\-line\&.
+.RE
+.PP
+\fB\-A\fR, \fB\-\-quick\fR
+.RS 4
+This option scans to see if any modules are newer than the
+modules\&.dep
+file before any work is done: if not, it silently exits rather than regenerating the files\&.
+.RE
+.PP
+\fB\-b \fR\fB\fIbasedir\fR\fR, \fB\-\-basedir \fR\fB\fIbasedir\fR\fR
+.RS 4
+If your modules are not currently in the (normal) directory
+/lib/modules/\fIversion\fR, but in a staging area, you can specify a
+\fIbasedir\fR
+which is prepended to the directory name\&. This
+\fIbasedir\fR
+is stripped from the resulting
+modules\&.dep
+file, so it is ready to be moved into the normal location\&. Use this option if you are a distribution vendor who needs to pre\-generate the meta\-data files rather than running depmod again later\&.
+.RE
+.PP
+\fB\-C\fR, \fB\-\-config \fR\fB\fIfile or directory\fR\fR
+.RS 4
+This option overrides the default configuration directory at
+/etc/depmod\&.d/\&.
+.RE
+.PP
+\fB\-e\fR, \fB\-\-errsyms\fR
+.RS 4
+When combined with the
+\fB\-F\fR
+option, this reports any symbols which a module needs which are not supplied by other modules or the kernel\&. Normally, any symbols not provided by modules are assumed to be provided by the kernel (which should be true in a perfect world), but this assumption can break especially when additionally updated third party drivers are not correctly installed or were built incorrectly\&.
+.RE
+.PP
+\fB\-E\fR, \fB\-\-symvers\fR
+.RS 4
+When combined with the
+\fB\-e\fR
+option, this reports any symbol versions supplied by modules that do not match with the symbol versions provided by the kernel in its
+Module\&.symvers\&. This option is mutually incompatible with
+\fB\-F\fR\&.
+.RE
+.PP
+\fB\-F\fR, \fB\-\-filesyms \fR\fB\fISystem\&.map\fR\fR
+.RS 4
+Supplied with the
+System\&.map
+produced when the kernel was built, this allows the
+\fB\-e\fR
+option to report unresolved symbols\&. This option is mutually incompatible with
+\fB\-E\fR\&.
+.RE
+.PP
+\fB\-h\fR, \fB\-\-help\fR
+.RS 4
+Print the help message and exit\&.
+.RE
+.PP
+\fB\-n\fR, \fB\-\-show\fR, \fB\-\-dry\-run\fR
+.RS 4
+This sends the resulting modules\&.dep and the various map files to standard output rather than writing them into the module directory\&.
+.RE
+.PP
+\fB\-P\fR
+.RS 4
+Some architectures prefix symbols with an extraneous character\&. This specifies a prefix character (for example \*(Aq_\*(Aq) to ignore\&.
+.RE
+.PP
+\fB\-v\fR, \fB\-\-verbose\fR
+.RS 4
+In verbose mode,
+\fBdepmod\fR
+will print (to stdout) all the symbols each module depends on and the module\*(Aqs file name which provides that symbol\&.
+.RE
+.PP
+\fB\-V\fR, \fB\-\-version\fR
+.RS 4
+Show version of program and exit\&. See below for caveats when run on older kernels\&.
+.RE
+.PP
+\fB\-w\fR
+.RS 4
+Warn on duplicate dependencies, aliases, symbol versions, etc\&.
+.RE
+.SH "COPYRIGHT"
+.PP
+This manual page originally Copyright 2002, Rusty Russell, IBM Corporation\&. Portions Copyright Jon Masters, and others\&.
+.SH "SEE ALSO"
+.PP
+\fBdepmod.d\fR(5),
+\fBmodprobe\fR(8),
+\fBmodules.dep\fR(5)
+.SH "AUTHORS"
+.PP
+\fBJon Masters\fR <\&jcm@jonmasters\&.org\&>
+.RS 4
+Developer
+.RE
+.PP
+\fBRobby Workman\fR <\&rworkman@slackware\&.com\&>
+.RS 4
+Developer
+.RE
+.PP
+\fBLucas De Marchi\fR <\&lucas\&.de\&.marchi@gmail\&.com\&>
+.RS 4
+Developer
+.RE