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 の パスワード行エントリーを取得する。 返されるバッファーは、以下の形式の行を含む。
name:passwd:uid:gid:gecos:dir:shell
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 を返し、エラーを 示すために errno がセットされる。
uid がパスワードデータベースに見つからない場合、 getpw() は −1 を返し、 errno に 0 を設定し、 buf は変更しない。
0 または ENOENT
uid に対応するユーザーがいない。
EINVAL |
buf が NULL。 |
||
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.79 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man−pages/ に書かれている。