GETPW(3)

名前
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 を返し、エラーを 示すために 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.54 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。