名称

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

ライブラリ

Standard C Library (libc, -lc)

書式

#include < sys/param.h>
#include < unistd.h>

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

解説

setgroups() システムコールは、配列 gidset に従って、現在のユーザプロセスのグループアクセスリストを設定します。 ngroups 引数は、配列のエントリの数を示し、 {NGROUPS_MAX}+1 を越えてはなりません。

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

戻り値

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_MAX}+1 の制限より大きい。

[ EFAULT]

gidset のために指定されたアドレスがプロセスのアドレス空間の外側です。

関連項目

getgroups(2), initgroups(3)

歴史

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