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);
 

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

fgetgrent(): _SVID_SOURCE

説明

fgetgrent() 関数は、ファイル stream から取り出したグループ情報 を含む構造体へのポインタを返す。最初に呼び出された時は 最初のエントリを返し、それ以降は、次のエントリを返す。 ファイル stream は、/etc/group と同じ形式でなければならない。

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

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

返り値

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

エラー

ENOMEM

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

準拠

SVr4

関連項目

endgrent(3), fgetgrent_r(3), getgrent(3), getgrgid(3), getgrnam(3), putgrent(3), setgrent(3)