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]
    スーパユーザ以外のユーザによって呼び出されました。

[EINVAL]
    ngroups 引数で指定された数値が NGROUPS の制限を越えています。

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

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

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