fgetgrent - ライブラリコールの説明 - Linux コマンド集 一覧表
名前
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)