'\" t .\" Title: groupmod .\" Author: Julianne Frances Haugh .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 07/30/2026 .\" Manual: دستورهای مدیریت سیستم (System Management Commands) .\" Source: shadow-utils 4.20.0 .\" Language: Persian .\" .TH "GROUPMOD" "8" "07/30/2026" "shadow\-utils 4\&.20\&.0" "دستورهای مدیریت سیستم (System Management Commands)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" groupmod \- ویرایش و اصلاح یک گروه در سیستم .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBgroupmod\fR\ 'u \fBgroupmod\fR [\fIoptions\fR] \fIGROUP\fR .SH "توضیحات (DESCRIPTION)" .PP دستور \fBgroupmod\fR با تغییر مدخل مربوطه در پایگاه‌داده گروه، مشخصات گروه تعیین‌شده \fIGROUP\fR را اصلاح می‌کند\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌هایی که برای دستور \fBgroupmod\fR اعمال می‌شوند عبارتند از: .PP \fB\-a\fR, \fB\-\-append\fR .RS 4 اگر اعضای گروه با \fB\-U\fR مشخص شده باشند، آنها را به فهرست اعضای موجود اضافه می‌کند، به جای اینکه آن را جایگزین نماید\&. .RE .PP \fB\-g\fR, \fB\-\-gid\fR\ \&\fIGID\fR .RS 4 شناسه گروه (ID) گروه مشخص‌شده \fIGROUP\fR به \fIGID\fR تغییر خواهد یافت\&. .sp مقدار \fIGID\fR باید یک عدد صحیح دهدهی غیر منفی باشد\&. این مقدار باید یکتا باشد، مگر اینکه از گزینه \fB\-o\fR استفاده شود\&. .sp کاربرانی که از این گروه به عنوان گروه اصلی (primary group) استفاده می‌کنند، به‌روزرسانی خواهند شد تا این گروه همچنان گروه اصلی آنها باقی بماند\&. .sp هر فایلی که دارای شناسه گروه قدیمی باشد و باید همچنان متعلق به \fIGROUP\fR باشد، باید شناسه گروه آن به صورت دستی تغییر داده شود\&. .sp هیچ بررسی و کنترلی نسبت به مقادیر \fBGID_MIN\fR، \fBGID_MAX\fR، \fBSYS_GID_MIN\fR یا \fBSYS_GID_MAX\fR از فایل /etc/login\&.defs انجام نخواهد شد\&. .RE .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 نمایش پیام راهنما و خروج\&. .RE .PP \fB\-n\fR, \fB\-\-new\-name\fR\ \&\fINEW_GROUP\fR .RS 4 نام گروه از \fIGROUP\fR به نام \fINEW_GROUP\fR تغییر خواهد یافت\&. .RE .PP \fB\-o\fR, \fB\-\-non\-unique\fR .RS 4 هنگامی که همراه با گزینه \fB\-g\fR استفاده شود، اجازه می‌دهد که \fIGID\fR گروه به یک مقدار غیر یکتا تغییر یابد\&. .RE .PP \fB\-p\fR, \fB\-\-password\fR\ \&\fIPASSWORD\fR .RS 4 رمز عبور رمزگذاری‌شده، همان‌طور که توسط \fBcrypt\fR(3) بازگردانده می‌شود\&. .sp \fBتوجه:\fR این گزینه توصیه نمی‌شود زیرا رمز عبور (یا رمز عبور رمزگذاری‌شده) برای کاربرانی که فرآیندها را فهرست می‌کنند قابل مشاهده خواهد بود\&. .sp باید اطمینان حاصل کنید که رمز عبور از خط‌مشی رمز عبور سیستم پیروی می‌کند\&. .RE .PP \fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR .RS 4 اعمال تغییرات در دایرکتوری \fICHROOT_DIR\fR و استفاده از فایل‌های پیکربندی از دایرکتوری \fICHROOT_DIR\fR\&. تنها مسیرهای مطلق پشتیبانی می‌شوند\&. از SELINUX پشتیبانی نمی‌شود\&. .RE .PP \fB\-P\fR, \fB\-\-prefix\fR\ \&\fIPREFIX_DIR\fR .RS 4 اعمال تغییرات در دایرکتوری \fIPREFIX_DIR\fR و استفاده از فایل‌های پیکربندی از دایرکتوری \fIPREFIX_DIR\fR\&. این گزینه chroot نمی‌کند و برای آماده‌سازی یک مقصد کامپایل چندسکویی (cross-compilation) در نظر گرفته شده است\&. برخی محدودیت‌ها: کاربران/گروه‌های NIS و LDAP بررسی نمی‌شوند\&. احراز هویت PAM از فایل‌های سیستم میزبان استفاده می‌کند\&. از SELINUX پشتیبانی نمی‌شود\&. .RE .PP \fB\-U\fR, \fB\-\-users\fR .RS 4 فهرستی از نام‌های کاربری جداشده با کاما برای اضافه شدن به عنوان اعضای گروه\&. .sp رفتار پیش‌فرض (در صورتی که گزینه‌های \fB\-g\fR و \fB\-U\fR مشخص نشده باشند) توسط متغیر \fBUSERGROUPS_ENAB\fR در /etc/login\&.defs تعیین می‌شود\&. .RE .SH "پیکربندی (CONFIGURATION)" .PP متغیرهای پیکربندی زیر در /etc/login\&.defs رفتار این ابزار را تغییر می‌دهند: .PP \fBMAX_MEMBERS_PER_GROUP\fR (number) .RS 4 حداکثر تعداد اعضا در هر مدخل گروه\&. هنگامی که به حداکثر رسید، یک مدخل گروه جدید (خط جدید) در /etc/group آغاز می‌شود (با همان نام، همان رمز عبور و همان GID)\&. .sp مقدار پیش‌فرض 0 است، به این معنی که هیچ محدودیتی در تعداد اعضای یک گروه وجود ندارد\&. .sp این ویژگی (گروه تفکیک‌شده) اجازه می‌دهد تا طول خطوط در فایل گروه محدود شود\&. این قابلیت برای اطمینان از اینکه خطوط مربوط به گروه‌های NIS بزرگتر از ۱۰۲۴ نویسه نباشند مفید است\&. .sp اگر نیاز به اعمال چنین محدودیتی دارید، می‌توانید از 25 استفاده کنید\&. .sp توجه: ممکن است گروه‌های تفکیک‌شده توسط همه ابزارها پشتیبانی نشوند (حتی در مجموعه ابزار Shadow)\&. نباید از این متغیر استفاده کنید مگر اینکه واقعاً به آن نیاز داشته باشید\&. .RE .SH "فایل‌ها (FILES)" .PP /etc/group .RS 4 اطلاعات حساب‌های گروه\&. .RE .PP /etc/gshadow .RS 4 اطلاعات امن حساب‌های گروه\&. .RE .PP /etc/login\&.defs .RS 4 پیکربندی مجموعه رمز عبور Shadow\&. .RE .PP /etc/passwd .RS 4 اطلاعات حساب‌های کاربری\&. .RE .SH "کدهای خروج (EXIT VALUES)" .PP دستور \fBgroupmod\fR با مقادیر زیر خارج می‌شود: .PP \fI0\fR .RS 4 E_SUCCESS: موفقیت .RE .PP \fI2\fR .RS 4 E_USAGE: نحو نامعتبر دستور .RE .PP \fI3\fR .RS 4 E_BAD_ARG: آرگومان نامعتبر برای گزینه .RE .PP \fI4\fR .RS 4 E_GID_IN_USE: شناسه گروه در حال حاضر استفاده می‌شود .RE .PP \fI6\fR .RS 4 E_NOTFOUND: گروه مشخص‌شده وجود ندارد .RE .PP \fI9\fR .RS 4 E_NAME_IN_USE: نام گروه در حال حاضر استفاده می‌شود .RE .PP \fI10\fR .RS 4 E_GRP_UPDATE: عدم امکان به‌روزرسانی فایل گروه .RE .PP \fI11\fR .RS 4 E_CLEANUP_SERVICE: عدم امکان راه‌اندازی سرویس پاک‌سازی (cleanup service) .RE .PP \fI12\fR .RS 4 E_PAM_USERNAME: عدم امکان تشخیص نام کاربری شما برای استفاده در PAM .RE .PP \fI13\fR .RS 4 E_PAM_ERROR: خطای بازگردانده شده از سوی PAM؛ برای مشاهده پیام خطای PAM شناسه تسهیلات (facility id) با عنوان groupmod را در syslog بررسی کنید .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBchfn\fR(1), \fBchsh\fR(1), \fBpasswd\fR(1), \fBgpasswd\fR(8), \fBgroupadd\fR(8), \fBgroupdel\fR(8), \fBlogin.defs\fR(5), \fBuseradd\fR(8), \fBuserdel\fR(8), \fBusermod\fR(8)\&.