GROUPMOD(8) دستورهای مدیریت سیستم (System Management Commands) GROUPMOD(8)

groupmod - ویرایش و اصلاح یک گروه در سیستم

groupmod [options] GROUP

دستور groupmod با تغییر مدخل مربوطه در پایگاه‌داده گروه، مشخصات گروه تعیین‌شده GROUP را اصلاح می‌کند.

گزینه‌هایی که برای دستور groupmod اعمال می‌شوند عبارتند از:

-a, --append

اگر اعضای گروه با -U مشخص شده باشند، آنها را به فهرست اعضای موجود اضافه می‌کند، به جای اینکه آن را جایگزین نماید.

-g, --gid GID

شناسه گروه (ID) گروه مشخص‌شده GROUP به GID تغییر خواهد یافت.

مقدار GID باید یک عدد صحیح دهدهی غیر منفی باشد. این مقدار باید یکتا باشد، مگر اینکه از گزینه -o استفاده شود.

کاربرانی که از این گروه به عنوان گروه اصلی (primary group) استفاده می‌کنند، به‌روزرسانی خواهند شد تا این گروه همچنان گروه اصلی آنها باقی بماند.

هر فایلی که دارای شناسه گروه قدیمی باشد و باید همچنان متعلق به GROUP باشد، باید شناسه گروه آن به صورت دستی تغییر داده شود.

هیچ بررسی و کنترلی نسبت به مقادیر GID_MIN، GID_MAX، SYS_GID_MIN یا SYS_GID_MAX از فایل /etc/login.defs انجام نخواهد شد.

-h, --help

نمایش پیام راهنما و خروج.

-n, --new-name NEW_GROUP

نام گروه از GROUP به نام NEW_GROUP تغییر خواهد یافت.

-o, --non-unique

هنگامی که همراه با گزینه -g استفاده شود، اجازه می‌دهد که GID گروه به یک مقدار غیر یکتا تغییر یابد.

-p, --password PASSWORD

رمز عبور رمزگذاری‌شده، همان‌طور که توسط crypt(3) بازگردانده می‌شود.

توجه: این گزینه توصیه نمی‌شود زیرا رمز عبور (یا رمز عبور رمزگذاری‌شده) برای کاربرانی که فرآیندها را فهرست می‌کنند قابل مشاهده خواهد بود.

باید اطمینان حاصل کنید که رمز عبور از خط‌مشی رمز عبور سیستم پیروی می‌کند.

-R, --root CHROOT_DIR

اعمال تغییرات در دایرکتوری CHROOT_DIR و استفاده از فایل‌های پیکربندی از دایرکتوری CHROOT_DIR. تنها مسیرهای مطلق پشتیبانی می‌شوند. از SELINUX پشتیبانی نمی‌شود.

-P, --prefix PREFIX_DIR

اعمال تغییرات در دایرکتوری PREFIX_DIR و استفاده از فایل‌های پیکربندی از دایرکتوری PREFIX_DIR. این گزینه chroot نمی‌کند و برای آماده‌سازی یک مقصد کامپایل چندسکویی (cross-compilation) در نظر گرفته شده است. برخی محدودیت‌ها: کاربران/گروه‌های NIS و LDAP بررسی نمی‌شوند. احراز هویت PAM از فایل‌های سیستم میزبان استفاده می‌کند. از SELINUX پشتیبانی نمی‌شود.

-U, --users

فهرستی از نام‌های کاربری جداشده با کاما برای اضافه شدن به عنوان اعضای گروه.

رفتار پیش‌فرض (در صورتی که گزینه‌های -g و -U مشخص نشده باشند) توسط متغیر USERGROUPS_ENAB در /etc/login.defs تعیین می‌شود.

متغیرهای پیکربندی زیر در /etc/login.defs رفتار این ابزار را تغییر می‌دهند:

MAX_MEMBERS_PER_GROUP (number)

حداکثر تعداد اعضا در هر مدخل گروه. هنگامی که به حداکثر رسید، یک مدخل گروه جدید (خط جدید) در /etc/group آغاز می‌شود (با همان نام، همان رمز عبور و همان GID).

مقدار پیش‌فرض 0 است، به این معنی که هیچ محدودیتی در تعداد اعضای یک گروه وجود ندارد.

این ویژگی (گروه تفکیک‌شده) اجازه می‌دهد تا طول خطوط در فایل گروه محدود شود. این قابلیت برای اطمینان از اینکه خطوط مربوط به گروه‌های NIS بزرگتر از ۱۰۲۴ نویسه نباشند مفید است.

اگر نیاز به اعمال چنین محدودیتی دارید، می‌توانید از 25 استفاده کنید.

توجه: ممکن است گروه‌های تفکیک‌شده توسط همه ابزارها پشتیبانی نشوند (حتی در مجموعه ابزار Shadow). نباید از این متغیر استفاده کنید مگر اینکه واقعاً به آن نیاز داشته باشید.

/etc/group

اطلاعات حساب‌های گروه.

/etc/gshadow

اطلاعات امن حساب‌های گروه.

/etc/login.defs

پیکربندی مجموعه رمز عبور Shadow.

/etc/passwd

اطلاعات حساب‌های کاربری.

دستور groupmod با مقادیر زیر خارج می‌شود:

0

E_SUCCESS: موفقیت

2

E_USAGE: نحو نامعتبر دستور

3

E_BAD_ARG: آرگومان نامعتبر برای گزینه

4

E_GID_IN_USE: شناسه گروه در حال حاضر استفاده می‌شود

6

E_NOTFOUND: گروه مشخص‌شده وجود ندارد

9

E_NAME_IN_USE: نام گروه در حال حاضر استفاده می‌شود

10

E_GRP_UPDATE: عدم امکان به‌روزرسانی فایل گروه

11

E_CLEANUP_SERVICE: عدم امکان راه‌اندازی سرویس پاک‌سازی (cleanup service)

12

E_PAM_USERNAME: عدم امکان تشخیص نام کاربری شما برای استفاده در PAM

13

E_PAM_ERROR: خطای بازگردانده شده از سوی PAM؛ برای مشاهده پیام خطای PAM شناسه تسهیلات (facility id) با عنوان groupmod را در syslog بررسی کنید

chfn(1), chsh(1), passwd(1), gpasswd(8), groupadd(8), groupdel(8), login.defs(5), useradd(8), userdel(8), usermod(8).

07/30/2026 shadow-utils 4.20.0