manページ  — SETGROUPS

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

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

Standard C Library (libc, -lc)

#include <sys/param.h>

#include <unistd.h>

int
setgroups(int ngroups, const gid_t *gidset);

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

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

The setgroups function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

setgroups() システムコールは次の場合に処理に失敗します:

[EPERM]
	スーパユーザ以外のユーザによって呼び出されました。
[EINVAL]
	ngroups 引数で指定された数値が NGROUPS の制限を越えています。
[EFAULT]
	gidset に指定されたアドレスは、 プロセスに割り当てられたアドレス空間の範囲外を指しています。

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