"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" モジュール
     このモジュールと類似の、シャドウパスワードデータベースへのインタ
     ーフェース。
