'\" t .\" Title: useradd .\" Author: Julianne Frances Haugh .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 12/14/2025 .\" Manual: دستورهای مدیریت سیستم (System Management Commands) .\" Source: shadow-utils 4.13 .\" Language: Persian .\" .TH "USERADD" "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)" useradd \- ایجاد یک کاربر جدید یا به‌روزرسانی اطلاعات پیش‌فرض کاربر جدید .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBuseradd\fR\ 'u \fBuseradd\fR [\fIoptions\fR] \fILOGIN\fR .HP \w'\fBuseradd\fR\ 'u \fBuseradd\fR \-D .HP \w'\fBuseradd\fR\ 'u \fBuseradd\fR \-D [\fIoptions\fR] .SH "توضیحات (DESCRIPTION)" .PP \fBuseradd\fR یک ابزار سطح پایین برای افزودن کاربران است\&. در دبیان، مدیران سیستم معمولاً باید به جای آن از \fBadduser\fR(8) استفاده کنند\&. .PP هنگامی که بدون گزینهٔ \fB\-D\fR فراخوانی شود، دستور \fBuseradd\fR یک حساب کاربری جدید با استفاده از مقادیر مشخص‌شده در خط فرمان به همراه مقادیر پیش‌فرض سیستم ایجاد می‌کند\&. بسته به گزینه‌های خط فرمان، دستور \fBuseradd\fR فایل‌های سیستم را به‌روزرسانی کرده و ممکن است دایرکتوری خانگی کاربر جدید را نیز ایجاد کند و فایل‌های اولیه را کپی نماید\&. .PP به‌طور پیش‌فرض، یک گروه نیز برای کاربر جدید ایجاد خواهد شد (گزینه‌های \fB\-g\fR، \fB\-N\fR، \fB\-U\fR و \fBUSERGROUPS_ENAB\fR را ببینید)\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌هایی که برای دستور \fBuseradd\fR اعمال می‌شوند عبارتند از: .PP \fB\-\-badname\fR\ \& .RS 4 اجازه دادن به نام‌هایی که با استانداردها مطابقت ندارند\&. .RE .PP \fB\-b\fR, \fB\-\-base\-dir\fR\ \&\fIBASE_DIR\fR .RS 4 دایرکتوری پایهٔ پیش‌فرض برای سیستم در صورتی که \fB\-d\fR\ \&\fIHOME_DIR\fR مشخص نشده باشد\&. \fIBASE_DIR\fR با نام حساب ترکیب می‌شود تا دایرکتوری خانگی را تعریف کند\&. .sp اگر این گزینه مشخص نشود، \fBuseradd\fR از دایرکتوری پایهٔ مشخص‌شده توسط متغیر \fBHOME\fR در /etc/default/useradd، یا به‌طور پیش‌فرض از /home استفاده خواهد کرد\&. .RE .PP \fB\-c\fR, \fB\-\-comment\fR\ \&\fICOMMENT\fR .RS 4 هر رشته متنی\&. معمولاً یک توضیح کوتاه از حساب است و در حال حاضر به عنوان فیلدی برای نام کامل کاربر استفاده می‌شود\&. .RE .PP \fB\-d\fR, \fB\-\-home\-dir\fR\ \&\fIHOME_DIR\fR .RS 4 کاربر جدید با استفاده از \fIHOME_DIR\fR به عنوان مقدار دایرکتوری ورود کاربر ایجاد خواهد شد\&. حالت پیش‌فرض، الحاق نام \fILOGIN\fR به \fIBASE_DIR\fR و استفاده از آن به عنوان نام دایرکتوری ورود است\&. اگر دایرکتوری \fIHOME_DIR\fR وجود نداشته باشد، ایجاد خواهد شد مگر اینکه گزینهٔ \fB\-M\fR مشخص شده باشد\&. .RE .PP \fB\-D\fR, \fB\-\-defaults\fR .RS 4 بخش فرعی "تغییر مقادیر پیش‌فرض" در زیر را ببینید\&. .RE .PP \fB\-e\fR, \fB\-\-expiredate\fR\ \&\fIEXPIRE_DATE\fR .RS 4 تاریخی که در آن حساب کاربری غیرفعال خواهد شد\&. تاریخ در قالب \fIYYYY\-MM\-DD\fR مشخص می‌شود\&. .sp در صورت مشخص نشدن، \fBuseradd\fR از تاریخ انقضای پیش‌فرض مشخص‌شده توسط متغیر \fBEXPIRE\fR در /etc/default/useradd، یا به‌طور پیش‌فرض از یک رشتهٔ خالی (بدون انقضا) استفاده خواهد کرد\&. .RE .PP \fB\-f\fR, \fB\-\-inactive\fR\ \&\fIINACTIVE\fR .RS 4 تعداد روزهای پس از پایان مهلت گذرواژه را تعیین می‌کند که کاربر در طی آن ملزم به تغییر این گذرواژه است\&. این مقدار در فایل گذرواژهٔ shadow ذخیره می‌شود\&. ورودی 0 گذرواژهٔ منقضی‌شده را بدون هیچ تأخیری غیرفعال می‌کند\&. ورودی \-1 فیلد مربوطه را در فایل گذرواژهٔ shadow خالی خواهد کرد\&. برای اطلاعات بیشتر \fBshadow\fR(5) را ببینید\&. .sp در صورت مشخص نشدن، \fBuseradd\fR از دورهٔ غیرفعال بودن پیش‌فرض مشخص‌شده توسط متغیر \fBINACTIVE\fR در /etc/default/useradd، یا به‌طور پیش‌فرض از \-1 استفاده خواهد کرد\&. .RE .PP \fB\-F\fR, \fB\-\-add\-subids\-for\-system\fR .RS 4 به‌روزرسانی /etc/subuid و /etc/subgid حتی هنگام ایجاد یک حساب سیستمی با گزینهٔ \fB\-r\fR\&. .RE .PP \fB\-g\fR, \fB\-\-gid\fR\ \&\fIGROUP\fR .RS 4 نام یا شمارهٔ گروه اصلی کاربر\&. نام گروه باید وجود داشته باشد\&. شمارهٔ گروه باید به یک گروه از قبل موجود اشاره کند\&. .sp در صورت مشخص نشدن، رفتار \fBuseradd\fR به متغیر \fBUSERGROUPS_ENAB\fR در /etc/login\&.defs بستگی خواهد داشت\&. اگر این متغیر روی \fIyes\fR تنظیم شده باشد (یا \fB\-U/\-\-user\-group\fR در خط فرمان مشخص شده باشد)، گروهی برای کاربر با همان نام ورود او ایجاد خواهد شد\&. اگر متغیر روی \fIno\fR تنظیم شده باشد (یا \fB\-N/\-\-no\-user\-group\fR در خط فرمان مشخص شده باشد)، useradd گروه اصلی کاربر جدید را روی مقدار مشخص‌شده توسط متغیر \fBGROUP\fR در /etc/default/useradd، یا به‌طور پیش‌فرض 100 تنظیم خواهد کرد\&. .RE .PP \fB\-G\fR, \fB\-\-groups\fR\ \&\fIGROUP1\fR[\fI,GROUP2,\&.\&.\&.\fR[\fI,GROUPN\fR]]] .RS 4 فهرستی از گروه‌های تکمیلی که کاربر نیز عضوی از آن‌ها است\&. هر گروه با یک کاما و بدون هیچ فاصلهٔ خالی از گروه بعدی جدا می‌شود\&. این گروه‌ها مشمول همان محدودیت‌های گروه ارائه‌شده با گزینهٔ \fB\-g\fR هستند\&. حالت پیش‌فرض این است که کاربر فقط به گروه اولیه تعلق داشته باشد\&. .RE .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 نمایش پیام راهنما و خروج\&. .RE .PP \fB\-k\fR, \fB\-\-skel\fR\ \&\fISKEL_DIR\fR .RS 4 دایرکتوری اسکلت (skeleton)، که حاوی فایل‌ها و دایرکتوری‌هایی است که باید در دایرکتوری خانگی کاربر کپی شوند، هنگامی که دایرکتوری خانگی توسط \fBuseradd\fR ایجاد می‌شود\&. .sp این گزینه تنها در صورتی معتبر است که گزینهٔ \fB\-m\fR (یا \fB\-\-create\-home\fR) مشخص شده باشد\&. .sp اگر این گزینه تنظیم نشود، دایرکتوری اسکلت توسط متغیر \fBSKEL\fR در /etc/default/useradd یا به‌طور پیش‌فرض /etc/skel تعریف می‌شود\&. .sp در صورت امکان، ACLها و ویژگی‌های توسعه‌یافته (extended attributes) کپی می‌شوند\&. .RE .PP \fB\-K\fR, \fB\-\-key\fR\ \&\fIKEY\fR=\fIVALUE\fR .RS 4 پیش‌فرض‌های /etc/login\&.defs را بازنویسی می‌کند (\fBUID_MIN\fR، \fBUID_MAX\fR، \fBUMASK\fR، \fBPASS_MAX_DAYS\fR و غیره)\&. .sp مثال: \fB\-K\fR\ \&\fIPASS_MAX_DAYS \fR=\fI\-1\fR می‌تواند هنگام ایجاد یک حساب کاربری برای خاموش کردن محدودیت زمانی گذرواژه (aging) استفاده شود\&. چندین گزینهٔ \fB\-K\fR می‌تواند مشخص شود، برای مثال: \fB\-K\fR\ \&\fIUID_MIN\fR =\fI100\fR\ \&\fB\-K\fR\ \& \fIUID_MAX\fR=\fI499\fR .sp برای سازگاری با نسخهٔ قبلی \fBuseradd\fR دبیان، گزینهٔ \fB\-O\fR نیز پشتیبانی می‌شود\&. .RE .PP \fB\-l\fR, \fB\-\-no\-log\-init\fR .RS 4 کاربر را به پایگاه‌های داده lastlog و faillog اضافه نمی‌کند\&. .sp به‌طور پیش‌فرض، مدخل‌های کاربر در پایگاه‌های داده lastlog و faillog بازنشانی می‌شوند تا از استفاده مجدد از مدخل یک کاربر حذف‌شده در گذشته جلوگیری شود\&. .sp اگر این گزینه مشخص نشود، \fBuseradd\fR همچنین متغیر \fBLOG_INIT\fR را در /etc/default/useradd بررسی خواهد کرد؛ اگر روی no تنظیم شده باشد، کاربر به پایگاه‌های داده lastlog و faillog اضافه نخواهد شد\&. .RE .PP \fB\-m\fR, \fB\-\-create\-home\fR .RS 4 ایجاد دایرکتوری خانگی کاربر در صورت عدم وجود\&. فایل‌ها و دایرکتوری‌های موجود در دایرکتوری اسکلت (که می‌تواند با گزینهٔ \fB\-k\fR تعریف شود) در دایرکتوری خانگی کپی خواهند شد\&. .sp به‌طور پیش‌فرض، اگر این گزینه مشخص نشود و \fBCREATE_HOME\fR فعال نباشد، هیچ دایرکتوری خانگی ایجاد نمی‌شود\&. .sp دایرکتوری‌ای که دایرکتوری خانگی کاربر در آن ایجاد می‌شود باید وجود داشته باشد و دارای بافتار SELinux و مجوزهای مناسب باشد\&. در غیر این صورت، دایرکتوری خانگی کاربر نمی‌تواند ایجاد شود یا در دسترس قرار گیرد\&. .RE .PP \fB\-M\fR, \fB\-\-no\-create\-home\fR .RS 4 عدم ایجاد دایرکتوری خانگی کاربر، حتی اگر تنظیم سراسری سیستم در /etc/login\&.defs (\fBCREATE_HOME\fR) روی \fIyes\fR تنظیم شده باشد\&. .RE .PP \fB\-N\fR, \fB\-\-no\-user\-group\fR .RS 4 گروهی با همان نام کاربر ایجاد نشود، بلکه کاربر به گروه مشخص‌شده با گزینهٔ \fB\-g\fR یا توسط متغیر \fBGROUP\fR در /etc/default/useradd اضافه شود\&. .sp رفتار پیش‌فرض (اگر گزینه‌های \fB\-g\fR، \fB\-N\fR و \fB\-U\fR مشخص نشده باشند) توسط متغیر \fBUSERGROUPS_ENAB\fR در /etc/login\&.defs تعریف می‌شود\&. .RE .PP \fB\-o\fR, \fB\-\-non\-unique\fR .RS 4 امکان ایجاد حسابی با یک UID از قبل موجود را فراهم می‌کند\&. .sp این گزینه تنها در ترکیب با گزینهٔ \fB\-u\fR معتبر است\&. از آنجا که هویت کاربر به عنوان کلیدی برای نگاشت بین کاربران از یک سو و مجوزها، مالکیت فایل‌ها و سایر جنبه‌هایی که رفتار سیستم را از سوی دیگر تعیین می‌کنند عمل می‌کند، بیش از یک نام ورود به حساب با UID مشخص دسترسی خواهد داشت\&. .RE .PP \fB\-p\fR, \fB\-\-password\fR\ \&\fIPASSWORD\fR .RS 4 یک گذرواژهٔ اولیه برای حساب تعیین می‌کند\&. انتظار می‌رود PASSWORD رمزگذاری‌شده باشد، همان‌طور که توسط \fBcrypt\fR(3) بازگردانده می‌شود\&. درون یک اسکریپت شل، این گزینه امکان ایجاد کارآمد دسته‌ای کاربران را فراهم می‌کند\&. .sp بدون این گزینه، حساب جدید قفل خواهد بود و هیچ گذرواژه‌ای برای آن تعریف نشده است، یعنی یک علامت تعجب تکی در فیلد مربوطه در /etc/shadow\&. این وضعیتی است که در آن کاربر قادر به دسترسی به حساب یا تعریف گذرواژه توسط خودش نخواهد بود\&. .sp \fBتوجه:\fR از این گزینه در خط فرمان خودداری کنید زیرا گذرواژه (یا گذرواژهٔ رمزگذاری‌شده) برای کاربرانی که پردازه‌ها را فهرست می‌کنند قابل مشاهده خواهد بود\&. .sp باید مطمئن شوید که گذرواژه با خط‌مشی گذرواژهٔ سیستم مطابقت دارد\&. .RE .PP \fB\-r\fR, \fB\-\-system\fR .RS 4 ایجاد یک حساب سیستمی\&. .sp کاربران سیستمی بدون اطلاعات انقضا و کهنگی در /etc/shadow ایجاد خواهند شد، و شناسه‌های عددی آن‌ها در محدودهٔ \fBSYS_UID_MIN\fR\-\fBSYS_UID_MAX\fR تعریف‌شده در /etc/login\&.defs انتخاب می‌شود، به جای \fBUID_MIN\fR\-\fBUID_MAX\fR (و مقادیر متناظر \fBGID\fR برای ایجاد گروه‌ها)\&. .sp توجه داشته باشید که \fBuseradd\fR صرف‌نظر از تنظیمات پیش‌فرض در /etc/login\&.defs (\fBCREATE_HOME\fR)، دایرکتوری خانگی برای چنین کاربری ایجاد نخواهد کرد\&. اگر می‌خواهید یک دایرکتوری خانگی برای یک حساب سیستمی ایجاد شود، باید گزینهٔ \fB\-m\fR را مشخص کنید\&. .sp توجه داشته باشید که این گزینه فایل‌های /etc/subuid و /etc/subgid را به‌روزرسانی نخواهد کرد\&. اگر می‌خواهید فایل‌ها برای یک حساب سیستمی که ایجاد می‌شود به‌روزرسانی شوند، باید گزینهٔ \fB\-F\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\-s\fR, \fB\-\-shell\fR\ \&\fISHELL\fR .RS 4 مسیر شل ورود کاربر را تعیین می‌کند\&. بدون این گزینه، سیستم از متغیر \fBSHELL\fR مشخص‌شده در /etc/default/useradd استفاده خواهد کرد، یا اگر آن هم تنظیم نشده باشد، فیلد شل ورود در /etc/passwd خالی می‌ماند\&. .RE .PP \fB\-u\fR, \fB\-\-uid\fR\ \&\fIUID\fR .RS 4 مقدار عددی شناسهٔ کاربر (ID)\&. این مقدار باید یکتا باشد، مگر اینکه از گزینهٔ \fB\-o\fR استفاده شود\&. مقدار باید غیر منفی باشد\&. حالت پیش‌فرض استفاده از کوچک‌ترین مقدار شناسه‌ای است که بزرگ‌تر یا مساوی \fBUID_MIN\fR و بزرگ‌تر از هر کاربر دیگری باشد\&. .sp همچنین گزینهٔ \fB\-r\fR و توضیحات \fBUID_MAX\fR را ببینید\&. .RE .PP \fB\-U\fR, \fB\-\-user\-group\fR .RS 4 ایجاد گروهی با همان نام کاربر، و افزودن کاربر به این گروه\&. .sp رفتار پیش‌فرض (اگر گزینه‌های \fB\-g\fR، \fB\-N\fR و \fB\-U\fR مشخص نشده باشند) توسط متغیر \fBUSERGROUPS_ENAB\fR در /etc/login\&.defs تعریف می‌شود\&. .RE .PP \fB\-Z\fR, \fB\-\-selinux\-user\fR\ \&\fISEUSER\fR .RS 4 کاربر SELinux را برای حساب جدید تعیین می‌کند\&. بدون این گزینه، SELinux از کاربر پیش‌فرض استفاده می‌کند\&. توجه داشته باشید که سیستم shadow مقدار selinux\-user را ذخیره نمی‌کند و برای این کار از \fBsemanage\fR(8) استفاده می‌نماید\&. .RE .SS "تغییر مقادیر پیش‌فرض (Changing the default values)" .PP هنگامی که فقط با گزینهٔ \fB\-D\fR فراخوانی شود، \fBuseradd\fR مقادیر پیش‌فرض فعلی را نمایش می‌دهد\&. هنگامی که با \fB\-D\fR به همراه گزینه‌های دیگر فراخوانی شود، \fBuseradd\fR مقادیر پیش‌فرض را برای گزینه‌های مشخص‌شده به‌روزرسانی خواهد کرد\&. گزینه‌های معتبر تغییر پیش‌فرض عبارتند از: .PP \fB\-b\fR, \fB\-\-base\-dir\fR\ \&\fIBASE_DIR\fR .RS 4 پیشوند مسیر را برای دایرکتوری خانگی یک کاربر جدید تعیین می‌کند\&. در صورتی که هنگام ایجاد یک حساب جدید از گزینهٔ \fB\-d\fR استفاده نشود، نام کاربر به انتهای \fIBASE_DIR\fR اضافه خواهد شد تا نام دایرکتوری خانگی کاربر جدید را تشکیل دهد\&. .sp این گزینه متغیر \fBHOME\fR را در /etc/default/useradd تنظیم می‌کند\&. .RE .PP \fB\-e\fR, \fB\-\-expiredate\fR\ \&\fIEXPIRE_DATE\fR .RS 4 تاریخی را تعیین می‌کند که در آن حساب‌های کاربری تازه‌ایجادشده غیرفعال می‌شوند\&. .sp این گزینه متغیر \fBEXPIRE\fR را در /etc/default/useradd تنظیم می‌کند\&. .RE .PP \fB\-f\fR, \fB\-\-inactive\fR\ \&\fIINACTIVE\fR .RS 4 تعداد روزهای پس از پایان مهلت گذرواژه را تعیین می‌کند که در طی آن از کاربر انتظار می‌رود این گذرواژه را تعویض کند\&. برای اطلاعات بیشتر \fBshadow\fR(5) را ببینید\&. .sp این گزینه متغیر \fBINACTIVE\fR را در /etc/default/useradd تنظیم می‌کند\&. .RE .PP \fB\-g\fR, \fB\-\-gid\fR\ \&\fIGROUP\fR .RS 4 گروه اصلی پیش‌فرض را برای کاربران تازه‌ایجادشده تعیین می‌کند، و نام‌های گروه یا یک شناسه عددی گروه (GID) را می‌پذیرد\&. گروه نام‌برده باید وجود داشته باشد، و GID باید یک مدخل موجود داشته باشد\&. .sp این گزینه متغیر \fBGROUP\fR را در /etc/default/useradd تنظیم می‌کند\&. .RE .PP \fB\-s\fR, \fB\-\-shell\fR\ \&\fISHELL\fR .RS 4 شل ورود پیش‌فرض را برای کاربران جدید تعیین می‌کند\&. .sp این گزینه متغیر \fBSHELL\fR را در /etc/default/useradd تنظیم می‌کند\&. .RE .SH "نکات (NOTES)" .PP مدیر سیستم مسئول قرار دادن فایل‌های پیش‌فرض کاربر در دایرکتوری /etc/skel/ (یا هر دایرکتوری اسکلت دیگری که در /etc/default/useradd یا در خط فرمان مشخص شده است) می‌باشد\&. .SH "هشدارها (CAVEATS)" .PP شما نمی‌توانید کاربری را به یک گروه NIS یا LDAP اضافه کنید\&. این کار باید روی سرور مربوطه انجام شود\&. .PP به طور مشابه، اگر نام کاربری از قبل در یک پایگاه داده خارجی کاربران مانند NIS یا LDAP وجود داشته باشد، \fBuseradd\fR درخواست ایجاد حساب کاربری را رد خواهد کرد\&. .PP نام‌های کاربری تنها می‌توانند شامل حروف کوچک و بزرگ، ارقام، زیرخط یا خط تیره باشند\&. آن‌ها می‌توانند با علامت دلار پایان یابند\&. استفاده از خط تیره در ابتدای نام کاربری مجاز نیست\&. نام‌های کاربری کاملاً عددی و نام‌های کاربری \&. یا \&.\&. نیز مجاز نیستند\&. استفاده از نام‌های کاربری که با نویسهٔ \&. شروع می‌شوند توصیه نمی‌شود زیرا دایرکتوری‌های خانگی آن‌ها در خروجی \fBls\fR پنهان خواهد شد\&. .PP در دبیان، تنها محدودیت‌ها این است که نام‌های کاربری نباید با خط تیره (\*(Aq\-\*(Aq)، مثبت (\*(Aq+\*(Aq) یا مدک (\*(Aq~\*(Aq) آغاز شوند و نباید حاوی دو نقطه (\*(Aq:\*(Aq)، کاما (\*(Aq,\*(Aq) یا فاصله خالی (فاصله: \*(Aq \*(Aq، پایان خط: \*(Aq\en\*(Aq، تب: \*(Aq\et\*(Aq، و غیره) باشند\&. توجه داشته باشید که استفاده از اسلش (\*(Aq/\*(Aq) ممکن است الگوریتم پیش‌فرض برای تعریف دایرکتوری خانگی کاربر را مختل کند\&. .PP طول نام‌های کاربری تنها می‌تواند تا ۳۲ نویسه باشد\&. .SH "پیکربندی (CONFIGURATION)" .PP متغیرهای پیکربندی زیر در /etc/login\&.defs رفتار این ابزار را تغییر می‌دهند: .PP \fBCREATE_HOME\fR (boolean) .RS 4 مشخص می‌کند که آیا یک دایرکتوری خانگی باید به‌طور پیش‌فرض برای کاربران جدید ایجاد شود یا خیر\&. .sp این تنظیم برای کاربران سیستمی اعمال نمی‌شود و می‌تواند در خط فرمان بازنویسی شود\&. .RE .PP \fBGID_MAX\fR (number), \fBGID_MIN\fR (number) .RS 4 محدوده شناسه‌های گروه (GID) استفاده‌شده برای ایجاد گروه‌های عادی توسط \fBuseradd\fR، \fBgroupadd\fR، یا \fBnewusers\fR\&. .sp مقدار پیش‌فرض برای \fBGID_MIN\fR (به ترتیب \fBGID_MAX\fR) 1000 (به ترتیب 60000) است\&. .RE .PP \fBHOME_MODE\fR (number) .RS 4 حالت دسترسی (mode) برای دایرکتوری‌های خانگی جدید\&. در صورت مشخص نشدن، از \fBUMASK\fR برای ایجاد حالت استفاده می‌شود\&. .sp \fBuseradd\fR و \fBnewusers\fR از این متغیر برای تنظیم حالت دسترسی دایرکتوری خانگی‌ای که ایجاد می‌کنند استفاده می‌نمایند\&. .RE .PP \fBLASTLOG_UID_MAX\fR (number) .RS 4 بالاترین شماره شناسه کاربری (UID) که مدخل‌های lastlog باید برای آن به‌روزرسانی شوند\&. از آنجا که شناسه‌های کاربری بالاتر معمولاً توسط خدمات راه دور احراز هویت و هویت کاربر ردیابی می‌شوند، نیازی به ایجاد یک فایل پراکنده (sparse) بزرگ lastlog برای آن‌ها وجود ندارد\&. .sp نبود گزینهٔ \fBLASTLOG_UID_MAX\fR در پیکربندی به این معنی است که هیچ محدودیتی در شناسه کاربری برای نوشتن مدخل‌های lastlog وجود ندارد\&. .RE .PP \fBMAIL_DIR\fR (string) .RS 4 دایرکتوری صف دریافت ایمیل (mail spool)\&. این دایرکتوری برای دستکاری صندوق پستی در زمانی که حساب کاربری متناظر با آن اصلاح یا حذف می‌شود، مورد نیاز است\&. در صورت مشخص نشدن، از یک مقدار پیش‌فرض در زمان کامپایل استفاده می‌شود\&. پارامتر CREATE_MAIL_SPOOL در /etc/default/useradd تعیین می‌کند که آیا صف ایمیل باید ایجاد شود یا خیر\&. .RE .PP \fBMAIL_FILE\fR (string) .RS 4 مکان فایل‌های صف ایمیل کاربران را نسبت به دایرکتوری خانگی آن‌ها تعریف می‌کند\&. .RE .PP متغیرهای \fBMAIL_DIR\fR و \fBMAIL_FILE\fR توسط \fBuseradd\fR، \fBusermod\fR، و \fBuserdel\fR برای ایجاد، انتقال یا حذف صف دریافت ایمیل کاربر استفاده می‌شوند\&. .PP \fBMAX_MEMBERS_PER_GROUP\fR (number) .RS 4 حداکثر اعضا در هر مدخل گروه\&. هنگامی که به حداکثر رسید، یک مدخل گروه جدید (خط جدید) در /etc/group آغاز می‌شود (با همان نام، همان گذرواژه و همان GID)\&. .sp مقدار پیش‌فرض 0 است، به این معنی که هیچ محدودیتی در تعداد اعضای یک گروه وجود ندارد\&. .sp این ویژگی (گروه تفکیک‌شده) اجازه می‌دهد طول خطوط در فایل گروه محدود شود\&. این برای اطمینان از اینکه خطوط گروه‌های NIS طولانی‌تر از 1024 نویسه نباشند مفید است\&. .sp اگر نیاز به اعمال چنین محدودیتی دارید، می‌توانید از 25 استفاده کنید\&. .sp توجه: گروه‌های تفکیک‌شده ممکن است توسط همه ابزارها پشتیبانی نشوند (حتی در مجموعه ابزار Shadow)\&. نباید از این متغیر استفاده کنید مگر اینکه واقعاً به آن نیاز داشته باشید\&. .RE .PP \fBPASS_MAX_DAYS\fR (number) .RS 4 حداکثر تعداد روزهایی که یک گذرواژه می‌تواند استفاده شود\&. اگر گذرواژه قدیمی‌تر از این مقدار باشد، تغییر گذرواژه اجباری خواهد شد\&. در صورت مشخص نشدن، مقدار \-1 در نظر گرفته می‌شود (که این محدودیت را غیرفعال می‌کند)\&. .RE .PP \fBPASS_MIN_DAYS\fR (number) .RS 4 حداقل تعداد روزهای مجاز بین تغییرات گذرواژه\&. هرگونه تلاش برای تغییر گذرواژه زودتر از این زمان رد خواهد شد\&. در صورت مشخص نشدن، مقدار 0 در نظر گرفته می‌شود (که این محدودیت را غیرفعال می‌کند)\&. .RE .PP \fBPASS_WARN_AGE\fR (number) .RS 4 تعداد روزهای هشدار ارائه‌شده پیش از انقضای گذرواژه\&. مقدار صفر یعنی هشدار فقط در روز انقضا داده می‌شود، مقدار منفی یعنی هیچ هشداری داده نمی‌شود\&. در صورت مشخص نشدن، هیچ هشداری ارائه نخواهد شد\&. .RE .PP \fBSUB_GID_MIN\fR (number), \fBSUB_GID_MAX\fR (number), \fBSUB_GID_COUNT\fR (number) .RS 4 اگر /etc/subuid وجود داشته باشد، دستورهای \fBuseradd\fR و \fBnewusers\fR (مگر اینکه کاربر از قبل شناسه‌های گروه تابعه داشته باشد) تعداد \fBSUB_GID_COUNT\fR شناسه گروه استفاده‌نشده را از محدودهٔ \fBSUB_GID_MIN\fR تا \fBSUB_GID_MAX\fR برای هر کاربر جدید اختصاص می‌دهند\&. .sp مقادیر پیش‌فرض برای \fBSUB_GID_MIN\fR، \fBSUB_GID_MAX\fR و \fBSUB_GID_COUNT\fR به ترتیب 100000، 600100000 و 65536 است\&. .RE .PP \fBSUB_UID_MIN\fR (number), \fBSUB_UID_MAX\fR (number), \fBSUB_UID_COUNT\fR (number) .RS 4 اگر /etc/subuid وجود داشته باشد، دستورهای \fBuseradd\fR و \fBnewusers\fR (مگر اینکه کاربر از قبل شناسه‌های کاربر تابعه داشته باشد) تعداد \fBSUB_UID_COUNT\fR شناسه کاربر استفاده‌نشده را از محدودهٔ \fBSUB_UID_MIN\fR تا \fBSUB_UID_MAX\fR برای هر کاربر جدید اختصاص می‌دهند\&. .sp مقادیر پیش‌فرض برای \fBSUB_UID_MIN\fR، \fBSUB_UID_MAX\fR و \fBSUB_UID_COUNT\fR به ترتیب 100000، 600100000 و 65536 است\&. .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) 101 (به ترتیب \fBGID_MIN\fR\-1) است\&. .RE .PP \fBSYS_UID_MAX\fR (number), \fBSYS_UID_MIN\fR (number) .RS 4 محدوده شناسه‌های کاربری مورد استفاده برای ایجاد کاربران سیستمی توسط \fBuseradd\fR یا \fBnewusers\fR\&. .sp مقدار پیش‌فرض برای \fBSYS_UID_MIN\fR (به ترتیب \fBSYS_UID_MAX\fR) 101 (به ترتیب \fBUID_MIN\fR\-1) است\&. .RE .PP \fBUID_MAX\fR (number), \fBUID_MIN\fR (number) .RS 4 محدوده شناسه‌های کاربری مورد استفاده برای ایجاد کاربران عادی توسط \fBuseradd\fR یا \fBnewusers\fR\&. .sp مقدار پیش‌فرض برای \fBUID_MIN\fR (به ترتیب \fBUID_MAX\fR) 1000 (به ترتیب 60000) است\&. .RE .PP \fBUMASK\fR (number) .RS 4 ماسک ایجاد حالت فایل با این مقدار مقداردهی اولیه می‌شود\&. در صورت مشخص نشدن، ماسک روی 022 مقداردهی اولیه خواهد شد\&. .sp \fBuseradd\fR و \fBnewusers\fR از این ماسک برای تنظیم حالت دایرکتوری خانگی‌ای که ایجاد می‌کنند استفاده می‌نمایند اگر \fBHOME_MODE\fR تنظیم نشده باشد\&. .sp همچنین توسط \fBpam_umask\fR به عنوان مقدار پیش‌فرض umask استفاده می‌شود\&. .RE .PP \fBUSERGROUPS_ENAB\fR (boolean) .RS 4 اگر روی \fIyes\fR تنظیم شود، \fBuserdel\fR گروه کاربر را در صورتی که عضو دیگری نداشته باشد حذف خواهد کرد، و \fBuseradd\fR به طور پیش‌فرض گروهی با نام کاربر ایجاد خواهد کرد\&. .RE .SH "فایل‌ها (FILES)" .PP /etc/passwd .RS 4 اطلاعات حساب‌های کاربری\&. .RE .PP /etc/shadow .RS 4 اطلاعات امن حساب‌های کاربری\&. .RE .PP /etc/group .RS 4 اطلاعات حساب‌های گروه\&. .RE .PP /etc/gshadow .RS 4 اطلاعات امن حساب‌های گروه\&. .RE .PP /etc/default/useradd .RS 4 مقادیر پیش‌فرض برای ایجاد حساب کاربری\&. .RE .PP /etc/shadow\-maint/useradd\-pre\&.d/*, /etc/shadow\-maint/useradd\-post\&.d/* .RS 4 فایل‌های run\-part برای اجرا در حین افزودن کاربر\&. متغیر محیطی \fBACTION\fR با useradd و \fBSUBJECT\fR با \fBusername\fR پر خواهد شد\&. useradd\-pre\&.d پیش از هرگونه افزودن کاربر اجرا خواهد شد\&. useradd\-post\&.d پس از افزودن کاربر اجرا خواهد شد\&. اگر اسکریپتی با مقداری غیر از صفر خارج شود، اجرای عملیات متوقف خواهد شد\&. .RE .PP /etc/skel/ .RS 4 دایرکتوری حاوی فایل‌های پیش‌فرض\&. .RE .PP /etc/subgid .RS 4 شناسه‌های گروه تابعه (subordinate group IDs) برای هر کاربر\&. .RE .PP /etc/subuid .RS 4 شناسه‌های کاربر تابعه (subordinate user IDs) برای هر کاربر\&. .RE .PP /etc/login\&.defs .RS 4 پیکربندی مجموعه گذرواژه Shadow\&. .RE .SH "مقادیر خروج (EXIT VALUES)" .PP دستور \fBuseradd\fR با مقادیر زیر خارج می‌شود: .PP \fI0\fR .RS 4 موفقیت .RE .PP \fI1\fR .RS 4 عدم امکان به‌روزرسانی فایل گذرواژه .RE .PP \fI2\fR .RS 4 نحو نامعتبر دستور .RE .PP \fI3\fR .RS 4 آرگومان نامعتبر برای گزینه .RE .PP \fI4\fR .RS 4 UID از قبل در حال استفاده است (و بدون \fB\-o\fR) .RE .PP \fI6\fR .RS 4 گروه مشخص‌شده وجود ندارد .RE .PP \fI9\fR .RS 4 نام کاربری یا نام گروه از قبل در حال استفاده است .RE .PP \fI10\fR .RS 4 عدم امکان به‌روزرسانی فایل گروه .RE .PP \fI12\fR .RS 4 عدم امکان ایجاد دایرکتوری خانگی .RE .PP \fI14\fR .RS 4 عدم امکان به‌روزرسانی نگاشت کاربر SELinux .RE .SH "نویسنده (AUTHOR)" نوشته شده توسط Julianne Frances Haugh. .SH "گزارش باگ‌ها (REPORTING BUGS)" برای گزارش باگ‌ها به سامانه پیگیری باگ توزیع خود یا به پروژه shadow-utils در آدرس زیر مراجعه کنید: .br .SH "حق نشر (COPYRIGHT)" حق نشر \(co 1991 - 1994 Julianne Frances Haugh. .br حق نشر \(co 1996 - 2000 Marek Michałkiewicz. .br حق نشر \(co 2000 - 2006 Tomasz Kłoczko. .br حق نشر \(co 2007 - 2025 Nicolas François. .SH "همچنین ببینید (SEE ALSO)" .PP \fBchfn\fR(1), \fBchsh\fR(1), \fBpasswd\fR(1), \fBcrypt\fR(3), \fBgroupadd\fR(8), \fBgroupdel\fR(8), \fBgroupmod\fR(8), \fBlogin.defs\fR(5), \fBnewusers\fR(8), \fBsubgid\fR(5), \fBsubuid\fR(5), \fBuserdel\fR(8), \fBusermod\fR(8)\&.