Provided by: manpages-ja_0.5.0.0.20210215+dfsg-1_all 
名前
modprobe - Linux カーネルにモジュールを追加したり削除したりするプログラム
書式
modprobe [ -v ] [ -V ] [ -C config-file ] [ -n ] [ -i ] [ -q ] [ -o modulename ] [
modulename ] [ module parameters ... ]
modprobe [ -r ] [ -v ] [ -n ] [ -i ] [ modulename ... ]
modprobe [ -l ] [ -t dirname ] [ wildcard ]
modprobe [ -c ]
説明
modprobe は Linux カーネルに賢くモジュールを追加したり削除したりする。 利便性のため、モ
ジュール名において _ と - の違いはないことに注意。 modprobe は、 全てのモジュールと他の
ファイルを モジュールディレクトリ /lib/modules/`uname -r` から参照する。 このほかに、もし
あれば /etc/modprobe.conf 設定ファイルと /etc/modprobe.d ディレクトリを参照する
(modprobe.conf(5) を参照) 。
このバージョンの modprobe は、 自身ではモジュールに対して何もしないことに注意。 シンボルの
解決やパラメータの解釈といった処理はカーネルの中で行なわれる。 そのため、モジュールの不具
合はカーネルのメッセージとして報告されることもある。 dmesg(8) を参照。
modprobe を実行するときは、 depmod (depmod(8) を参照) で生成された modules.dep が最新の状
態になっていなければならない。 このファイルには、 それぞれのモジュールが (もしあれば) 他の
どのモジュールを 必要としているかが列挙されていて、 modprobe はこれを使って依存するモ
ジュールを自動的に追加したり削除したりする。 (modules.dep(5) を参照) 。
modulename の後ろに指定された引数は、 カーネルに渡される (設定ファイルに列挙されたオプショ
ンに追加される) 。
オプション
-v --verbose
プログラムが何をしているかに関するメッセージを表示する。 通常、 modprobe は何かまず
いことが起こった場合に限って メッセージを表示する。
このオプションは install および remove コマンドを通じて、 MODPROBE_OPTIONS 環境変数
にある modprobe の他のコマンドに渡される。
-C --config
このオプションはデフォルトの設定ファイル (/etc/modprobe.conf や /etc/modprobe.d/)
を無視する。
このオプションは install および remove コマンドを通じて、 MODPROBE_OPTIONS 環境変数
にある modprobe の他のコマンドに渡される。
-c --showconfig
設定ファイルの内容を表示し、終了する。
-n --dry-run
このオプションは実際にモジュールを登録したり削除したりする (あるいは install や
remove コマンドを実行する) 以外の、 全ての処理を行なう。 -v と組み合わせて使う
と、不具合をデバッグするのに便利である。
-i --ignore-install --ignore-remove
このオプションを使うと、 modprobe は コマンドラインで指定されたモジュールに対する
設定ファイル中の install および remove コマンドを (もしあれば) 無視する (ただし、依
存するモジュールは設定ファイル中のコマンドに従う) 。 modprobe.conf(5) を参照。
-q --quiet
通常、 modprobe は 見つからない (かつエイリアスでもないか install/remove コマンドで
もない) モジュールを 削除したり登録したりしようとすると、エラーを通知する。 このフ
ラグを使うと、 modprobe は でたらめな名前は単に無視する (カーネルはこの名前を使って
存在するかもしれないモジュールを日和見的にプローブする) 。
-r --remove
このオプションで modprobe は モジュールを削除する。 このオプションがない場合は登録
する。 依存するモジュールも使われていない場合、 modprobe はそれらも削除しようとす
る。 登録とは異なり、複数のモジュールをコマンドラインで指定することができる (モ
ジュールを削除するときにモジュールパラメータを指定するのは意味がない) 。
通常は、モジュールを削除する理由などないが、 不具合のあるモジュールには必要である。
使っているカーネルがモジュールの削除に対応していないかもしれない。
-V --version
プログラムのバージョンを表示し、終了する。 古いカーネルで実行する場合の注意について
は下を参照。
-f --force
モジュールからバージョンに関する情報を取り除こうとする (そうしないとロードできない
モジュールに対して) 。 このオプションは --force-vermagic と --force-modversion オプ
ションの 両方を使ったのと同じである。 当然のことながら、 これらのチェックはあなたを
守るために存在するのであって、 このオプションを使うのは危険である。
このオプションは登録されるすべてのモジュールに適用される。 つまり、 コマンドライン
で指定したモジュール (またはエイリアス) だけでなく、 依存するモジュールにも有効であ
る。
--force-vermagic
どのモジュールにも、 カーネルやコンパイラのバージョンといった、 重要な情報を持つ短
い文字列がある。 モジュールがロードに失敗し、カーネルが "version magic" が 一致しな
いと文句を言う場合、このオプションを使って "version magic" を削除することができる。
当然のことながら、 これらのチェックはあなたを守るために存在するのであって、 このオ
プションを使うのは危険である。
このオプションは登録されるすべてのモジュールに適用される。 つまり、 コマンドライン
で指定したモジュール (またはエイリアス) だけでなく、 依存するモジュールにも有効であ
る。
--force-modversion
モジュールが CONFIG_MODVERSIONS をセットして コンパイルされている場合、 モジュール
が使っている (または提供する) ひとつひとつのインタフェースのバージョンを記したセク
ションが生成される。 モジュールがロードに失敗し、 カーネルがインタフェースのバー
ジョンの一致しないものがあると文句を言う場合、 "--force-modversion" を使ってバー
ジョン情報をばっさり削除することができる。 当然のことながら、 これらのチェックはあ
なたを守るために存在するのであって、 このオプションを使うのは危険である。
このオプションは登録されるすべてのモジュールに適用される。 つまり、 コマンドライン
で指定したモジュール (またはエイリアス) だけでなく、 依存するモジュールにも有効であ
る。
-l --list
指定されたワイルドカード (あるいはワイルドカードが指定されない場合 "*") に一致する
すべてのモジュールを列挙する。 このオプションは下位互換性のために用意されている。
もっと柔軟性のある代替品として、 find(1) や basename(1) を参照。
-a --all
指定されたワイルドカードに一致する全てのモジュールを登録する。 このオプションは下位
互換性のために用意されている。 もっと柔軟性のある代替品として、 find(1) や
basename(1) を参照。
-t --type
-l を 指定された dirname に一致するディレクトリにあるモジュールに限定する。 このオ
プションは下位互換性のために用意されている。 もっと柔軟性のある代替品として、
find(1) や basename(1) を参照。
-s --syslog
このオプションを使うと、 すべてのエラーメッセージが syslog の仕組みで (LOG_NOTICE
というレベルの LOG_DAEMON として) 通知されるようになる。 このオプションがない場合は
標準エラーに出力される。 このオプションは標準エラーが使えない場合、自動的に有効にな
る。
このオプションは install および remove コマンドを通じて、 MODPROBE_OPTIONS 環境変数
にある modprobe の他のコマンドに渡される。
--set-version
カーネルバージョンを設定する。 このオプションがない場合、 カーネルバージョン (モ
ジュールを検索する場所を表す) を 決定するために uname(2) が使われる。 このオプショ
ンは下位互換性のチェックも無効にする (そのため modprobe.old(8) は一切実行されない)
。
--show-depends
モジュール (またはエイリアス) の依存関係を列挙する。 モジュール自身も含まれる。 こ
のオプションは モジュールのファイル名の集合 (空の場合もある) を生成する。 1 行に 1
個のモジュールが表示され、先頭に "insmod" が付く。 install コマンドが適用される場
合、先頭に "install" が付く。 install コマンドは一切実行しない。 modinfo(8) を使え
ば モジュール自身からモジュールの依存関係を取り出すことができるが、 エイリアスや
install コマンドについては全く分からないことに注意。
-o --name
このオプションはカーネルに登録されるモジュールの名前を変更しようとする。 テスト用の
モジュールには複数回登録することのできるものがあり便利だが、 カーネルは同じ名前のモ
ジュールが 2 個あると拒否する。 通常、モジュールを複数回登録する必要はないはずであ
る。 なぜならモジュールに対応していない場合に役に立たないからである。
--first-time
通常、 modprobe は すでに存在するモジュールを登録しようとした場合や 存在しないモ
ジュールを削除しようとした場合にも 成功する (そして何もしない) 。 この振る舞いは
modutils と下位互換性があり、 単純なスクリプトにとっては望ましい。 しかし、もっと複
雑なスクリプトでは modprobe が実際に何かをしたかどうかを知りたくなることも多い。 こ
のオプションは上のような場合、 modprobe が失敗するようにする。
下位互換性
このバージョンの modprobe は、 カーネル 2.5.48 およびそれ以降のためのものである。 古い形式
のモジュールに対応したカーネルを検出すると (そのためのほとんどの処理はユーザ空間で行なわれ
る) 、 その場で modprobe.old を実行しようとする。 そのため、ユーザは全く意識しなくてよい。
環境変数
MODPROBE_OPTIONS 環境変数も modprobe に引数を渡すのに使うことができる。
著作権
このマニュアルページの著作権表示は Copyright 2002, Rusty Russell, IBM Corporation.
関連項目
modprobe.conf(5), lsmod(8), modprobe.old(8)
08 May 2005 MODPROBE(8)