名称

setgroups − グループアクセスリストをセットする

形式

#include <sys/param.h>

setgroups(ngroups, gidset)
int ngroups, ∗gidset;

解説

setgroups は、 配列 gidset に従って、 現ユーザプロセスのグループアクセスリストを セットします。 パラメタ ngroups は、 配列内のエントリの数を 示し、 <sys/param.h> で定義されている NGROUPS より大きな値であってはなりません。

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

リターン値

コールが成功した場合には、 値 0 が返されます。 エラーが発生した場合には、 −1 が返され、 エラーコードが errno に入れられます。

エラー

次のエラーが発生した場合、 setgroups コールは失敗します。

[EPERM] 呼び出しユーザがスーパーユーザではない。

[EFAULT] gidset で指定されたアドレスがプロセスのアドレススペースの外側にある。

関連事項

getgroups(2), initgroups(3X)

バグ

gidset は、 タイプ gid_t であるべきなのですが、 古いバージョンとの互換性を 保つために int になっています。

NEWS-OSRelease 4.1C