36.2. "pwd" --- パスワードデータベースへのアクセスを提供する
************************************************************

このモジュールは Unix のユーザアカウントとパスワードのデータベースへの
アクセスを提供します。全ての Unix 系 OS で利用できます。

パスワードデータベースの各エントリはタプルのようなオブジェクトで提供さ
れ、それぞれの属性は "passwd" 構造体のメンバに対応しています(下の属性
欄については、"<pwd.h>" を見てください):

+---------+-----------------+-------------------------------+
| インデ  | 属性            | 意味                          |
| ックス  |                 |                               |
+=========+=================+===============================+
| 0       | "pw_name"       | ログイン名                    |
+---------+-----------------+-------------------------------+
| 1       | "pw_passwd"     | 暗号化されたパスワード        |
|         |                 | (optional))                   |
+---------+-----------------+-------------------------------+
| 2       | "pw_uid"        | ユーザID(UID)                 |
+---------+-----------------+-------------------------------+
| 3       | "pw_gid"        | グループID(GID)               |
+---------+-----------------+-------------------------------+
| 4       | "pw_gecos"      | 実名またはコメント            |
+---------+-----------------+-------------------------------+
| 5       | "pw_dir"        | ホームディレクトリ            |
+---------+-----------------+-------------------------------+
| 6       | "pw_shell"      | シェル                        |
+---------+-----------------+-------------------------------+

UIDとGIDは整数で、それ以外は全て文字列です。検索したエントリが見つから
ないと "KeyError" が発生します。

注釈: 伝統的なUnixでは、 "pw_passwd" フィールドはDES由来のアルゴリズ
  ムで暗 号化されたパスワード("crypt" モジュールをごらんください)が含
  まれてい ます。しかし、近代的なUNIX系OSでは *シャドウパスワード* と
  よばれる仕 組みを利用しています。この場合には *pw_passwd* フィールド
  にはアスタ リスク("'*'")か、 "'x'" という一文字だけが含まれており、
  暗号化された パスワードは、一般には見えない "/etc/shadow" というファ
  イルに入って います。 *pw_passwd* フィールドに有用な値が入っているか
  はシステムに 依存します。利用可能なら、暗号化されたパスワードへのア
  クセスが必要な ときには "spwd" モジュールを利用してください。

このモジュールでは以下の内容を定義しています:

pwd.getpwuid(uid)

   与えられたUIDに対応するパスワードデータベースのエントリを返します。

pwd.getpwnam(name)

   与えられたユーザ名に対応するパスワードデータベースのエントリを返し
   ます。

pwd.getpwall()

   パスワードデータベースの全てのエントリを、任意の順番で並べたリスト
   を返します。

参考:

  "grp" モジュール
     このモジュールに似た、グループデータベースへのアクセスを提供する
     モジュール。

  "spwd" モジュール
     このモジュールと類似の、シャドウパスワードデータベースへのインタ
     フェース。
