'\" t
.\"     Title: pam_stress
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 06/29/2025
.\"    Manual: دستورات مدیریت سیستم
.\"    Source: Linux-PAM
.\"  Language: Persian
.\"
.TH "PAM_STRESS" "8" "مه ۲۰۲۵" "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_stress \- ماژول تست و آزمایش رفتار پشته PAM
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_stress\&.so\fR\ 'u
\fBpam_stress\&.so\fR [debug] [no_warn] [use_first_pass] [try_first_pass] [rootok] [expired] [fail_1] [fail_2] [prelim] [required]
.SH "توضیحات (DESCRIPTION)"
ماژول \fBpam_stress\fR برای توسعهدهندگان و آزمودن رفتار برنامههای کاربردی در مواجهه با کدهای خطای مختلف PAM طراحی شده است.
.SH "گزینه‌ها (OPTIONS)"
.PP
debug
.RS 4
اطلاعات فراوانی را در syslog ثبت می‌کند. *نکته* این گزینه گذرواژه‌ها را در syslog می‌نویسد، بنابراین هنگام آزمایش از هیچ داده حساسی استفاده نکنید.
.RE
.PP
no_warn
.RS 4
هشداری صادر نمی‌کند (در غیر این صورت هشدارها از طریق تابع گفتگو ارسال می‌شوند).
.RE
.PP
use_first_pass
.RS 4
درخواست گذرواژه نمی‌کند؛ برای تابع pam_sm_authentication صرفاً از آیتم PAM_AUTHTOK استفاده می‌کند.
.RE
.PP
try_first_pass
.RS 4
درخواست گذرواژه نمی‌کند مگر اینکه توکن احراز هویت قبلی وجود نداشته باشد (آیتم PAM_AUTHTOK برابر با NULL باشد).
.RE
.PP
rootok
.RS 4
این گزینه برای تابع pam_sm_chauthtok در نظر گرفته شده و به این تابع دستور می‌دهد به کاربر ریشه (root) اجازه دهد بدون وارد کردن گذرواژه قدیمی، گذرواژه کاربر را تغییر دهد.
.RE
.PP
expired
.RS 4
آرگومانی برای بخش‌های account و chauthtok ماژول؛ به ماژول دستور می‌دهد طوری رفتار کند که گویی گذرواژه کاربر منقضی شده است.
.RE
.PP
fail_1
.RS 4
به ماژول دستور می‌دهد که نخستین تابع خود را با شکست مواجه کند.
.RE
.PP
fail_2
.RS 4
به ماژول دستور می‌دهد که دومین تابع خود را (در صورت وجود) با شکست مواجه کند.
.RE
.PP
prelim
.RS 4
برای pam_sm_chauthtok، به معنای شکست در PAM_PRELIM_CHECK است.
.RE
.PP
required
.RS 4
برای pam_sm_chauthtok، به معنای شکست است اگر کاربر از قبل توسط این ماژول احراز هویت نشده باشد. (رشته داده stress_new_pwd را در بخش «نکات» ببینید.)
.RE
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.PP
تمام انواع ماژول (\fBauth\fR،
\fBaccount\fR،
\fBpassword\fR
و
\fBsession\fR) ارائه می‌شوند.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
PAM_BUF_ERR
.RS 4
خطای بافر حافظه.
.RE
.PP
PAM_PERM_DENIED
.RS 4
مجوز دسترسی رد شد.
.RE
.PP
PAM_AUTH_ERR
.RS 4
دسترسی به سیستم رد شد.
.RE
.PP
PAM_CONV_ERR
.RS 4
خطای تابع گفتگو (Conversation failure).
.RE
.PP
PAM_SUCCESS
.RS 4
تابع با موفقیت از تمامی بررسی‌ها عبور کرد.
.RE
.PP
PAM_USER_UNKNOWN
.RS 4
کاربر برای سیستم ناشناخته است.
.RE
.PP
PAM_CRED_ERR
.RS 4
خطا و شکست در اعتبارسنجی و گواهی کاربر.
.RE
.PP
PAM_NEW_AUTHTOK_REQD
.RS 4
توکن احراز هویت دیگر معتبر نیست؛ توکن جدید لازم است.
.RE
.PP
PAM_SESSION_ERR
.RS 4
خطای نشست (Session).
.RE
.PP
PAM_TRY_AGAIN
.RS 4
بررسی مقدماتی توسط سرویس با شکست مواجه شد.
.RE
.PP
PAM_AUTHTOK_LOCK_BUSY
.RS 4
قفل توکن احراز هویت مشغول است.
.RE
.PP
PAM_AUTHTOK_ERR
.RS 4
خطا در دستکاری توکن احراز هویت.
.RE
.PP
PAM_SYSTEM_ERR
.RS 4
خطای سیستم.
.RE
.SH "نکات (NOTES)"
.PP
این ماژول از رشته داده stress_new_pwd استفاده می‌کند که به pam_sm_chauthtok اعلام می‌دارد که pam_sm_acct_mgmt نیاز به گذرواژه جدید را گزارش کرده است. تنها مقدار ممکن برای این رشته داده \*(Aqyes\*(Aq است.
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n \{\
.RS 4
.\}
.nf
#%PAM\-1\&.0
#
# هر یک از موارد زیر کافی خواهد بود
account  required pam_stress\&.so
auth     required pam_stress\&.so
password required pam_stress\&.so
session  required pam_stress\&.so
    
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpam.conf\fR(5)،
\fBpam.d\fR(5)،
\fBpam\fR(8)
.SH "نویسندگان (AUTHORS)"
.PP
ماژول pam_stress توسط Andrew Morgan <morgan@linux.kernel.org> توسعه یافته است. صفحه راهنمای pam_stress توسط Lucas Ramage <ramage.lucas@protonmail.com> نوشته شده است.