Manpages

名 前

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(5) 参 照 )。

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

struct group {
char *gr_name; /* グ ル ー プ 名 */
char *gr_passwd; /* グ ル ー プ の パ ス ワ ー ド */
gid_t gr_gid; /* グ ル ー プ ID */
char **gr_mem; /* グ ル ー プ の メ ン バ 名 へ の ポ イ ン タ ー の 配 列
(配 列 は ヌ ル で 終 端 す る ) */ };

返 り 値

fgetgrent() 関 数 は group 構 造 体 へ の ポ イ ン タ ー を 返 す 。 こ れ 以 上 エ ン ト リ ー が 無 い か 、 エ ラ ー が 発 生 し た 場 合 は NULL を 返 す 。 エ ラ ー の 場 合 、 errno に 原 因 を 示 す 値 が 設 定 さ れ る 。

エ ラ ー

ENOMEM

group 構 造 体 を 割 り 当 て る た め の メ モ リ ー が 不 十 分 。

準 拠

SVr4.

関 連 項 目

endgrent(3), fgetgrent_r(3), fopen(3), getgrent(3), getgrgid(3), getgrnam(3), putgrent(3), setgrent(3), group(5)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。