GETGROUPLIST

Section: C Library Functions (3)
索引 jman

BSD mandoc

名称

getgrouplist - グループアクセスリストの演算

Fd #include <unistd.h> Ft int Fn getgrouplist const char *name int basegid int *groups int *ngroups

Fn getgrouplist 関数はグループファイルを読み通して、 Fa name で指定したユーザのためにグループアクセスリストを演算します。グループリストには、 Fa basegid が自動的に含まれます。通常、この値はパスワードファイルから、グループ番号として与えられます。

結果のグループリストは、 Fa groups で指された整数配列で返されます。呼び出し元は Fa ngroups に示された整数で Fa groups 配列の大きさを指定します。見付かったグループの実際の数は、 Fa ngroups で返ります。

Fn getgrouplist 関数は、そのユーザのグループすべてを保持するには、グループリストのサイズが小さすぎる場合、-1 を返します。グループ配列はこの場合、大きさに見合うだけの数のグループで満たされます。

Fn getgrouplist 関数は BSD 4.4 で最初に取り入れられました。

Fn getgrouplist 関数は、 getgrent(3) に基づくルーチンを使用します。したがって、呼び出しプログラムがこれらのルーチンのどれかを使用すると、 Fn getgrouplist の呼び出しによってグループ構造体が上書きされます。

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