GETGRNAM(3)

名前
getgrnam, getgrgid - グループファイルエントリの取り出し

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

struct group *getgrnam(const char *name);

struct group *getgrgid(gid_t gid);

説明
getgrnam() 関数は、/etc/group から取り出した、グループ名 name に一致するエントリのグループ情報を含む構造体へのポインタを返す。

getgrgid() 関数は、/etc/group から取り出した、グループ ID gid に一致するエントリのグループ情報を含む構造体へのポインタを返す。

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

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

返り値
getgrnam() と getgrgid() 関数は、グループ情報構造体への ポインタを返す。 一致するエントリがないか、エラーが発生した場合は NULL を返す。

エラー

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

ファイル

/etc/group
    グループデータベースファイル

準拠
SVID 3, POSIX, BSD 4.3

関連項目
fgetgrent(3), getgrent(3), setgrent(3), endgrent(3)