オプション

-f --force

実行中のカーネルのバージョンと、モジュールに組み込まれているカーネルの対象バージョンが異なっても、モジュールのロードを試みる。これはカーネルバージョンチェックだけを無効にし、シンボル名チェックには何の影響も与えない。モジュールのシンボル名がカーネルのものと一致しない場合、 insmod に強制的にモジュールをロードさせる方法はない。

-h --help

ヘルプ文章を表示する。

-k --autoclean

モジュールの auto-clean フラグを設定する。このフラグは kerneld(8) が使用し、一定期間(普通は 1 分)使われなかったモジュールを削除する。

-L --lock

同じモジュールを同時にロードすることを防ぐために、 flock(2) を用いる。

-m --map

ロード時のメモリマップを標準出力に出力する。これにより、カーネルパニックの際のモジュールのデバッグが容易になる。より詳細なデバッグを可能にする。デフォルトでは ksymoops シンボルを定義する。このオプションは-X/-x オプションとは独立である。

 

ksymoops シンボルは、各ローダブルモジュールごとに、約 260 バイトを余分に必要とする。カーネル空間がキツキツで、 ksyms を最小にしたいような場合を除き、デフォルトのままにして詳しい Oops デバッグを有効にするほうが良い。

-o module_name --name=module_name

モジュールに明示的に名前をつける。通常はロードするオブジェクトファイルの basename に基づいた名前が用いられる。

-O blob_name --blob=blob_name

バイナリオブジェクトを blob_name のファイル名で保存する。このファイルはカーネルにロードされ、セクション操作と再配置が行われた後の状態を正確に表しているバイナリ blob (ELF ヘッダなし)である。オブジェクトのマッピング情報を得るためには -m オプションが推奨される。

-P prefix --prefix=prefix

このオプションは SMP カーネルや bigmem カーネル向けの、バージョン付きモジュールを使うときに利用できる。これらのモジュールには、シンボル名に余分な prefix がつくからである。カーネルがシンボルバージョンつきでビルドされると、 insmod は自動的に prefix を "get_module_symbol"か "inter_module_get"の定義から取得する (モジュールをサポートする全てのカーネルにはこのどちらかが存在しなければならない)。カーネルがシンボルバージョンを持たず、しかしモジュールがシンボルバージョン付きでビルドされた場合は、ユーザーは-P を指定する必要がある。

-e persist_name --persist=persist_name

モジュールの永続データを保存するファイル名を指定する。これはモジュールがロードされた時に読み込まれ、モジュールの実体がアンロードされた時に書き込まれる。モジュールに永続データがない場合はこのオプションは暗黙に無視される。永続データは insmod にこのオプションが指定された場合にのみ読み込まれる。デフォルトでは insmod は永続データを処理しない。省略記法として -e "" (空文字列) が指定されると、 insmod は persistdir の値( modules.conf(5) 参照)の後ろに、モジュールのファイル名から末尾の´.gz', ´.o' and ´.mod' を取ったもの(そのモジュールが見つかったモジュール検索パスからの相対パス)が指定されたものと解釈する。 persistdir= (つまり persistdir に空フィールド)が指定されていると、省略記法は暗黙に無視される。

モジュールのパラメータ

一部のモジュールではロード時にパラメータを指定して、動作を変えることができる。このようなパラメータは I/O ポートや IRQ 番号であることが多い。これらの数値はマシンごとに異なり、しかもハードウェアから求めることができないからである。

2.0 系列のカーネル用に構築したモジュールでは、全ての整数と文字ポインタシンボルはパラメータとして扱われ、従ってその内容は変更されうる。 2.1 系列のカーネルからは、特定の値だけが変更されるように、シンボルにはパラメータかどうかの印が明示的に付けられる。また、ロード時に与えられた値をチェックするために、追加の型情報が与えられる。

整数の場合には、全ての値は 10 進値、8 進値, 16 進値で C 言語と同じように指定できる (17, 021, 0x11 等)。配列の要素は、値をコンマで区切って並べることにより指定する。値を省略することにより、要素を飛ばすことができる。

2.0 系列のモジュールでは、数字で始まらない値は文字列と解釈される。2.1 以降では、値を文字列と解釈するかどうかはパラメータの型情報によって判断する。値が二重引用符( ")で始まる場合は、エスケープシーケンスも含めて全て C 言語と同じように文字列として解釈される。シェルのプロンプトで使う場合にはクォート自体もシェルが解釈するため、保護しなければならない点に注意すること。

GPL ライセンスのモジュールとシンボル

カーネル 2.4.10 からモジュールはライセンス文を含むことになり、 MODULE_LICENSE() によって定義されることになった。いくつかの文字列は GPL 互換であると認識される。それ以外のライセンス文字列だったり、そもそもライセンスがない場合は、そのモジュールはプロプラエタリなものとして扱われる。 GPL 互換とされるライセンス文字列については include/linux/module.h を参照すること。

カーネルが /proc/sys/kernel/tainted flag をサポートする場合は、 insmod は GPL ライセンスを持たないモジュールのロード時に、 tainted (汚染) フラグを '1' と OR する。カーネルが tainting をサポートしていると、ライセンスのないモジュールがロードされる際には警告が発せられる。警告は GPL 互換でない MODULE_LICENSE() を持つモジュールに対しては (tainting をサポートしていない古いカーネルでも)、常に警告が発せられる。これによって、新しいモジュールが古いカーネルで利用されるときも、警告は最小限になる。

insmod -f (強制) モードでは、tainting をサポートするカーネルなら tainted フラグが '2' と OR され、常に警告が発せられる。

カーネル開発者の中には、彼らのコードがエクスポートするシンボルは、 GPL 互換なライセンスのモジュールからしか利用できないようにしたい、と考えている人たちがいる。これらのシンボルは EXPOET_SYMBOL の代わりに EXPORT_SYMBOL_GPL でエクスポートされる。カーネルや、別のモジュールによってエクスポートされた GPL オンリーのシンボルは、GPL 互換なライセンスのモジュールからしか見えない。これらのシンボルには、 /proc/ksyms において 'GPLONLY_' というプレフィックスが付く。 insmod は GPL ライセンスのモジュールをロードするときは、シンボルの 'GPLONLY_' プレフィックスを無視し、通常のシンボル名の部分だけを参照する。 GPL オンリーのシンボルは GPL 互換なライセンスを持たないモジュールに対しては利用可能とならない。ライセンスを全く持たないモジュールに対しても同様である。

KSYMOOPS 支援

モジュール利用時のカーネル Oops のデバッグを支援するため、 insmod はデフォルトではいくつかのシンボルを ksyms に追加する ( -Y オプションの説明を見よ)。これらのシンボルの名前は __insmod_ modulename _ で始まる。 modulename はシンボルを他と重ならないようにするために必要である。同じオブジェクトを、別のモジュール名で複数回ロードするのは許されている。現在定義されているシンボルは
__insmod_ modulename_O objectfile_M mtime_V version
objectfile は、オブジェクトのロード元のファイルの名前である。これによって ksymoops がコードを正しいオブジェクトにマッチさせることが可能となる。 mtime はそのファイルの最終修正タイムスタンプを 16 進で表したものである。 stat に失敗すると 0 になる。 version はモジュールのコンパイル時に指定されたカーネルのバージョンで、バージョンが取得できなければ-1 となる。シンボル _O はモジュールヘッダと同じスタートアドレスになる。
__insmod_ modulename_S sectionname_L length
このシンボルは指定された ELF セクションの先頭に現れる。現在は .text, .rodata, .data, .bss である。これが現れるのは、セクションの長さが 0 以上の場合だけである。 sectionname は ELF セクションの名前、 length は各セクションの長さの 10 進表記である。これらのシンボルにより、 ksymoops はシンボルが使えない場合でもアドレスをセクションにマップできるようになる。
__insmod_ modulename_P persistent_filename
モジュールが永続データとしてマークされたパラメータを持ち、永続データを保存するファイル名が有効な場合 (上述の -e 参照) にのみ、insmod によって作成される。

モジュールにおけるカーネル Oops のデバッグにおける別の問題として、 /proc/ksyms と /proc/modules の内容が Oops とログファイル処理の間で変わってしまう可能性がある。この問題の処理を助けるため、 /var/log/ksymoops があると、insmod と rmmod は自動的に /proc/ksyms と /proc/modules を /var/log/ksymoops に `date +%Y%m%d%H%M%S` の prefix を付けてコピーする。システム管理者は ksymoops に対して、 Oops のデバッグ時にどのスナップショットファイルを利用するか伝えることができる。この自動コピーを無効にするスイッチは存在しない。これを望まない場合は、 /var/log/ksymoops を作ってはならない。このディレクトリを置くときには、所有者は root とし、モードは 644 または 600 にして、以下のスクリプトを一日一回程度実行すると良い。このスクリプトは insmod_ksymoops_clean としてインストールされる。

#!/bin/sh
# Delete saved ksyms and modules not accessed in 2 days
if [ -d /var/log/ksymoops ]
then
set -e
# Make sure there is always at least one version
d=`date +%Y%m%d%H%M%S`
cp -a /proc/ksyms /var/log/ksymoops/${d}.ksyms
cp -a /proc/modules /var/log/ksymoops/${d}.modules
find /var/log/ksymoops -type f -atime +2 -exec rm {} \;
fi