1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
.\" 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>.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Japanese Version Copyright (C) 2005 Suzuki Takashi
.\" all rights reserved.
.\" Translated Sun Jul 10 00:42:36 JST 2005
.\" by Suzuki Takashi <JM@linux.or.jp>.
.\"
.TH MODPROBE 8 "08 May 2005" "" ""
.SH 名前
modprobe \- Linux カーネルにモジュールを追加したり削除したりするプログラム
.SH 書式
\fBmodprobe\fP [ \fB\-v\fP ] [ \fB\-V\fP ] [ \fB\-C \fP\fIconfig\-file\fP ] [ \fB\-n\fP ] [ \fB\-i\fP ]
[ \fB\-q\fP ] [ \fB\-o \fP\fImodulename\fP ] [ \fImodulename\fP ] [ \fImodule parameters\fP\fI
\&...\fP ]
\fBmodprobe\fP [ \fB\-r\fP ] [ \fB\-v\fP ] [ \fB\-n\fP ] [ \fB\-i\fP ] [ \fImodulename\fP\fI ...\fP ]
\fBmodprobe\fP [ \fB\-l\fP ] [ \fB\-t \fP\fIdirname\fP ] [ \fIwildcard\fP ]
\fBmodprobe\fP [ \fB\-c\fP ]
.SH このマニュアルについて
.PP
これは、module-init-tools
パッケージに所属するユーティリティのマニュアルです。module-init-tools
は、現在では kmod パッケージに引き継がれているので、kmod
パッケージの同名のユーティリティのマニュアルをご覧になることをお勧めします。
(2022/12/02, Linux JM Project)
.SH 説明
.PP
\fBmodprobe\fP は Linux カーネルに賢くモジュールを追加したり削除したりする。 利便性のため、モジュール名において _ と \-
の違いはないことに注意。 \fBmodprobe\fP は、 全てのモジュールと他のファイルを モジュールディレクトリ
\fI/lib/modules/`uname \-r`\fP から参照する。 このほかに、もしあれば \fI/etc/modprobe.conf\fP 設定ファイルと
\fI/etc/modprobe.d\fP ディレクトリを参照する (\fBmodprobe.conf\fP(5) を参照) 。
.PP
このバージョンの \fBmodprobe\fP は、 自身ではモジュールに対して何もしないことに注意。
シンボルの解決やパラメータの解釈といった処理はカーネルの中で行なわれる。 そのため、モジュールの不具合はカーネルのメッセージとして報告されることもある。
\fBdmesg\fP(8) を参照。
.PP
\fBmodprobe\fP を実行するときは、 \fBdepmod\fP (\fBdepmod\fP(8) を参照) で生成された \fImodules.dep\fP
が最新の状態になっていなければならない。 このファイルには、 それぞれのモジュールが (もしあれば) 他のどのモジュールを
必要としているかが列挙されていて、 \fBmodprobe\fP はこれを使って依存するモジュールを自動的に追加したり削除したりする。
(\fBmodules.dep\fP(5) を参照) 。
.PP
\fImodulename\fP の後ろに指定された引数は、 カーネルに渡される (設定ファイルに列挙されたオプションに追加される) 。
.SH オプション
.TP
\fB\-v \-\-verbose \fP
プログラムが何をしているかに関するメッセージを表示する。 通常、 \fBmodprobe\fP は何かまずいことが起こった場合に限って メッセージを表示する。
このオプションは \fBinstall\fP および \fBremove\fP コマンドを通じて、 MODPROBE_OPTIONS 環境変数にある
\fBmodprobe\fP の他のコマンドに渡される。
.TP
\fB\-C \-\-config \fP
このオプションはデフォルトの設定ファイル (\fI/etc/modprobe.conf\fP や \fI/etc/modprobe.d/\fP) を無視する。
このオプションは \fBinstall\fP および \fBremove\fP コマンドを通じて、 MODPROBE_OPTIONS 環境変数にある
\fBmodprobe\fP の他のコマンドに渡される。
.TP
\fB\-c \-\-showconfig \fP
設定ファイルの内容を表示し、終了する。
.TP
\fB\-n \-\-dry\-run \fP
このオプションは実際にモジュールを登録したり削除したりする (あるいは install や remove コマンドを実行する) 以外の、
全ての処理を行なう。 \fB\-v\fP と組み合わせて使うと、不具合をデバッグするのに便利である。
.TP
\fB\-i \-\-ignore\-install \-\-ignore\-remove \fP
このオプションを使うと、 \fBmodprobe\fP は コマンドラインで指定されたモジュールに対する 設定ファイル中の \fBinstall\fP および
\fBremove\fP コマンドを (もしあれば) 無視する (ただし、依存するモジュールは設定ファイル中のコマンドに従う) 。
\fBmodprobe.conf\fP(5) を参照。
.TP
\fB\-q \-\-quiet \fP
通常、 \fBmodprobe\fP は 見つからない (かつエイリアスでもないか \fBinstall\fP/\fBremove\fP コマンドでもない) モジュールを
削除したり登録したりしようとすると、エラーを通知する。 このフラグを使うと、 \fBmodprobe\fP は でたらめな名前は単に無視する
(カーネルはこの名前を使って 存在するかもしれないモジュールを日和見的にプローブする) 。
.TP
\fB\-r \-\-remove \fP
このオプションで \fBmodprobe\fP は モジュールを削除する。 このオプションがない場合は登録する。 依存するモジュールも使われていない場合、
\fBmodprobe\fP はそれらも削除しようとする。 登録とは異なり、複数のモジュールをコマンドラインで指定することができる
(モジュールを削除するときにモジュールパラメータを指定するのは意味がない) 。
通常は、モジュールを削除する理由などないが、 不具合のあるモジュールには必要である。 使っているカーネルがモジュールの削除に対応していないかもしれない。
.TP
\fB\-V \-\-version \fP
プログラムのバージョンを表示し、終了する。
古いカーネルで実行する場合の注意については下を参照。
.TP
\fB\-f \-\-force \fP
モジュールからバージョンに関する情報を取り除こうとする (そうしないとロードできないモジュールに対して) 。 このオプションは
\fB\-\-force\-vermagic\fP と \fB\-\-force\-modversion\fP オプションの 両方を使ったのと同じである。 当然のことながら、
これらのチェックはあなたを守るために存在するのであって、 このオプションを使うのは危険である。
このオプションは登録されるすべてのモジュールに適用される。 つまり、 コマンドラインで指定したモジュール (またはエイリアス) だけでなく、
依存するモジュールにも有効である。
.TP
\fB\-\-force\-vermagic \fP
どのモジュールにも、 カーネルやコンパイラのバージョンといった、 重要な情報を持つ短い文字列がある。 モジュールがロードに失敗し、カーネルが
"version magic" が 一致しないと文句を言う場合、このオプションを使って "version magic" を削除することができる。
当然のことながら、 これらのチェックはあなたを守るために存在するのであって、 このオプションを使うのは危険である。
このオプションは登録されるすべてのモジュールに適用される。 つまり、 コマンドラインで指定したモジュール (またはエイリアス) だけでなく、
依存するモジュールにも有効である。
.TP
\fB\-\-force\-modversion \fP
モジュールが CONFIG_MODVERSIONS をセットして コンパイルされている場合、 モジュールが使っている (または提供する)
ひとつひとつのインタフェースのバージョンを記したセクションが生成される。 モジュールがロードに失敗し、
カーネルがインタフェースのバージョンの一致しないものがあると文句を言う場合、 "\-\-force\-modversion"
を使ってバージョン情報をばっさり削除することができる。 当然のことながら、 これらのチェックはあなたを守るために存在するのであって、
このオプションを使うのは危険である。
このオプションは登録されるすべてのモジュールに適用される。 つまり、 コマンドラインで指定したモジュール (またはエイリアス) だけでなく、
依存するモジュールにも有効である。
.TP
\fB\-l \-\-list \fP
指定されたワイルドカード (あるいはワイルドカードが指定されない場合 "*") に一致する すべてのモジュールを列挙する。
このオプションは下位互換性のために用意されている。 もっと柔軟性のある代替品として、 \fBfind\fP(1) や \fBbasename\fP(1) を参照。
.TP
\fB\-a \-\-all \fP
指定されたワイルドカードに一致する全てのモジュールを登録する。 このオプションは下位互換性のために用意されている。 もっと柔軟性のある代替品として、
\fBfind\fP(1) や \fBbasename\fP(1) を参照。
.TP
\fB\-t \-\-type \fP
\fB\-l\fP を 指定された \fIdirname\fP に一致するディレクトリにあるモジュールに限定する。 このオプションは下位互換性のために用意されている。
もっと柔軟性のある代替品として、 \fBfind\fP(1) や \fBbasename\fP(1) を参照。
.TP
\fB\-s \-\-syslog \fP
このオプションを使うと、 すべてのエラーメッセージが syslog の仕組みで (LOG_NOTICE というレベルの LOG_DAEMON として)
通知されるようになる。 このオプションがない場合は標準エラーに出力される。 このオプションは標準エラーが使えない場合、自動的に有効になる。
このオプションは \fBinstall\fP および \fBremove\fP コマンドを通じて、 MODPROBE_OPTIONS 環境変数にある
\fBmodprobe\fP の他のコマンドに渡される。
.TP
\fB\-\-set\-version \fP
カーネルバージョンを設定する。 このオプションがない場合、 カーネルバージョン (モジュールを検索する場所を表す) を 決定するために
\fBuname\fP(2) が使われる。 このオプションは下位互換性のチェックも無効にする (そのため \fBmodprobe.old\fP(8)
は一切実行されない) 。
.TP
\fB\-\-show\-depends \fP
モジュール (またはエイリアス) の依存関係を列挙する。 モジュール自身も含まれる。 このオプションは モジュールのファイル名の集合 (空の場合もある)
を生成する。 1 行に 1 個のモジュールが表示され、先頭に "insmod" が付く。 install コマンドが適用される場合、先頭に
"install" が付く。 install コマンドは一切実行しない。 \fBmodinfo\fP(8) を使えば
モジュール自身からモジュールの依存関係を取り出すことができるが、 エイリアスや install コマンドについては全く分からないことに注意。
.TP
\fB\-o \-\-name \fP
このオプションはカーネルに登録されるモジュールの名前を変更しようとする。 テスト用のモジュールには複数回登録することのできるものがあり便利だが、
カーネルは同じ名前のモジュールが 2 個あると拒否する。 通常、モジュールを複数回登録する必要はないはずである。
なぜならモジュールに対応していない場合に役に立たないからである。
.TP
\fB\-\-first\-time \fP
通常、 \fBmodprobe\fP は すでに存在するモジュールを登録しようとした場合や 存在しないモジュールを削除しようとした場合にも 成功する
(そして何もしない) 。 この振る舞いは modutils と下位互換性があり、 単純なスクリプトにとっては望ましい。
しかし、もっと複雑なスクリプトでは \fBmodprobe\fP が実際に何かをしたかどうかを知りたくなることも多い。 このオプションは上のような場合、
modprobe が失敗するようにする。
.SH 下位互換性
.PP
このバージョンの \fBmodprobe\fP は、 カーネル \fB2.5.48\fP およびそれ以降のためのものである。
古い形式のモジュールに対応したカーネルを検出すると (そのためのほとんどの処理はユーザ空間で行なわれる) 、 その場で \fBmodprobe.old\fP
を実行しようとする。 そのため、ユーザは全く意識しなくてよい。
.SH 環境変数
.PP
MODPROBE_OPTIONS 環境変数も \fBmodprobe\fP に引数を渡すのに使うことができる。
.SH 著作権
.PP
このマニュアルページの著作権表示は Copyright 2002, Rusty Russell, IBM Corporation.
.SH 関連項目
.PP
\fBmodprobe.conf\fP(5), \fBlsmod\fP(8), \fBmodprobe.old\fP(8)
|
