名称

getgroups − グループアクセスリストを取り出す

形式

#include <sys/param.h>

ngroups = getgroups(gidsetlen, gidset)
int ngroups, gidsetlen, ∗gidset;

解説

getgroups は、 ユーザプロセスの現グループアクセスリストを 取り出し、 配列 gidset へ収めます。 パラメータ gidsetlen は、 gidset に入れられるエントリの数を 示します。 getgroups は、 gidset へ実際に返されたエントリの数を 返します。 <sys/param.h> の中で定義されている NGROUPS より大きな数が返されることはありません。

リターン値

コールが成功した場合には、 グループセットに含まれているグループの数を 返します。 エラーが発生した場合には、 値 −1 が返され、 エラーコードがグローバル変数 errno に入れられます。

エラー

getgroups で発生する可能性のあるエラーは次のとおりです。

[EINVAL] 引数 gidsetlen が、 グループセットに含まれているグループの数より小さい。

[EFAULT] 引数 gidset が無効なアドレスを 指定している。

関連事項

setgroups(2), initgroups(3X)

バグ

gidset 配列のタイプは gid_t とすべきですが、 以前のシステムとの互換性のために整数のままになっています。

NEWS-OSRelease 3.3