GETGROUPS

Section: System Calls (2)
索引 jman

BSD mandoc
 

索引

名称

getgroups - グループアクセスリストを取得  

索引

ライブラリ

Lb libc  

索引

書式

In sys/types.h In unistd.h Ft int Fn getgroups int gidsetlen gid_t *gidset  

索引

解説

Fn getgroups システムコールは、ユーザプロセスの現在のグループアクセスリストを取得し、 それを配列 Fa gidset に保存します。 Fa gidsetlen 引数は Fa gidset 内に配置できるエントリの数を示します。 Fn getgroups システムコールは、 Fa gidset に返された実際のグループの数を返します。 NGROUPS_MAX より大きい値は返しません。 Fa gidsetlen が 0 の場合には Fn getgroups は、 Fa gidset が指し示す配列を修正せずに、 呼び出したプロセスに対応する補助グループ ID の数を返します。  

索引

戻り値

呼び出しが正常に完了すると、グループセット内のグループの数が返されます。 戻り値 -1 はエラーが起こったことを示し、 エラーコードはグローバル変数 errno に保存されます。  

索引

エラー

Fn getgroups で起こり得るエラーは次のとおりです:

Bq Er EINVAL
引数 Fa gidsetlen がグループセット内のグループの数より小さいです。
Bq Er EFAULT
引数 Fa gidset は無効なアドレスを指しています。

 

索引

関連項目

setgroups(2), initgroups(3)  

索引

歴史

Fn getgroups システムコールは BSD 4.2 で登場しました。


 

索引

Index

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

jman



Time: 07:06:26 GMT, January 12, 2009