名前¶

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

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

属性¶

この節で使用されている用語の説明については、 attributes(7) を参照。

準拠¶

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 プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。