MODPROBE

名前

書式

このマニュアルについて

オプション

-a, --all

最初にロードに成功した後に停止するのではなく、 マッチしたモジュールをすべてロードする。

-c, --showconfig

現在用いられている設定を表示する。

-C, --config config

設定ファイルを /etc/modules.conf ではなく config にする。 (/etc/modules.conf はなくてもよい)。 環境変数 MODULECONF でも設定ファイルを /etc/modules.conf (あるいは推奨しないが /etc/conf.modules) から変更できる。

環境変数

UNAME_MACHINE をセットすると、modutils は uname() システムコールの machine フィールドの 代わりにこの変数の値を用いる。 これは主に 32 ビットユーザー空間で 64 ビットモジュールをコンパイルする (またはその逆)場合に用いる。 現在の modutils はモジュールに対する完全なクロスビルドモードに対応しておらず、 ホストアーキテクチャの 32 ビット版と 64 ビット版を選択できるだけである。

-d, --debug

モジュールのスタックの内部表現に関する情報を表示する。

-h, --help

オプションの一覧を表示して直ちに終了する。

-k, --autoclean

ロード済みのモジュールに "autoclean" を設定する。 カーネルが modprobe に足りない機能をモジュールとして提供するよう依頼するときに用いられる。 -k オプションを指定すると、自動的に -q オプションも有効になる。 これらのオプションは自動的に insmod に送られる。

-l, --list

マッチするモジュールをリストする。

-n, --show

実際には動作を行わず、何が行われるかを表示する。

-q, --quiet

insmod がモジュールのインストールに失敗しても報告しない。 黙って他の可能性を試しながら通常のように継続する。 このオプションは自動的に insmod に送られる。

-r, --remove

コマンドラインでモジュールが指定されればモジュール (のスタック) を削除する。 されなければ autoclean を実行する。

-s, --syslog

標準エラー出力にではなく syslog を経由してレポートする。 このオプションは自動的に insmod に送られる。

-t moduletype; --type moduletype

指定したタイプのモジュールだけを扱う。 modprobe は、ディレクトリパスに "/moduletype/" をこの形で含むモジュールだけしか対象にしない。 moduletype にはディレクトリを複数の階層で指定しても良い。例えば "-t drivers/net" とすれば、 xxx/drivers/net/ およびそのサブディレクトリにあるモジュールだけを 対象にする。

-v, --verbose

すべてのコマンドを、実行される通りに表示する。

-V, --version

modprobe のバージョンを表示する。

注意:

モジュール名にはパス ('/') や末尾の '.o' を含めてはならない。 例えば、 'slip' は modprobe に対する正当なモジュール名だが、 これはコマンドラインと設定ファイルの両方に適用されるルールである。

説明

modprobe は Makefile に似た形式で依存関係を記述したファイルを用いる。 これは depmod によって作成されるもので、 あらかじめ定められたディレクトリツリーに置かれたモジュールのセットから、 関連するファイル (群) を自動的にロードするためのものである。

modprobeはモジュールのセット (単一のモジュールであることも、 依存関係にあるモジュールのスタックであることもある) のロードに用いられる。 また、特定のタグがつけられたすべてのモジュールをロードするのにも用いられる。

modprobeはモジュールスタックに必要とされるベースモジュールを、 依存関係を記述したファイル modules.dep の記述にしたがって すべてロードする。これらのモジュールのどれかをロードできないと、 現在のセッションでロードされたモジュールスタックの全体が 自動的にアンロードされることになる。

modprobeがモジュールをロードするやりかたは 2 種類ある。 ひとつめ (プローブモード) は、 (pattern で定義された) リストからモジュールをロードしようとする。 モジュールがひとつロードできると、modprobeはただちに停止する。 これはイーサネットドライバのリストから モジュールをひとつロードするような場合に利用できるだろう。

もうひとつの方では、modprobeはリストのすべてのモジュールを ロードする。以下の「例」の記述を参照のこと。

-rオプションをつけると、 modprobe は自動的にモジュールのスタックを アンロードする("rmmod -r"と同様)。 "modprobe -r"とだけすると、 使われていない autoload されたモジュールを削除すると同時に、 設定ファイル /etc/modules.conf の記述にしたがって 削除の前処理・後処理用のコマンドを実行する。

-l オプションと-tオプションを同時に指定すると、 利用可能なすべてのモジュールのうち、特定のタイプのものだけが表示される。

-cオプションを指定すると、 現在用いられている設定が表示される (デフォルト + 設定ファイル)。  

設定

このファイルに記述できる内容の詳細や、depmodと modprobeが用いるデフォルトの設定に関しては modules.conf(5)を参照のこと。

モジュールがカーネルによって "autoload" された場合は、 削除の前処理・後処理のコマンドは実行されないことに注意。 将来サポートされる予定の「永続型モジュール保存 (persistent module storage)」 に期待して欲しい。

削除の前後処理の機能を用いたい場合は、 kerneld の autoload を使わないようにして、 以下のような行を crontab に書きこむ必要がある (これは kmod システムによっても用いられる)。 以下では autoclean を 2 分おきに行っている。

 */2 * * * * test -f /proc/modules && /sbin/modprobe -r

動作ルール

新しい Linux をインストールしたときは、モジュールをそのカーネルのリリース (とバージョン) に対応したディレクトリに移動すべきである。 そしてこのディレクトリから「デフォルト」のディレクトリに シンボリックリンクをはるようにする。

新しいカーネルをコンパイルして"make modules_install" コマンドを実行すると、新しいディレクトリは作成するが、 「デフォルト」のリンクは変更しない。

カーネルの配布に含まれないモジュールを入手したら、 それは /lib/modules 以下のバージョンには依存しないディレクトリに 配置するとよい。

以上がデフォルトの動作であるが、これは /etc/modules.conf の記述によって変更できる。  

例

modprobe -t net

"net" という名前のディレクトリにあるモジュールのどれかひとつをロードする。 どれかのモジュールのロードに成功するまで、各モジュールがひとつづつ試みられる。

modprobe -a -t boot

"boot"という名前のディレクトリにあるすべてのモジュールがロードされる。

modprobe slip

これを実行すると、 s1hc.o というモジュールがまだロードされていなければロードしようとする。 slip モジュールには s1hc モジュールの機能が必要だからである。 この依存関係は、depmodによって (これ以前に) 自動的に生成された modules.dep というファイルに記述されている。

modprobe -r slip

slip モジュールをアンロードする。 s1hc モジュールも自動的にアンロードする (ただし ppp のような他のモジュールによって利用されていない場合)。

ファイル

/etc/modules.conf(/etc/conf.modulesも使えるが推奨しない)
/lib/modules/*/modules.dep,
/lib/modules/*

関連項目

セーフモード

modprobe がカーネルから起動された場合、実効 UID は実 UID と異なるかもしれない。 これはカーネルが 2.4.0-test11 以上の時に真となる。 理想的な世界では modprobe は カーネルが正しいパラメータだけを modprobe に渡すと信用することが出来た。 しかし高レベルカーネルコードは未検証のパラメータを直接ユーザーから modprobe に渡すので、 少なくとも一つのローカル root exploit が発生する。 それで、もはや modprobe はカーネルからの入力を信用しない。

modprobe は環境変数が以下の文字列しか含まない場合、 自動的にセーフモードとなる。

 HOME=/
 TERM=linux
 PATH=/sbin:/usr/sbin:/bin:/usr/bin

ログ記録コマンド

必要なユーティリティ

注意

バグ

著者

Index

名前

書式

このマニュアルについて

オプション

説明

設定

動作ルール

例

ファイル

関連項目

セーフモード

ログ記録コマンド

必要なユーティリティ

注意

バグ

著者