'\" t
.\"     Title: grpconv
.\"    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 "GRPCONV" "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)"
grpconv \- تبدیل و همگام‌سازی فایل‌های group و gshadow
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpwconv\fR\ 'u
\fBpwconv\fR [\fIگزینه‌ها\fR]
.HP \w'\fBpwunconv\fR\ 'u
\fBpwunconv\fR [\fIگزینه‌ها\fR]
.HP \w'\fBgrpconv\fR\ 'u
\fBgrpconv\fR [\fIگزینه‌ها\fR]
.HP \w'\fBgrpunconv\fR\ 'u
\fBgrpunconv\fR [\fIگزینه‌ها\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
هر چهار برنامه بر روی فایل‌های عادی و سایهٔ (shadow) گذرواژه و گروه عمل می‌کنند:
/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)\&.