#include <sys/types.h> #include <grp.h> struct group *getgrent(void); void setgrent(void); void endgrent(void);
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
setgrent():
_XOPEN_SOURCE >= 500
|| /* glibc >= 2.19: */ _DEFAULT_SOURCE
|| /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
getgrent(), endgrent():
glibc 2.22 以降:
_XOPEN_SOURCE >= 500 || _DEFAULT_SOURCE
glibc 2.21 以前
_XOPEN_SOURCE >= 500
|| /* glibc 2.12 以降: */ _POSIX_C_SOURCE >= 200809L
|| /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
setgrent() 関数を使うと、もう一度読み込めるように、 グループデータベースの先頭に戻る。
endgrent() 関数は、全ての処理が終わった後にグループ データベースをクローズする。
group 構造体は <grp.h> で以下のように定義されている:
struct group {
char *gr_name; /* グループ名 */
char *gr_passwd; /* グループのパスワード */
gid_t gr_gid; /* グループ ID */
char **gr_mem; /* グループのメンバ名へのポインター
の配列 (配列はヌルで終端する) */
};
この構造体のフィールドの詳細は group(5) を参照のこと。
エラーが発生すると、 errno が適切に設定される。 この関数の呼び出し後に errno をチェックしたい場合は、呼び出し前に errno を 0 に設定しておかないといけない。
返り値は静的な領域を指しており、その後の getgrent(), getgrgid(3), getgrnam(3) の呼び出しで上書きされるかもしれない。 (返されたポインターを free(3) に渡さないこと。)
| インターフェース | 属性 | 値 |
| getgrent() | Thread safety |
MT-Unsafe race:grent
race:grentbuf locale
|
| setgrent(), endgrent() | Thread safety |
MT-Unsafe race:grent locale
|
In the above table, grent in race:grent signifies that if any of the functions setgrent(), getgrent(), or endgrent() are used in parallel in different threads of a program, then data races could occur.