manページ  — GETGROUPLIST

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

書式 解説 戻り値 関連ファイル 関連項目 歴史 バグ

#include <unistd.h>
int
getgrouplist(const char *name, int basegid, int *groups, int *ngroups);

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

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

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

/etc/group
	グループ会員リスト

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