'\" t
.\"     Title: pam_pwhistory
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 01/26/2026
.\"    Manual: Linux-PAM Manual
.\"    Source: Linux-PAM
.\"  Language: Persian
.\"
.TH "PAM_PWHISTORY" "8" "01/26/2026" "Linux\-PAM" "راهنمای Linux\-PAM"
.\" -----------------------------------------------------------------
.\" * 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)"
pam_pwhistory \- ماژول PAM برای ذخیره و بررسی تاریخچه گذرواژه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_pwhistory\&.so\fR\ 'u
\fBpam_pwhistory\&.so\fR [debug] [use_authtok] [enforce_for_root] [remember=\fIN\fR] [retry=\fIN\fR] [authtok_type=\fISTRING\fR] [file=\fI/path/filename\fR] [conf=\fI/path/to/config\-file\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
این ماژول آخرین گذرواژه‌های هر کاربر را ذخیره می‌کند تا تاریخچه تغییر گذرواژه را اعمال کند و از جابجایی مکرر کاربر میان همان گذرواژه‌ها جلوگیری نماید\&.
.PP
این ماژول همراه با kerberos کار نمی‌کند\&. به طور کلی، استفاده از این ماژول در کنار NIS یا LDAP چندان منطقی نیست، زیرا گذرواژه‌های قدیمی روی ماشین محلی ذخیره می‌شوند و برای بررسی تاریخچه گذرواژه در ماشین دیگر در دسترس نیستند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
debug
.RS 4
اشکال‌زدایی را از طریق
\fBsyslog\fR(3)
فعال می‌کند\&.
.RE
.PP
use_authtok
.RS 4
هنگام تغییر گذرواژه، ماژول را وادار می‌کند از گذرواژه جدید ارائه شده توسط یک ماژول
\fBpassword\fR
پشته‌شده قبلی استفاده کند (این مورد در مثال پشته‌بندی ماژول
\fBpam_passwdqc\fR
که در زیر مستند شده، استفاده شده است)\&.
.RE
.PP
enforce_for_root
.RS 4
اگر این گزینه تنظیم شود، بررسی برای root نیز اعمال می‌شود\&.
.RE
.PP
remember=N
.RS 4
تعداد
\fIN\fR
گذرواژه آخر برای هر کاربر ذخیره می‌شود\&. مقدار پیش‌فرض
\fI10\fR
است\&. مقدار
\fI0\fR
باعث می‌شود ماژول محتویات موجود پرونده
opasswd
را بدون تغییر نگه دارد\&.
.RE
.PP
retry=N
.RS 4
پیش از بازگرداندن خطا، حداکثر
\fIN\fR
بار از کاربر درخواست می‌کند\&. مقدار پیش‌فرض
\fI1\fR
است\&.
.RE
.PP
authtok_type=STRING
.RS 4
برای جزئیات بیشتر
\fBpam_get_authtok\fR(3)
را ببینید\&.
.RE
.PP
file=/path/filename
.RS 4
تاریخچه گذرواژه را به جای مکان پیش‌فرض در پرونده
/path/filename
ذخیره می‌کند\&. مکان پیش‌فرض
/etc/security/opasswd
است\&.
.RE
.PP
conf=/path/to/config\-file
.RS 4
استفاده از پرونده پیکربندی دیگر به جای پرونده پیش‌فرض
/etc/security/pwhistory\&.conf\&.
.RE
.PP
گزینه‌های مربوط به پیکربندی رفتار ماژول در صفحه راهنمای
\fBpwhistory.conf\fR(5)
شرح داده شده‌اند\&. گزینه‌های مشخص‌شده در خط فرمان ماژول مقادیر پرونده پیکربندی را بازنویسی می‌کنند\&.
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.PP
تنها نوع ماژول
\fBpassword\fR
ارائه می‌شود\&.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
PAM_AUTHTOK_ERR
.RS 4
گذرواژه جدیدی وارد نشده است، کاربر تغییر گذرواژه را لغو کرده، یا گذرواژه جدید قابل تنظیم نبوده است\&.
.RE
.PP
PAM_IGNORE
.RS 4
تاریخچه گذرواژه غیرفعال شده است\&.
.RE
.PP
PAM_MAXTRIES
.RS 4
گذرواژه بیش از حد مجاز رد شده است\&.
.RE
.PP
PAM_USER_UNKNOWN
.RS 4
کاربر برای سیستم ناشناخته است\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
یک بخش نمونه برای password به صورت زیر خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
#%PAM\-1\&.0
password     required       pam_pwhistory\&.so
password     required       pam_unix\&.so        use_authtok

.fi
.if n \{\
.RE
.\}
.PP
در ترکیب با
\fBpam_passwdqc\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
#%PAM\-1\&.0
password     required       pam_passwdqc\&.so    config=/etc/passwdqc\&.conf
password     required       pam_pwhistory\&.so   use_authtok
password     required       pam_unix\&.so        use_authtok

.fi
.if n \{\
.RE
.\}
.sp
.SH "فایل‌ها (FILES)"
.PP
/etc/security/opasswd
.RS 4
پرونده پیش‌فرض حاوی تاریخچه گذرواژه‌ها
.RE
.PP
/etc/security/pwhistory\&.conf
.RS 4
پرونده پیکربندی برای گزینه‌های pam_pwhistory
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpwhistory.conf\fR(5),
\fBpam.conf\fR(5),
\fBpam.d\fR(5),
\fBpam\fR(8)
\fBpam_get_authtok\fR(3)
.SH "نویسنده (AUTHOR)"
.PP
pam_pwhistory توسط Thorsten Kukuk <kukuk@thkukuk\&.de> نوشته شده است\&.