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

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

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

利用可能な環境: 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 のほとんどは、いわゆる *シャドウパスワード* の仕組みを使っていま
  す。 これらの OS では、*pw_passwd* フィールドにはアスタリスク
  ("'*'") または文字 "'x'" だけが入り、暗号化されたパスワードは誰でも
  読めるわけではない "/etc/shadow" ファイルに保存されます。
  *pw_passwd* フィールドに有用な情報が入っているかどうかはシステムに依
  存します。

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

pwd.getpwuid(uid)

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

pwd.getpwnam(name)

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

pwd.getpwall()

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

参考:

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