.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "PWQUALITY.CONF 5"
.TH PWQUALITY.CONF 5 2025-12-14 "Red Hat, Inc." "راهنمای قالب فایل‌ها"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
pwquality.conf \- پیکربندی کتابخانه libpwquality
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fI/etc/security/pwquality.conf\fR
.PP
\&\fI/etc/security/pwquality.conf.d/*.conf\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
فایل \&\fBpwquality.conf\fR روشی را برای پیکربندی نیازمندی‌های پیش‌فرض کیفیت گذرواژه برای گذرواژه‌های سیستم فراهم می‌کند. این فایل توسط کتابخانه libpwquality و ابزارهایی که از این کتابخانه برای بررسی و تولید گذرواژه‌ها بهره می‌برند خوانده می‌شود.
.PP
این فایل دارای ساختار بسیار ساده \fIname = value\fR (نام = مقدار) به همراه توضیحات احتمالی است که با نویسه \f(CW\*(C`#\*(C'\fR آغاز می‌شوند. فاصله‌های خالی (whitespace) در ابتدای خط، انتهای خط و در اطراف علامت \f(CW\*(C`=\*(C'\fR نادیده گرفته می‌شوند.
.PP
کتابخانه libpwquality همچنین ابتدا همه فایل‌های \fI*.conf\fR موجود در دایرکتوری \&\fI/etc/security/pwquality.conf.d\fR را به ترتیب الفبایی اسکی (ASCII) می‌خواند. مقادیر تنظیمات یکسان به ترتیبی که فایل‌ها پردازش می‌شوند، رونویسی (override) خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
گزینه‌های ممکن در این فایل عبارتند از:
.IP \fBdifok\fR 4
.IX Item "difok"
تعداد نویسه‌های موجود در گذرواژه جدید که نباید در گذرواژه پیشین وجود داشته باشند. (پیش‌فرض: 1)
.Sp
مقدار ویژه 0 تمام بررسی‌های شباهت گذرواژه جدید با گذرواژه قدیمی را غیرفعال می‌کند، مگر اینکه گذرواژه جدید دقیقاً همانند گذرواژه قدیمی باشد.
.IP \fBminlen\fR 4
.IX Item "minlen"
حداقل اندازه قابل قبول برای گذرواژه جدید (به‌علاوه یک، در صورتی که امتیازها غیرفعال نشده باشند که این حالت پیش‌فرض است). (به \fBpam_pwquality\fR\|(8) مراجعه کنید.)
نمی‌تواند روی مقداری کمتر از 6 تنظیم شود. (پیش‌فرض: 8)
.IP \fBdcredit\fR 4
.IX Item "dcredit"
حداکثر امتیاز برای داشتن ارقام در گذرواژه جدید. اگر کمتر از 0 باشد، بیانگر حداقل تعداد ارقام لازم در گذرواژه جدید است. (پیش‌فرض: 0)
.IP \fBucredit\fR 4
.IX Item "ucredit"
حداکثر امتیاز برای داشتن حروف بزرگ انگلیسی در گذرواژه جدید. اگر کمتر از 0 باشد، بیانگر حداقل تعداد حروف بزرگ لازم در گذرواژه جدید است. (پیش‌فرض: 0)
.IP \fBlcredit\fR 4
.IX Item "lcredit"
حداکثر امتیاز برای داشتن حروف کوچک انگلیسی در گذرواژه جدید. اگر کمتر از 0 باشد، بیانگر حداقل تعداد حروف کوچک لازم در گذرواژه جدید است. (پیش‌فرض: 0)
.IP \fBocredit\fR 4
.IX Item "ocredit"
حداکثر امتیاز برای داشتن سایر نویسه‌ها (نمادها و نشانه‌ها) در گذرواژه جدید. اگر کمتر از 0 باشد، بیانگر حداقل تعداد سایر نویسه‌ها در گذرواژه جدید است. (پیش‌فرض: 0)
.IP \fBminclass\fR 4
.IX Item "minclass"
حداقل تعداد دسته‌های مورد نیاز نویسه‌ها برای گذرواژه جدید (ارقام، حروف بزرگ، حروف کوچک، سایر نویسه‌ها). (پیش‌فرض: 0)
.IP \fBmaxrepeat\fR 4
.IX Item "maxrepeat"
حداکثر تعداد مجاز نویسه‌های متوالی یکسان در گذرواژه جدید. اگر مقدار 0 باشد، این بررسی غیرفعال است. (پیش‌فرض: 0)
.IP \fBmaxsequence\fR 4
.IX Item "maxsequence"
حداکثر طول دنباله‌های نویسه‌ای متوالی و یکنواخت در گذرواژه جدید. نمونه‌هایی از چنین دنباله‌هایی \*(Aq12345\*(Aq یا \*(Aqfedcb\*(Aq هستند. توجه داشته باشید که بیشتر چنین گذرواژه‌هایی از بررسی سادگی رد نخواهند شد مگر اینکه این دنباله بخش بسیار ناچیزی از گذرواژه باشد. اگر مقدار 0 باشد، این بررسی غیرفعال است. (پیش‌فرض: 0)
.IP \fBmaxclassrepeat\fR 4
.IX Item "maxclassrepeat"
حداکثر تعداد مجاز نویسه‌های متوالی از یک دسته یکسان در گذرواژه جدید. اگر مقدار 0 باشد، این بررسی غیرفعال است. (پیش‌فرض: 0)
.IP \fBgecoscheck\fR 4
.IX Item "gecoscheck"
اگر غیرصفر باشد، بررسی می‌کند که آیا کلمات طولانی‌تر از 3 نویسه از فیلد \fIGECOS\fR در مدخل کاربری \fBpasswd\fR\|(5) در گذرواژه جدید به کار رفته‌اند یا خیر. اگر مقدار 0 باشد، این بررسی غیرفعال است. (پیش‌فرض: 0)
.IP \fBdictcheck\fR 4
.IX Item "dictcheck"
اگر غیرصفر باشد، بررسی می‌کند که آیا گذرواژه (با تغییرات احتمالی) با کلمه‌ای در فرهنگ لغت مطابقت دارد یا خیر. در حال حاضر بررسی فرهنگ لغت با استفاده از کتابخانه cracklib انجام می‌شود. (پیش‌فرض: 1)
.IP \fBusercheck=\fR\fIN\fR 4
.IX Item "usercheck=N"
اگر غیرصفر باشد، بررسی می‌کند که آیا گذرواژه (با تغییرات احتمالی) به نوعی حاوی نام کاربری است یا خیر. این بررسی برای نام‌های کاربری کوتاه‌تر از 3 نویسه انجام نمی‌شود. (پیش‌فرض: 1)
.IP \fBusersubstr=\fR\fIN\fR 4
.IX Item "usersubstr=N"
اگر بزرگتر از 3 باشد (به دلیل حداقل طول در usercheck)، بررسی می‌کند که آیا گذرواژه شامل زیررشته‌ای به طول حداقل \fIN\fR به هر شکلی است یا خیر. (پیش‌فرض: 0)
.IP \fBenforcing=\fR\fIN\fR 4
.IX Item "enforcing=N"
اگر غیرصفر باشد، در صورت عدم قبولی در بررسی‌ها گذرواژه را رد می‌کند؛ در غیر این صورت تنها یک هشدار چاپ خواهد شد. این تنظیم تنها روی ماژول pam_pwquality و احتمالاً سایر برنامه‌هایی که صریحاً رفتار خود را بر اساس آن تغییر می‌دهند اعمال می‌شود. این گزینه بر \fBpwmake\fR\|(1) و \fBpwscore\fR\|(1) تأثیری ندارد. (پیش‌فرض: 1)
.IP \fBbadwords\fR 4
.IX Item "badwords"
فهرستی از کلمات جدا شده با فاصله که نباید در گذرواژه وجود داشته باشند. این‌ها کلمات اضافه‌ای بر بررسی فرهنگ لغت cracklib هستند. این تنظیم همچنین می‌تواند توسط برنامه‌ها برای شبیه‌سازی بررسی gecos برای حساب‌های کاربری که هنوز ایجاد نشده‌اند استفاده شود.
.IP \fBdictpath\fR 4
.IX Item "dictpath"
مسیر فرهنگ‌های لغت cracklib. پیش‌فرض، استفاده از مسیر پیش‌فرض cracklib است.
.IP \fBretry=\fR\fIN\fR 4
.IX Item "retry=N"
حداکثر \fIN\fR بار پیش از بازگرداندن خطا از کاربر درخواست گذرواژه می‌کند. پیش‌فرض \fI1\fR است.
.IP \fBenforce_for_root\fR 4
.IX Item "enforce_for_root"
در صورت عدم موفقیت در بررسی، ماژول خطا بازمی‌گرداند حتی اگر کاربری که گذرواژه را تغییر می‌دهد root باشد. این گزینه به طور پیش‌فرض خاموش است که یعنی تنها پیامی درباره عدم قبولی بررسی چاپ می‌شود اما root می‌تواند در هر صورت گذرواژه را تغییر دهد. توجه داشته باشید که از root گذرواژه قدیمی پرسیده نمی‌شود، بنابراین بررسی‌هایی که گذرواژه پیشین و جدید را مقایسه می‌کنند اجرا نخواهند شد.
.IP \fBlocal_users_only\fR 4
.IX Item "local_users_only"
ماژول کیفیت گذرواژه را برای کاربرانی که در فایل \fI/etc/passwd\fR موجود نیستند بررسی نمی‌کند. ماژول همچنان گذرواژه را درخواست می‌کند تا ماژول‌های بعدی در پشته بتوانند از گزینه \fBuse_authtok\fR استفاده کنند. این گزینه به طور پیش‌فرض غیرفعال است.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBpwscore\fR\|(1), \fBpwmake\fR\|(1), \fBpam_pwquality\fR\|(8)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Tomas Mraz <tmraz@redhat.com>