SETGROUPS(2)

名称
setgroups - グループアクセスリストを設定する

ライブラリ
libc

書式
<sys/param.h> <unistd.h> int setgroups(int ngroups, const gid_t *gidset)

解説
setgroups() は、配列 gidset に従って、現在のユーザプロセスのグループアクセスリストを設定します。 パラメータ ngroups は、配列内のエントリの数を示し、 <sys/param.h> 内に定義されている値 NGROUPS を超えてはいけません。

スーパユーザだけが新しいグループを設定できます。

戻り値

エラー
setgroups() 呼び出しは次の場合に処理に失敗します:

[EPERM]
    スーパユーザ以外のユーザによって呼び出されました。

[EFAULT]
    gidset に指定されたアドレスは、 プロセスに割り当てられたアドレス空間の範囲外を指しています。

関連項目
getgroups(2), initgroups(3)

歴史
setgroups() 関数呼び出しは 4.2BSD で登場しました。