# `pwd` --- 密碼資料庫

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

可用性: Unix, 非 Emscripten, 非 WASI。

密碼資料庫條目被報告為類似元組的物件 (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 衍生演算法加密的密碼（參見模組 `crypt`）。然而，大多數現代 Unix 是使用所謂的 shadow password 系統。在那些 Unix 上，pw_passwd 欄位僅包含一個星號 (`'*'`) 或字母 `'x'`，其中加密密碼存儲在非全域可讀的 (not world readable) `/etc/shadow` 文件中。 pw_passwd 欄位是否包含任何有用的內容取決於系統。如果可用，應該要在需要存取加密密碼的地方使用 `spwd` 模組。

它定義了以下項目：

pwd.getpwuid(uid)

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

pwd.getpwnam(name)

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

pwd.getpwall()

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

也參考

`grp` 模組

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

`spwd` 模組

  Shadow 密碼資料庫的介面，與此模組類似。