ukeyset_init サブルーチン

目的

ユーザー・キー・セットを初期化します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <sys/ukeys.h> int ukeyset_init (nset, flags) ukeyset_t * nset; unsigned int flags;

説明

ukeyset_initサブルーチンは、nsetパラメータが指すユーザー・キー・セットを初期化する。このキー・セットでは、UKEY_PUBLICだけに対して読み取りと書き込みのアクセスが有効になっており、他のすべてのキーに対しては無効になっている。 UK_INIT_ADD_PRIVATEフラグが指定されている場合、利用可能なすべてのプライベート・ユーザー・キーに対する読み取り/書き込みアクセスが有効になる。

パラメーター

項目	説明
NSET	初期化されるユーザー・キー・セットを指します。
flags	デフォルトの動作(パブリック・ユーザー・キーのみを有効にする)の場合は0を、すべてのプライベート・ユーザー・キーも有効にする場合はUK_INIT_ADD_PRIVATEを設定しなければならない。

戻り値

成功すれば、ukeyset_initサブルーチンは値0を返す。そうでない場合は-1を返し、エラーを示すグローバル変数errnoをセットする。

エラー・コード

ukeyset_initサブルーチンは、以下の場合失敗する：

項目	説明
EINVAL	フラグ・パラメーターが無効であるか、NULL であるか、 NSET パラメーターが正しく位置合わせされていません。
ENOSYS	ユーザー・キー対応プロセスではありません。