grp --- 群組資料庫


該模組提供對 Unix 群組資料庫的存取, 所有 Unix 版本皆可使用。

適用: Unix, not WASI, not Android, not iOS.

群組資料庫條目以類似 tuple 物件的方式報傳入, 其屬性對應於 group 結構的成員(屬性欄位如下, 請參閱 <grp.h>):

索引

屬性

含義

0

gr_name

群組名稱

1

gr_passwd

(被加密後的)群組密碼;大部分情況下是空的

2

gr_gid

群組的數字 ID

3

gr_mem

所有群組成員的使用者名稱

gid 是整數,name 和 password 是字串, 而 member list 是字串串列。(請注意, 根據密碼資料庫, 大多數使用者並未被明確列為其所在群組的成員。 請檢查這兩個資料庫,以取得完整的成員資訊。 另外請注意,以 +- 開頭的 gr_name 很可能是 YP/NIS 參照,可能無法透過 getgrnam()getgrgid() 取得)。

它定義了以下項目:

grp.getgrgid(id)

回傳給定群組 ID 的群組資料庫條目。 KeyError 會在找不到所要求的條目時被引發。

在 3.10 版的變更: TypeError 會在非整數的引數如浮點數或字串被傳入時被引發。

grp.getgrnam(name)

回傳給定群組名稱的群組資料庫條目。 KeyError 會在找不到所要求的條目時引發。

grp.getgrall()

以任意順序傳回所有可用群組條目的串列。

也參考

pwd 模組

使用者資料庫的介面,與此類似。