標準/拡張機能 | C/C++ | 依存項目 |
---|---|---|
Single UNIX Specification、バージョン 2 |
両方 | OS/390 V2R8 |
#define _XOPEN_SOURCE 500
#include <sys/types.h>
#include <grp.h>
int getgrnam_r(const char *name, struct group *grp, char *buffer,
size_t bufsize, struct group **result);
#define _POSIX_SOURCE
#include <grp.h>
int __getgrnam1(const char *name, struct group *grp, char *buffer,
size_t bufsize, struct group **result);
getgrnam_r() 関数は、grp が指すグループ構造体を更新し、その構造体を指すポインターを、result が指すロケーションに保管します。この構造体には、name にマッチングするグループ・データベースのエントリーが入ります。グループ構造体が参照するストレージは、buffer パラメーターによって提供される、サイズが bufsize バイトであるメモリーから割り振られます。エラーの場合、または要求されたエントリーが検出されなかった場合は、result が指すロケーションに NULL ポインターが戻されます。
__getgrnam1() 関数は getgrnam_r() と同じですが、個々のグループ・メンバー名を戻しません。 grp によって指し示されるグループ構造体内のエレメント gr_mem は、NULL に設定されます。
正常に実行された場合、getgrnam_r() または __getgrnam1() は 0 を戻します。
正常に実行されなかった場合、getgrnam_r() または _getgrnam1() はエラー番号を戻して、errno を次のいずれかの 値に設定します。