'\" t
.\"     Title: pwconv
.\"    Author: Marek Michałkiewicz
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04/19/2025
.\"    Manual: System Management Commands
.\"    Source: shadow-utils 4.17.4
.\"  Language: Persian
.\"
.TH "PWCONV" "8" "04/19/2025" "shadow\-utils 4\&.17\&.4" "دستورهای مدیریت سیستم (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)"
pwconv, pwunconv, grpconv, grpunconv \- تبدیل و همگام‌سازی فایل‌های passwd و shadow
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpwconv\fR\ 'u
\fBpwconv\fR [\fIoptions\fR]
.HP \w'\fBpwunconv\fR\ 'u
\fBpwunconv\fR [\fIoptions\fR]
.HP \w'\fBgrpconv\fR\ 'u
\fBgrpconv\fR [\fIoptions\fR]
.HP \w'\fBgrpunconv\fR\ 'u
\fBgrpunconv\fR [\fIoptions\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBpwconv\fR
پرونده
\fIshadow\fR
را از روی
\fIpasswd\fR
و در صورت وجود، پرونده اختیاری
\fIshadow\fR
ایجاد می‌کند\&.
.PP
دستور
\fBpwunconv\fR
پرونده
\fIpasswd\fR
را از روی
\fIpasswd\fR
و
\fIshadow\fR
ایجاد کرده و سپس
\fIshadow\fR
را حذف می‌کند\&.
.PP
دستور
\fBgrpconv\fR
پرونده
\fIgshadow\fR
را از روی
\fIgroup\fR
و در صورت وجود، پرونده اختیاری
\fIgshadow\fR
ایجاد می‌کند\&.
.PP
دستور
\fBgrpunconv\fR
پرونده
\fIgroup\fR
را از روی
\fIgroup\fR
و
\fIgshadow\fR
ایجاد کرده و سپس
\fIgshadow\fR
را حذف می‌کند\&.
.PP
هر چهار برنامه بر روی پرونده‌های معمولی و سایه گذرواژه و گروه کار می‌کنند:
/etc/passwd،
/etc/group،
/etc/shadow
و
/etc/gshadow\&.
.PP
هر برنامه پیش از تبدیل، قفل‌های لازم را به دست می‌آورد\&.
\fBpwconv\fR
و
\fBgrpconv\fR
مشابه یکدیگر هستند\&. ابتدا، مدخل‌هایی از پرونده سایه که در پرونده اصلی وجود ندارند حذف می‌شوند\&. سپس، مدخل‌های سایه‌ای که در پرونده اصلی گذرواژه‌ای به‌جز \(aqx\(aq دارند به‌روزرسانی می‌شوند\&. هرگونه مدخل سایه مفقود اضافه می‌شود\&. در نهایت، گذرواژه‌ها در پرونده اصلی با \(aqx\(aq جایگزین می‌شوند\&. از این برنامه‌ها می‌توان هم برای تبدیل اولیه و هم برای به‌روزرسانی پرونده سایه در صورتی که پرونده اصلی به‌صورت دستی ویرایش شده باشد استفاده کرد\&.
.PP
دستور
\fBpwconv\fR
هنگام افزودن مدخل‌های جدید به
/etc/shadow
از مقادیر
\fIPASS_MIN_DAYS\fR،
\fIPASS_MAX_DAYS\fR
و
\fIPASS_WARN_AGE\fR
موجود در
/etc/login\&.defs
استفاده خواهد کرد\&.
.PP
به همین ترتیب
\fBpwunconv\fR
و
\fBgrpunconv\fR
مشابه هم هستند\&. گذرواژه‌ها در پرونده اصلی از روی پرونده سایه به‌روزرسانی می‌شوند\&. مدخل‌هایی که در پرونده اصلی وجود دارند اما در پرونده سایه نیستند دست‌نخورده باقی می‌مانند\&. در نهایت، پرونده سایه حذف می‌شود\&. برخی اطلاعات دیرینگی گذرواژه توسط
\fBpwunconv\fR
از دست می‌رود؛ این دستور آنچه را که بتواند تبدیل می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌هایی که برای دستورهای
\fBpwconv\fR،
\fBpwunconv\fR،
\fBgrpconv\fR
و
\fBgrpunconv\fR
اعمال می‌شوند عبارتند از:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش پیام راهنما و خروج\&.
.RE
.PP
\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR
.RS 4
اعمال تغییرات در پوشه
\fICHROOT_DIR\fR
و استفاده از پرونده‌های پیکربندی از پوشه
\fICHROOT_DIR\fR\&.
تنها مسیرهای مطلق پشتیبانی می‌شوند\&.
.RE
.SH "اشکالات (BUGS)"
.PP
خطاها در پرونده‌های گذرواژه یا گروه (مانند مدخل‌های نامعتبر یا تکراری) ممکن است باعث شوند این برنامه‌ها در حلقه بی‌پایان بیفتند یا به شیوه‌های عجیب دیگری با شکست مواجه شوند\&. لطفاً پیش از تبدیل به گذرواژه‌ها یا گروه‌های سایه یا برعکس، دستورهای
\fBpwck\fR
و
\fBgrpck\fR
را برای اصلاح این‌گونه خطاها اجرا کنید\&.
.SH "پیکربندی (CONFIGURATION)"
.PP
متغیر پیکربندی زیر در
/etc/login\&.defs
رفتار
\fBgrpconv\fR
و
\fBgrpunconv\fR
را تغییر می‌دهد:
.PP
\fBMAX_MEMBERS_PER_GROUP\fR (number)
.RS 4
حداکثر اعضا در هر مدخل گروه\&. هنگامی که به این حداکثر برسد، یک مدخل (خط) جدید برای گروه در
/etc/group
آغاز می‌شود (با همان نام، همان گذرواژه و همان GID)\&.
.sp
مقدار پیش‌فرض 0 است، به این معنی که هیچ محدودیتی در تعداد اعضای یک گروه وجود ندارد\&.
.sp
این ویژگی (گروه تفکیک‌شده) امکان محدود کردن طول خطوط در پرونده گروه را فراهم می‌کند\&. این قابلیت برای اطمینان از اینکه خطوط مربوط به گروه‌های NIS بزرگتر از ۱۰۲۴ نویسه نباشند مفید است\&.
.sp
اگر نیاز به اعمال چنین محدودیتی دارید، می‌توانید از 25 استفاده کنید\&.
.sp
نکته: ممکن است گروه‌های تفکیک‌شده توسط همه ابزارها (حتی در مجموعه ابزار Shadow) پشتیبانی نشوند\&. نباید از این متغیر استفاده کنید مگر اینکه واقعاً به آن نیاز داشته باشید\&.
.RE
.PP
متغیرهای پیکربندی زیر در
/etc/login\&.defs
رفتار
\fBpwconv\fR
را تغییر می‌دهند:
.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
تعداد روزهایی که پیش از انقضای گذرواژه هشدار داده می‌شود\&. مقدار صفر یعنی هشدار فقط در روز انقضا داده می‌شود، مقدار \-1 یعنی هیچ هشداری داده نمی‌شود\&. در صورت عدم تعیین، هیچ هشداری داده نخواهد شد\&.
.RE
.SH "فایل‌ها (FILES)"
.PP
/etc/login\&.defs
.RS 4
پیکربندی مجموعه گذرواژه سایه (Shadow)\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBgrpck\fR(8),
\fBlogin.defs\fR(5),
\fBpwck\fR(8)\&.