名前

getpw -パスワード行エントリを取得する

書式

#define _GNU_SOURCE /* feature_test_macros(7) 参照 */
#include <sys/types.h>
#include <pwd.h>
int getpw(uid_t uid , char * buf );

説明

getpw() 関数は、バッファ buf に指定ユーザ ID uid のパスワード行エントリを取得する。返されるバッファは、以下の形式の行を含む。

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

struct passwd {
char *pw_name; /* ユーザ名 */
char *pw_passwd; /* ユーザのパスワード */
uid_t pw_uid; /* ユーザ ID */
gid_t pw_gid; /* グループ ID */
char *pw_gecos; /* ユーザ情報 */
char *pw_dir; /* ホームディレクトリ */
char *pw_shell; /* シェルプログラム */
};

この構造体のフィールドの詳細は passwd(5) を参照のこと。

返り値

getpw() 関数は、成功した場合 0 を返す;エラーが発生した場合-1 を返し、エラーを示すために error がセットされる。

エラー

EINVAL

buf が NULL。

ENOENT

uid に対応するユーザがいない。

ENOMEM

passwd 構造体に割り当てるメモリが十分なかった。

ファイル

/etc/passwd

パスワードデータベースファイル

準拠

SVr2

バグ

getpw() 関数は、与えられたバッファ buf がオーバーフローするかもしれないので危険である。この関数は getpwuid(3) によって古いものとなった。

関連項目

endpwent(3), fgetpwent(3), getpwent(3), getpwnam(3), getpwuid(3), putpwent(3), setpwent(3), passwd(5)

この文書について

この man ページは Linux man-pages プロジェクトのリリース 3.51 の一部である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。