Manpages

名 前

getgrent, setgrent, endgrent − グ ル ー プ フ ァ イ ル エ ン ト リ ー の 取 得

書 式

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

struct group *getgrent(void);

void setgrent(void);

void endgrent(void);

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

setgrent():

_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
/* Since glibc 2.12: */ _POSIX_C_SOURCE >= 200809L

getgrent(), endgrent():

_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED

説 明

getgrent() 関 数 は 、 グ ル ー プ デ ー タ ベ ー ス か ら 取 得 し た エ ン ト リ ー を 要 素 毎 に 分 解 し 、 各 要 素 を 格 納 し た 構 造 体 へ の ポ イ ン タ ー を 返 す (グ ル ー プ デ ー タ ベ ー ス の 例 : ロ ー カ ル の グ ル ー プ フ ァ イ ル /etc/group, NIS, LDAP)。 getgrent() は 、 最 初 に 呼 び 出 さ れ た 時 は 最 初 の エ ン ト リ ー を 返 し 、 そ れ 以 降 は 呼 び 出 さ れ る 毎 に 次 の エ ン ト リ ー を 返 す 。

setgrent() 関 数 を 使 う と 、 も う 一 度 読 み 込 め る よ う に 、 グ ル ー プ デ ー タ ベ ー ス の 先 頭 に 戻 る 。

endgrent() 関 数 は 、 全 て の 処 理 が 終 わ っ た 後 に グ ル ー プ デ ー タ ベ ー ス を ク ロ ー ズ す る 。

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

struct group {
char *gr_name; /* グ ル ー プ 名 */
char *gr_passwd; /* グ ル ー プ の パ ス ワ ー ド */
gid_t gr_gid; /* グ ル ー プ ID */
char **gr_mem; /* グ ル ー プ の メ ン バ 名 へ の ポ イ ン タ ー の 配 列
(配 列 は ヌ ル で 終 端 す る ) */ }; こ の 構 造 体 の フ ィ ー ル ド の 詳 細 は group(5) を 参 照 の こ と 。

返 り 値

getgrent() 関 数 は group 構 造 体 へ の ポ イ ン タ ー を 返 す 。 こ れ 以 上 エ ン ト リ ー が 無 い か 、 エ ラ ー が 発 生 し た 場 合 は NULL を 返 す 。 エ ラ ー が 発 生 す る と 、 errno が 適 切 に 設 定 さ れ る 。 こ の 関 数 の 呼 び 出 し 後 に errno を チ ェ ッ ク し た い 場 合 は 、 呼 び 出 し 前 に errno を 0 に 設 定 し て お か な い と い け な い 。 返 り 値 は 静 的 な 領 域 を 指 し て お り 、 そ の 後 の getgrent(), getgrgid(3), getgrnam(3) の 呼 び 出 し で 上 書 き さ れ る か も し れ な い 。 (返 さ れ た ポ イ ン タ ー を free(3) に 渡 さ な い こ と 。 )

エ ラ ー

NSS バ ッ ク エ ン ド の 場 合 、 glibc で は 、 バ ッ ク エ ン ド と の 通 信 中 に 一 時 的 な エ ラ ー が 発 生 し た こ と を 示 す 。 こ の エ ラ ー は 直 る か も し れ な い の で 、 あ と で も う 一 度 試 す よ う 提 案 し て い る 。

I/O エ ラ ー 。

NSS バ ッ ク エ ン ド の 場 合 、 glibc で は 、 こ の エ ラ ー は バ ッ ク エ ン ド が 正 し く 設 定 さ れ て い な い こ と を 示 す 。

与 え ら れ た バ ッ フ ァ ー 空 間 が 不 十 分 で あ る 。