GETGRNAM

名前

書式

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

struct group *getgrnam(const char *name);

struct group *getgrgid(gid_t gid);

int getgrnam_r(const char *name, struct group *gbuf,


          char *buf, size_t buflen, struct group **gbufp);

int getgrgid_r(gid_t gid, struct group *gbuf,


          char *buf, size_t buflen, struct group **gbufp);

説明

getgrgid() 関数は、グループ ID uid にマッチするグループ・データベースのエントリを 要素毎に分解し、各要素を格納した構造体へのポインタを返す。

getgrnam_r() と getgrgid_r() 関数は (上記の関数と) 同じ情報を取得するが、 取得した group 構造体を gbuf が指す領域に格納する。 この group 構造体には文字列へのポインタが含まれ、 これらの文字列はサイズ buflen のバッファ buf に格納される。 成功した場合 *gbufp には結果へのポインタが格納される。 エントリが見つからなかった場合やエラーが発生した場合には *gbufp には NULL が入る。

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

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

buf に最大必要なサイズは、 sysconf(3) に引き数 _SC_GETGR_R_SIZE_MAX を指定して実行することで分かる。  

返り値

返り値は静的な領域を指しており、その後の getgrent(), getgrgid(), getgrnam() の呼び出しで上書きされるかもしれない。

getgrnam_r() と getgrgid_r() 関数は、 成功した場合に 0 を返す。 エラーの場合は、エラー番号が返される。  

エラー

0 または ENOENT または ESRCH または EBADF または EPERM または ...

指定された name または gid が見つからなかった。

EINTR

シグナルがキャッチされた。

EIO

I/O エラー。

EMFILE

呼び出したプロセスにおいて、 既に最大数 (OPEN_MAX) のファイルがオープンされている。

ENFILE

システム上で既に最大数のファイルがオープンされている。

ENOMEM

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

ERANGE

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

ファイル

/etc/group

ローカルのグループ・データベースファイル

準拠

注意

関連項目

Index

名前

書式

説明

返り値

エラー

ファイル

準拠

注意

関連項目