manページ  — MODSTAT

modstat – カーネルモジュールの状態を取得

ライブラリ 書式 解説 戻り値 エラー 関連項目 歴史

Standard C Library (libc, -lc)

#include <sys/param.h>

#include <sys/module.h>

int
modstat(int modid, struct module_stat *stat);

modstat() システムコールは modid で参照されているカーネルモジュールに関する情報を stat に格納します。

struct module_stat {
        int         version;        /* set to sizeof(module_stat) */
        char        name[MAXPATHLEN];
        int         refs;
        int         id;
        modspecific_t data;
};
typedef union modspecific {
        int         intval;
        u_int       u_intval;
        long        longval;
        u_long      u_longval;
} modspecific_t;

version	このフィールドには、 modstat() 自体ではなく modstat() を呼び出したコードによって、上記の構造体のサイズが設定されます。
name	modid で参照されているモジュールの名前。
refs	modid で参照されているモジュールの数。
id	modid で指定されているモジュールの id。
data	モジュール特有のデータ。

The modstat function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

以下のようなエラーが発生しない限り、 modid によって参照されているモジュールに関する情報が stat が指している構造体に代入されます:

[ENOENT]
	モジュールが見つかりません (おそらくロードされていません)。
[EINVAL]
	version フィールドで指定されているバージョンが適切ではありません。 適切なバージョンを version フィールドで指定しているにも関わらずこのエラーが起こるときは、 OS 全体か、カーネルまたはプログラム自身を作り直す必要があるかもしれません。
[EFAULT]
	copyout(9) 関数の中で、ひとつまたは複数あるいはすべてのフィールドを stat にコピー中に問題が発生しました。

kld インタフェースは FreeBSD 3.0 ではじめて登場しました。