名前
fgetgrent - グループファイルエントリの取り出し
書式
#include <stdio.h>
#include <sys/types.h>
#include <grp.h>
struct group *fgetgrent(FILE *stream);
説明
fgetgrent() 関数は、ファイル stream から取り出したグループ情報 を含む構造体へのポインタを返す。最初に呼び出された時は 最初のエントリを返し、それ以降は、次のエントリを返す。 ファイル stream は、/etc/group と同じ形式でなければならない。
group 構造体は、<grp.h> で以下のように定義されている:
struct group { char *gr_name; /* グループ名 */ char *gr_passwd; /* グループのパスワード */ gid_t gr_gid; /* グループ ID */ char **gr_mem; /* グループのメンバ */ };
返り値
fgetgrent() 関数はグループ情報構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL を返す。
エラー
ENOMEM | グループ情報構造体を割り当てるためのメモリが不十分。 |
準拠
SVr4
関連項目
endgrent(3), fgetgrent_r(3), getgrent(3), getgrgid(3), getgrnam(3), putgrent(3), setgrent(3)