grp --- پایگاه داده گروه


این ماژول دسترسی به پایگاه داده‌ی گروه یونیکس را فراهم می‌کند. این ماژول در همه‌ی نسخه‌های یونیکس در دسترس است.

دسترس‌پذیری: Unix, not WASI, not Android, not iOS.

ورودی‌های پایگاه داده‌ی گروه به‌صورت یک شیء تاپل‌مانند گزارش می‌شوند که ویژگی‌های آن با اعضای ساختار group متناظر هستند (فیلد ویژگی در زیر، <grp.h> را ببینید):

اندیس

ویژگی

معنی

0

gr_name

نام گروه

1

gr_passwd

گذرواژه گروه (رمزنگاری‌شده)؛ معمولاً خالی

2

gr_gid

شناسه‌ی عددی گروه

3

gr_mem

تمام نام‌های کاربری عضو گروه

gid یک عدد صحیح است، نام و گذرواژه رشته‌اند، و فهرست اعضا فهرستی از رشته‌ها است. (توجه داشته باشید که بیشتر کاربران به‌صراحت به‌عنوان اعضای گروهی که بر اساس پایگاه داده‌ی گذرواژه در آن قرار دارند، فهرست نشده‌اند. برای دریافت اطلاعات کامل عضویت، هر دو پایگاه داده را بررسی کنید. همچنین توجه داشته باشید که gr_name که با + یا - شروع می‌شود، احتمالاً یک ارجاع YP/NIS است و ممکن است از طریق getgrnam() یا getgrgid() قابل دسترسی نباشد.)

آیتم‌های زیر را تعریف می‌کند:

grp.getgrgid(id)

بازگرداندن ورودی پایگاه داده‌ی گروه برای شناسه‌ی گروه عددی داده‌شده. اگر ورودی درخواست‌شده یافت نشود، KeyError پرتاب می‌شود.

تغییر یافته در نسخه‌ی 3.10: استثنای TypeError برای آرگومان‌هایی که عدد صحیح نیستند، مانند اعداد اعشاری یا رشته‌ها پرتاب می‌شود.

grp.getgrnam(name)

مدخل پایگاه داده‌ی گروه برای نام گروه داده‌شده را بازمی‌گرداند. اگر مدخل درخواست‌شده یافت نشود، KeyError پرتاب می‌شود.

grp.getgrall()

فهرستی از تمام ورودی‌های گروه موجود را، با ترتیبی دلخواه، برمی‌گرداند.

همچنین ملاحظه نمائید

ماژول pwd

رابطی برای پایگاه داده کاربر، مشابه این.