~ubuntu-branches/ubuntu/trusty/kmod/trusty

« back to all changes in this revision

Viewing changes to man/depmod.8

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2013-10-24 06:16:30 UTC
  • mfrom: (1.1.5)
  • Revision ID: package-import@ubuntu.com-20131024061630-o87ipf2zxqtpigls
Tags: 15-0ubuntu1
* New upstream release. (See Debian #716739)
* Drop patches included upstream: dot_kcmdline, bad_alias_assertion,
  blacklist_aliased.
* Drop check_builtin_kver, this would only apply to lucid and is otherwise
  unnecessary.
* Drop --disable-shared/--enable-static, this got dropped in this version
  and isn't necessary any more. /bin/kmod does not dynamically link to
  libkmod by default now.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
'\" t
2
2
.\"     Title: depmod
3
3
.\"    Author: Jon Masters <jcm@jonmasters.org>
4
 
.\" Generator: DocBook XSL Stylesheets v1.77.0 <http://docbook.sf.net/>
5
 
.\"      Date: 06/19/2012
 
4
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
 
5
.\"      Date: 08/22/2013
6
6
.\"    Manual: depmod
7
7
.\"    Source: kmod
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "DEPMOD" "8" "06/19/2012" "kmod" "depmod"
 
10
.TH "DEPMOD" "8" "08/22/2013" "kmod" "depmod"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * Define some portability stuff
13
13
.\" -----------------------------------------------------------------
38
38
.PP
39
39
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\&.
40
40
.PP
41
 
 
42
41
\fBdepmod\fR
43
42
creates a list of module dependencies by reading each module under
44
43
/lib/modules/\fIversion\fR
61
60
\fBuname \-r\fR)\&.
62
61
.SH "OPTIONS"
63
62
.PP
64
 
\fB\-a\fR \fB\-\-all\fR
 
63
\fB\-a\fR, \fB\-\-all\fR
65
64
.RS 4
66
65
Probe all modules\&. This option is enabled by default if no file names are given in the command\-line\&.
67
66
.RE
68
67
.PP
69
 
\fB\-A\fR \fB\-\-quick\fR
 
68
\fB\-A\fR, \fB\-\-quick\fR
70
69
.RS 4
71
70
This option scans to see if any modules are newer than the
72
71
modules\&.dep
73
72
file before any work is done: if not, it silently exits rather than regenerating the files\&.
74
73
.RE
75
74
.PP
76
 
\fB\-b \fR\fB\fIbasedir\fR\fR \fB\-\-basedir \fR\fB\fIbasedir\fR\fR
 
75
\fB\-b \fR\fB\fIbasedir\fR\fR, \fB\-\-basedir \fR\fB\fIbasedir\fR\fR
77
76
.RS 4
78
77
If your modules are not currently in the (normal) directory
79
78
/lib/modules/\fIversion\fR, but in a staging area, you can specify a
85
84
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\&.
86
85
.RE
87
86
.PP
88
 
\fB\-C\fR \fB\-\-config \fR\fB\fIfile or directory\fR\fR
 
87
\fB\-C\fR, \fB\-\-config \fR\fB\fIfile or directory\fR\fR
89
88
.RS 4
90
89
This option overrides the default configuration directory at
91
90
/etc/depmod\&.d/\&.
92
91
.RE
93
92
.PP
94
 
\fB\-e\fR \fB\-\-errsyms\fR
 
93
\fB\-e\fR, \fB\-\-errsyms\fR
95
94
.RS 4
96
95
When combined with the
97
96
\fB\-F\fR
98
97
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\&.
99
98
.RE
100
99
.PP
101
 
\fB\-E\fR \fB\-\-symvers\fR
 
100
\fB\-E\fR, \fB\-\-symvers\fR
102
101
.RS 4
103
102
When combined with the
104
103
\fB\-e\fR
107
106
\fB\-F\fR\&.
108
107
.RE
109
108
.PP
110
 
\fB\-F\fR \fB\-\-filesyms \fR\fB\fISystem\&.map\fR\fR
 
109
\fB\-F\fR, \fB\-\-filesyms \fR\fB\fISystem\&.map\fR\fR
111
110
.RS 4
112
111
Supplied with the
113
112
System\&.map
117
116
\fB\-E\fR\&.
118
117
.RE
119
118
.PP
120
 
\fB\-h\fR \fB\-\-help\fR
 
119
\fB\-h\fR, \fB\-\-help\fR
121
120
.RS 4
122
121
Print the help message and exit\&.
123
122
.RE
124
123
.PP
125
 
\fB\-n\fR \fB\-\-dry\-run\fR
 
124
\fB\-n\fR, \fB\-\-dry\-run\fR
126
125
.RS 4
127
126
This sends the resulting modules\&.dep and the various map files to standard output rather than writing them into the module directory\&.
128
127
.RE
132
131
Some architectures prefix symbols with an extraneous character\&. This specifies a prefix character (for example \*(Aq_\*(Aq) to ignore\&.
133
132
.RE
134
133
.PP
135
 
\fB\-v\fR \fB\-\-verbose\fR
 
134
\fB\-v\fR, \fB\-\-verbose\fR
136
135
.RS 4
137
136
In verbose mode,
138
137
\fBdepmod\fR
139
138
will print (to stdout) all the symbols each module depends on and the module\*(Aqs file name which provides that symbol\&.
140
139
.RE
141
140
.PP
142
 
\fB\-V\fR \fB\-\-version\fR
 
141
\fB\-V\fR, \fB\-\-version\fR
143
142
.RS 4
144
143
Show version of program and exit\&. See below for caveats when run on older kernels\&.
145
144
.RE
153
152
This manual page originally Copyright 2002, Rusty Russell, IBM Corporation\&. Portions Copyright Jon Masters, and others\&.
154
153
.SH "SEE ALSO"
155
154
.PP
156
 
 
157
155
\fBdepmod.d\fR(5),
158
156
\fBmodprobe\fR(8),
159
157
\fBmodules.dep\fR(5)