'\" t
.\"     Title: pwunconv
.\"    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 "PWUNCONV" "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)"
pwunconv \- بازگردانی گذرواژه‌ها از shadow به passwd
.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
مشابه یکدیگر هستند\&. ابتدا مدخل‌هایی از پروندهٔ سایه که در پروندهٔ اصلی وجود ندارند حذف می‌شوند\&. سپس مدخل‌های سایه‌ای که در پروندهٔ اصلی فاقد `x\*(Aq به عنوان گذرواژه هستند به‌روزرسانی می‌شوند\&. هر مدخل سایهٔ ناموجود اضافه می‌شود\&. در نهایت، گذرواژه‌ها در پروندهٔ اصلی با `x\*(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
این قابلیت (گروه تفکیک‌شده یا split group) اجازه می‌دهد طول سطرها در پروندهٔ گروه محدود شود\&. این ویژگی برای اطمینان از اینکه سطرهای گروه‌های 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)\&.