getgrnam

GETGRNAM(3)                 Linux Programmer's Manual                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)




GNU                               April 4, 1993                      GETGRNAM(3)