Linux Certif

Toute la documentation sur la certification Linux LPI

fgetgrent

名前

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)