FGETGRENT(3)

名前
fgetgrent - グループファイルエントリの取り出し

書式
#include <grp.h>
#include <stdio.h>
#include <sys/types.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
    グループ情報構造体を割り当てるためのメモリが不十分。

準拠
SVID 3

関連項目
getgrnam(3), getgrgid(3), getgrent(3), setgrent(3), endgrent(3)