'\" t
.\"     Title: groupadd
.\"    Author: Julianne Frances Haugh
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 12/14/2025
.\"    Manual: System Management Commands
.\"    Source: shadow-utils 4.13
.\"  Language: Persian
.\"
.TH "GROUPADD" "8" "12/14/2025" "shadow\-utils 4\&.13" "دستورهای مدیریت سیستم (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)"
groupadd \- ایجاد یک گروه جدید
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBgroupadd\fR\ 'u
\fBgroupadd\fR [\fIOPTIONS\fR] \fINEWGROUP\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBgroupadd\fR
یک حساب گروهی جدید با استفاده از مقادیر مشخص‌شده در خط فرمان به همراه مقادیر پیش‌فرض سیستم ایجاد می‌کند\&. گروه جدید در صورت نیاز در فایل‌های سیستم ثبت خواهد شد\&.
.PP
نام‌های گروه تنها می‌توانند شامل حروف کوچک و بزرگ، ارقام، زیرخط (underscore) یا خط تیره (dash) باشند\&. آن‌ها می‌توانند با علامت دلار پایان یابند\&. استفاده از خط تیره در ابتدای نام گروه مجاز نیست\&. نام‌های گروه کاملاً عددی و نام‌های گروه \&. یا \&.\&. نیز مجاز نیستند\&.
.PP
در دبیان، تنها محدودیت‌ها این است که نام‌های گروه نباید با خط تیره (\*(Aq\-\*(Aq)، مثبت (\*(Aq+\*(Aq) یا مدک (\*(Aq~\*(Aq) آغاز شوند و نباید حاوی دو نقطه (\*(Aq:\*(Aq)، کاما (\*(Aq,\*(Aq) یا فاصله خالی (فاصله: \*(Aq \*(Aq، پایان خط: \*(Aq\en\*(Aq، تب: \*(Aq\et\*(Aq، و غیره) باشند\&.
.PP
طول نام‌های گروه تنها می‌تواند تا ۳۲ نویسه باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌هایی که برای دستور
\fBgroupadd\fR
اعمال می‌شوند عبارتند از:
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
این گزینه باعث می‌شود که در صورت وجود داشتن گروه مشخص‌شده، دستور به سادگی با وضعیت موفقیت‌آمیز خارج شود\&. هنگامی که با
\fB\-g\fR
استفاده شود و GID مشخص‌شده از قبل وجود داشته باشد، یک GID دیگر (یکتا) انتخاب می‌شود (یعنی
\fB\-g\fR
غیرفعال می‌شود)\&.
.RE
.PP
\fB\-g\fR, \fB\-\-gid\fR\ \&\fIGID\fR
.RS 4
مقدار عددی شناسه گروه (ID)\&.
\fIGID\fR
باید یکتا باشد، مگر اینکه از گزینه
\fB\-o\fR
استفاده شود\&. مقدار باید غیر منفی باشد\&. حالت پیش‌فرض استفاده از کوچک‌ترین مقدار شناسه‌ای است که بزرگ‌تر یا مساوی
\fBGID_MIN\fR
و بزرگ‌تر از تمام گروه‌های دیگر باشد\&.
.sp
همچنین گزینه
\fB\-r\fR
و توضیحات
\fBGID_MAX\fR
را ببینید\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش پیام راهنما و خروج\&.
.RE
.PP
\fB\-K\fR, \fB\-\-key\fR\ \&\fIKEY\fR=\fIVALUE\fR
.RS 4
بازنویسی پیش‌فرض‌های
/etc/login\&.defs
(شامل GID_MIN، GID_MAX و موارد دیگر)\&. می‌توان چندین گزینه
\fB\-K\fR
را مشخص کرد\&.
.sp
مثال:
\fB\-K\fR\ \&\fIGID_MIN\fR=\fI100\fR\ \&
\fB\-K\fR\ \&\fIGID_MAX\fR=\fI499\fR
.sp
توجه:
\fB\-K\fR\ \&\fIGID_MIN\fR=\fI10\fR,\fIGID_MAX\fR=\fI499\fR
هنوز کار نمی‌کند\&.
.RE
.PP
\fB\-o\fR, \fB\-\-non\-unique\fR
.RS 4
اجازه ایجاد گروه با شناسه عددی از پیش استفاده‌شده را می‌دهد\&. در نتیجه، برای این
\fIGID\fR، نگاشت به گروه
\fINEWGROUP\fR
ممکن است یکتا نباشد\&.
.RE
.PP
\fB\-p\fR, \fB\-\-password\fR\ \&\fIPASSWORD\fR
.RS 4
یک رمز عبور اولیه برای حساب گروه تعریف می‌کند\&. انتظار می‌رود PASSWORD همان‌طور که توسط
\fBcrypt \fR(3)
بازگردانده می‌شود، رمزگذاری شده باشد\&.
.sp
بدون این گزینه، حساب گروه قفل خواهد بود و هیچ رمز عبوری تعریف نمی‌شود، یعنی یک علامت تعجب منفرد در فیلد مربوطه در فایل حساب‌های سیستم
/etc/group
یا
/etc/gshadow\&.
.sp
\fBتوجه:\fR
این گزینه توصیه نمی‌شود زیرا رمز عبور (یا رمز عبور رمزگذاری‌شده) برای کاربرانی که فرآیندها را فهرست می‌کنند قابل مشاهده خواهد بود\&.
.sp
باید اطمینان حاصل کنید که رمز عبور از خط‌مشی رمز عبور سیستم پیروی می‌کند\&.
.RE
.PP
\fB\-r\fR, \fB\-\-system\fR
.RS 4
ایجاد یک گروه سیستمی\&.
.sp
شناسه‌های عددی گروه‌های سیستمی جدید در محدوده
\fBSYS_GID_MIN\fR\-\fBSYS_GID_MAX\fR
تعریف‌شده در
login\&.defs
به جای
\fBGID_MIN\fR\-\fBGID_MAX\fR
انتخاب می‌شوند\&.
.RE
.PP
\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR
.RS 4
اعمال تغییرات در شاخه
\fICHROOT_DIR\fR
و استفاده از فایل‌های پیکربندی از شاخه
\fICHROOT_DIR\fR\&.
فقط مسیرهای مطلق پشتیبانی می‌شوند\&.
.RE
.PP
\fB\-P\fR, \fB\-\-prefix\fR\ \&\fIPREFIX_DIR\fR
.RS 4
اعمال تغییرات روی فایل‌های پیکربندی تحت سیستم‌فایل ریشه موجود در شاخه
\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\-N\fR و
\fB\-U\fR
مشخص نشده باشند) توسط متغیر
\fBUSERGROUPS_ENAB\fR
در
/etc/login\&.defs
تعیین می‌شود\&.
.RE
.SH "پیکربندی (CONFIGURATION)"
.PP
متغیرهای پیکربندی زیر در
/etc/login\&.defs
رفتار این ابزار را تغییر می‌دهند:
.PP
\fBGID_MAX\fR (number), \fBGID_MIN\fR (number)
.RS 4
محدوده شناسه‌های گروه مورد استفاده برای ایجاد گروه‌های عادی توسط
\fBuseradd\fR،
\fBgroupadd\fR، یا
\fBnewusers\fR\&.
.sp
مقدار پیش‌فرض برای
\fBGID_MIN\fR
(به ترتیب
\fBGID_MAX\fR)
برابر ۱۰۰۰ (به ترتیب ۶۰۰۰۰) است\&.
.RE
.PP
\fBMAX_MEMBERS_PER_GROUP\fR (number)
.RS 4
حداکثر اعضا در هر مدخل گروه\&. هنگامی که به حداکثر رسید، یک مدخل گروه جدید (خط جدید) در
/etc/group
آغاز می‌شود (با همان نام، همان رمز عبور و همان GID)\&.
.sp
مقدار پیش‌فرض 0 است، به این معنی که هیچ محدودیتی در تعداد اعضای یک گروه وجود ندارد\&.
.sp
این ویژگی (گروه تفکیک‌شده) اجازه می‌دهد طول خطوط در فایل گروه محدود شود\&. این برای اطمینان از اینکه خطوط گروه‌های NIS طولانی‌تر از ۱۰۲۴ نویسه نباشند مفید است\&.
.sp
اگر نیاز به اعمال چنین محدودیتی دارید، می‌توانید از 25 استفاده کنید\&.
.sp
توجه: گروه‌های تفکیک‌شده ممکن است توسط همه ابزارها پشتیبانی نشوند (حتی در مجموعه ابزار Shadow)\&. نباید از این متغیر استفاده کنید مگر اینکه واقعاً به آن نیاز داشته باشید\&.
.RE
.PP
\fBSYS_GID_MAX\fR (number), \fBSYS_GID_MIN\fR (number)
.RS 4
محدوده شناسه‌های گروه مورد استفاده برای ایجاد گروه‌های سیستمی توسط
\fBuseradd\fR،
\fBgroupadd\fR، یا
\fBnewusers\fR\&.
.sp
مقدار پیش‌فرض برای
\fBSYS_GID_MIN\fR
(به ترتیب
\fBSYS_GID_MAX\fR)
برابر ۱۰۱ (به ترتیب
\fBGID_MIN\fR\-1)
است\&.
.RE
.SH "فایل‌ها (FILES)"
.PP
/etc/group
.RS 4
اطلاعات حساب‌های گروه\&.
.RE
.PP
/etc/gshadow
.RS 4
اطلاعات امن حساب‌های گروه\&.
.RE
.PP
/etc/login\&.defs
.RS 4
پیکربندی مجموعه رمز عبور Shadow\&.
.RE
.SH "هشدارها (CAVEATS)"
.PP
شما نمی‌توانید یک گروه NIS یا LDAP اضافه کنید\&. این کار باید روی سرور مربوطه انجام شود\&.
.PP
اگر نام گروه از قبل در یک پایگاه داده گروه خارجی مانند NIS یا LDAP وجود داشته باشد،
\fBgroupadd\fR
درخواست ایجاد گروه را رد خواهد کرد\&.
.SH "مقادیر خروج (EXIT VALUES)"
.PP
دستور
\fBgroupadd\fR
با مقادیر زیر خارج می‌شود:
.PP
\fI0\fR
.RS 4
موفقیت
.RE
.PP
\fI2\fR
.RS 4
نحو نامعتبر دستور
.RE
.PP
\fI3\fR
.RS 4
آرگومان نامعتبر برای گزینه
.RE
.PP
\fI4\fR
.RS 4
شناسه GID از قبل استفاده شده است (هنگام اجرا بدون
\fB\-o\fR)
.RE
.PP
\fI9\fR
.RS 4
نام گروه از قبل استفاده شده است
.RE
.PP
\fI10\fR
.RS 4
عدم امکان به‌روزرسانی فایل گروه
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBchfn\fR(1),
\fBchsh\fR(1),
\fBpasswd\fR(1),
\fBgpasswd\fR(8),
\fBgroupdel\fR(8),
\fBgroupmod\fR(8),
\fBlogin.defs\fR(5),
\fBuseradd\fR(8),
\fBuserdel\fR(8),
\fBusermod\fR(8)\&.