"pwd" --- 密碼資料庫
********************

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

此模組提供對 Unix 使用者帳戶和密碼資料庫的存取介面。它適用於所有 Unix
版本。

可用性: Unix, not WASI, not iOS.

密碼資料庫條目被報告為類似元組的物件 (tuple-like object)，其屬性會對應
於 "passwd" 結構的成員（屬性欄位請見下面的 "<pwd.h>"）：

+---------+-----------------+-------------------------------+
| 索引    | 屬性            | 意義                          |
|=========|=================|===============================|
| 0       | "pw_name"       | 登錄名                        |
+---------+-----------------+-------------------------------+
| 1       | "pw_passwd"     | 可選的加密密碼                |
+---------+-----------------+-------------------------------+
| 2       | "pw_uid"        | 數值的使用者 ID               |
+---------+-----------------+-------------------------------+
| 3       | "pw_gid"        | 數值的群組 ID                 |
+---------+-----------------+-------------------------------+
| 4       | "pw_gecos"      | 使用者名稱或註解欄位          |
+---------+-----------------+-------------------------------+
| 5       | "pw_dir"        | 使用者主目錄 (home directory) |
+---------+-----------------+-------------------------------+
| 6       | "pw_shell"      | 使用者命令直譯器              |
+---------+-----------------+-------------------------------+

uid 和 gid 項目為整數，其他項目都是字串。如果找不到請求的條目，則會引
發 "KeyError"。

備註:

  在傳統的 Unix 中，"pw_passwd" 欄位通常包含一個使用 DES 衍生演算法加
  密的密碼。然而，大多數現代 Unix 是使用所謂的 *shadow password* 系統
  。在那些 Unix 上，*pw_passwd* 欄位僅包含一個星號 ("'*'") 或字母
  "'x'"，其中加密密碼儲存在非全域可讀的 (not world readable)
  "/etc/shadow" 檔案中。*pw_passwd* 欄位是否包含任何有用的內容取決於系
  統。

它定義了以下項目：

pwd.getpwuid(uid)

   回傳給定數值使用者 ID 的密碼資料庫條目。

pwd.getpwnam(name)

   回傳給定使用者名稱的密碼資料庫條目。

pwd.getpwall()

   以任意順序回傳所有可用密碼資料庫條目的 list。

也參考:

  "grp" 模組
     群組資料庫的介面，與此模組類似。
