manページ  — GETGROUPS

getgroups – グループアクセスリストを取得

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

Standard C Library (libc, -lc)

#include <sys/types.h>

#include <unistd.h>

int
getgroups(int gidsetlen, gid_t *gidset);

getgroups() システムコールは、ユーザプロセスの現在のグループアクセスリストを取得し、 それを配列 gidset に保存します。 gidsetlen 引数は gidset 内に配置できるエントリの数を示します。 getgroups() システムコールは、 gidset に返された実際のグループの数を返します。 NGROUPS_MAX より大きい値は返しません。 gidsetlen が 0 の場合には getgroups() は、 gidset が指し示す配列を修正せずに、 呼び出したプロセスに対応する補助グループ ID の数を返します。

呼び出しが正常に完了すると、グループセット内のグループの数が返されます。 戻り値 -1 はエラーが起こったことを示し、 エラーコードはグローバル変数 errno に保存されます。

getgroups() で起こり得るエラーは次のとおりです:

[EINVAL]
	引数 gidsetlen がグループセット内のグループの数より小さいです。
[EFAULT]
	引数 gidset は無効なアドレスを指しています。

getgroups() システムコールは BSD 4.2 で登場しました。