getpwnam_r() - 名前に対応するユーザー・データベースの検索

標準

形式

#define _XOPEN_SOURCE 500
#include <sys/types.h>
#include <pwd.h>

int getpwnam_r(const char *nam, struct passwd *pwd,
char *buffer, size_t bufsize, struct passwd **result);

機能説明

getpwnam_r() 関数は、pwd が指す passwd 構造体を更新し、その構造体を指すポインターを、result が指すロケーションに保管します。この構造体は、名前がマッチングするユーザー・データベースからのエントリーを含みます。構造体が参照するストレージは、buffer パラメーターによって提供される、サイズ bufsize 文字のメモリーから割り振られます。エラーの場合、または要求されたエントリーが検出されなかった場合は、result が指すロケーションに NULL ポインターが戻されます。

戻り値

正常に実行された場合、getpwnam_r() は 0 を戻します。

関連情報

• pwd.h
• sys/types.h
• endpwent() - ユーザー・データベース関数
• getlogin() - ユーザー・ログイン名の取得
• getlogin_r() - ログイン名の取得
• getpwnam() - ユーザー名によるユーザー・データベースへのアクセス
• getpwuid() - ユーザー ID によるユーザー・データベースへのアクセス
• getpwuid_r() - ユーザー ID に対応するユーザー・データベースの検索