"pwd" --- パスワードデータベース
********************************

======================================================================

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

Availability: Unix, not WASI, not iOS.

パスワードデータベースの各エントリはタプルのようなオブジェクトで提供さ
れ、それぞれの属性は "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由来のアルゴリズムで暗
  号化されたパスワードが含まれています。しかし、近代的なUNIX系OSでは *
  シャドウパスワード* とよばれる仕組みを利用しています。この場合には
  *pw_passwd* フィールドにはアスタリスク("'*'")か、 "'x'" という一文字
  だけが含まれており、暗号化されたパスワードは、一般には見えない
  "/etc/shadow" というファイルに入っています。 *pw_passwd* フィールド
  に有用な値が入っているかはシステムに依存します。

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

pwd.getpwuid(uid)

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

pwd.getpwnam(name)

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

pwd.getpwall()

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

参考:

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