GETGROUPS
Section: System Calls (2)
索引
jman
BSD mandoc
索引
名称
getgroups
- グループアクセスリストを取得
索引
ライブラリ
Lb libc
索引
書式
In sys/types.h
In unistd.h
Ft int
Fn getgroups int gidsetlen gid_t *gidset
索引
解説
Fn getgroups
システムコールは、ユーザプロセスの現在のグループアクセスリストを取得し、
それを配列
Fa gidset
に保存します。
Fa gidsetlen
引数は
Fa gidset
内に配置できるエントリの数を示します。
Fn getgroups
システムコールは、
Fa gidset
に返された実際のグループの数を返します。
NGROUPS_MAX
より大きい値は返しません。
Fa gidsetlen
が 0 の場合には
Fn getgroups
は、
Fa gidset
が指し示す配列を修正せずに、
呼び出したプロセスに対応する補助グループ ID の数を返します。
索引
戻り値
呼び出しが正常に完了すると、グループセット内のグループの数が返されます。
戻り値 -1 はエラーが起こったことを示し、
エラーコードはグローバル変数
errno
に保存されます。
索引
エラー
Fn getgroups
で起こり得るエラーは次のとおりです:
- Bq Er EINVAL
-
引数
Fa gidsetlen
がグループセット内のグループの数より小さいです。
- Bq Er EFAULT
-
引数
Fa gidset
は無効なアドレスを指しています。
索引
関連項目
setgroups(2),
initgroups(3)
索引
歴史
Fn getgroups
システムコールは
BSD 4.2
で登場しました。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- 戻り値
-
- エラー
-
- 関連項目
-
- 歴史
-
Time: 07:06:26 GMT, January 12, 2009