GETGRENT(3)

名前
getgrent, setgrent, endgrent - グループファイルエントリの取り出し

書式
#include <grp.h>
#include <sys/types.h>

struct group *getgrent(void);

void setgrent(void);

void endgrent(void);

説明
getgrent() 関数は、/etc/group から取り出したグループ情報 を含む構造体へのポインタを返す。最初に呼び出された時は 最初のエントリを返し、それ以降は、次のエントリを返す。

setgrent() 関数は、ファイルポインタを /etc/group ファイルの 先頭へ巻き戻す。

endgrent() 関数は、/etc/group ファイルをクローズする。

group 構造体は、<grp.h> で以下のように定義されている:

    struct group {
            char    *gr_name;        /* グループ名 */
            char    *gr_passwd;      /* グループのパスワード */
            gid_t   gr_gid;          /* グループ ID */
            char    **gr_mem;        /* グループのメンバ */
    };

返り値
getgrent() 関数はグループ情報構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL を返す。

エラー

ENOMEM
    グループ情報構造体を割り当てるためのメモリが不十分。

ファイル

/etc/group
    グループデータベースファイル

準拠
SVID 3, BSD 4.3

関連項目
fgetgrent(3), getgrnam(3), getgrgid(3)