kazmax - Linux で自宅サーバー

fgetpwent - ライブラリコールの説明 - Linux コマンド集 一覧表

  1. 名前
  2. 書式
  3. 説明
  4. 返り値
  5. エラー
  6. ファイル
  7. 準拠
  8. 関連項目

名前

fgetpwent - パスワードファイルエントリの取り出し

書式

#include <stdio.h>#include <sys/types.h>#include <pwd.h>

struct passwd *fgetpwent(FILE *stream);

説明

fgetpwent () 関数は、stream から得られた行を分解したフィールド を含む構造体へのポインタを返す。 最初に呼び出された時には最初のエントリを返し、それ以降は 次のエントリを返す。 ファイル stream/etc/passwd と同じ形式でなければならない。

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;      	/* シェルプログラム */
};

返り値

fgetpwent () 関数は、passwd 構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL を返す。

エラー

ENOMEM
passwd 構造体を割り当てるためのメモリが不十分。

ファイル

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

準拠

SVr4

関連項目

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