kldstat(2)

kldstat − kld ファイルの状態を得る

標準 C ライブラリ (libc, −lc)

#include <sys/param.h>
#include <sys/linker.h>

int

kldstat(int fileid, struct kld_file_stat *stat);

解説

kldstat() システムコールは、 fileid によって参照されたファイルに関する情 報を stat に書込みます。

struct kld_file_stat {

int version; /* sizeof(linker_file_stat) に設定 */

char name[MAXPATHLEN];

int refs;

int id;

caddr_t address; /* ロードアドレス */

size_t size; /* バイト単位のサイズ */

};

このフィールドは、 kldstat() 自体ではなく、 kldstat() を呼び 出すコードで前述した構造体のサイズに設定します。

name
fileid によって参照されるファイルの名前

refs
fileid によって参照されるモジュールの数

id
fileid で指定されたファイルの ID

address
kld ファイルのロードアドレス

size
ファイルのサイズ

戻り値

関数 kldstat() は、処理が成功すると値 0 を返します。そうでない場合、値 -1 が返され、グローバル変数 errno が設定されてエラーを示します。

次の場合を除いて、 fileid が参照するファイルに関する情報は stat が指す構 造体に記入されます:

ファイルが見つかりませんでした (おそらくロードされてい ないのでしょう)。

[EINVAL]
stat の version フィールドで指定されたバージョンが適切 ではありません。 version フィールドに適切に記入してい るのにこのエラーが起きた場合は、ワールド、カーネル、ま たはアプリケーションを再構築する必要があります。

[EFAULT]
copyout(9) 関数で、フィールドを stat にコピーする際に 問題がありました。

関連項目

kldfind(2), kldfirstmod(2), kldload(2), kldnext(2), kldsym(2), kldunload(2), modfind(2), modfnext(2), modnext(2), modstat(2), kld(4), kldstat(8)

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

FreeBSD 10.0 March 3, 1999 FreeBSD 10.0