KENV(2) FreeBSD システムコールマニュアル KENV(2)
名称
kenv − カーネル環境 |
ライブラリ
標準 C ライブラリ (libc, −lc) |
書式
#include <kenv.h> int |
kenv(int action, const char *name, char *value, int len); |
解説 |
kenv() システムコールはカーネル環境変数を操作します。カーネル環境の中の全 てのエントリをダンプする能力と同様に、ユーザランドでよく知られている環境 変数を取得、設定、設定解除する動作をサポートしています。 action 引数は、以下の中の 1 つを取ることが可能です: |
KENV_GET
カーネル環境変数に関連付けられた値を返します。その変数が見つ からない場合には、−1 が返されグローバル変数 errno が ENOENT に設定されます。 value に利用可能なバイト数のみがコピーされま す。 KENV_SET KENV_UNSET KENV_DUMP name 引数は作用されるべき環境変数の名前です。 KENV_DUMP の場合には、無視 されます。 value 引数は、 KENV_SET の場合には環境変数 name に設定するべき値、または KENV_DUMP および KENV_GET の場合には kenv() が返すデータをコピーするべき 場所を指し示す値、のどちらかを含みます。 value が NULL で KENV_DUMP の場 合には、 kenv() は環境変数全体をコピーするために必要なバイト数を返すで しょう。 len 引数は value が指す記憶領域が何バイトかを示します。 戻り値 |
KENV_SET および KENV_UNSET で成功した場合には、 kenv() システムコールは 0 を返します。 KENV_DUMP および KENV_GET で成功した場合には、 value にコ ピーされたバイト数を返します。エラーが発生した場合には、値 −1 が返されグ ローバル変数 errno がそのエラーを示すために設定されます。 |
エラー
kenv() システムコールは、以下の場合に失敗します: |
[EINVAL]
action 引数が有効なオプションではありません。または KENV_SET のための value 引数の長さが 1 未満です。 [ENOENT] [EPERM] [EFAULT] [ENAMETOOLONG] 関連項目 |
作者
このマニュアルページは Chad David 〈davidc@FreeBSD.org〉 が書きました。 kenv() システムコールは Maxime Henrion 〈mux@FreeBSD.org〉 が書きました。 FreeBSD 10.0 April 17, 2002 FreeBSD 10.0 |