'\" t
.\"     Title: pam_succeed_if
.\"    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_SUCCEED_IF" "8" "01/26/2026" "Linux\-PAM" "Linux\-PAM Manual"
.\" -----------------------------------------------------------------
.\" * 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_succeed_if \- ماژول PAM برای احراز هویت مشروط بر اساس ویژگی‌های حساب
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_succeed_if\&.so\fR\ 'u
\fBpam_succeed_if\&.so\fR [\fIflag\fR...] [\fIcondition\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول pam_succeed_if\&.so طوری طراحی شده است که بر اساس ویژگی‌های حسابی که به کاربر در حال احراز هویت تعلق دارد یا مقادیر سایر آیتم‌های PAM، احراز هویت را موفق یا ناموفق کند\&. یکی از کاربردهای آن، تصمیم‌گیری درباره بارگذاری ماژول‌های دیگر بر اساس این آزمون است\&.
.PP
این ماژول باید یک یا چند شرط را به عنوان آرگومان‌های ماژول دریافت کند، و احراز هویت تنها در صورتی موفق خواهد شد که تمام شرط‌ها برقرار باشند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
پرچم‌های (\fIflag\fR) زیر پشتیبانی می‌شوند:
.PP
debug
.RS 4
پیام‌های اشکال‌زدایی ارسال‌شده به syslog را فعال می‌کند\&.
.RE
.PP
use_uid
.RS 4
ارزیابی شرایط را با استفاده از حساب کاربری انجام می‌دهد که برنامه با UID آن در حال اجرا است، به‌جای کاربری که در حال احراز هویت است\&.
.RE
.PP
quiet
.RS 4
موفقیت یا شکست را در گزارش سیستم ثبت نمی‌کند\&.
.RE
.PP
quiet_fail
.RS 4
شکست را در گزارش سیستم ثبت نمی‌کند\&.
.RE
.PP
quiet_success
.RS 4
موفقیت را در گزارش سیستم ثبت نمی‌کند\&.
.RE
.PP
audit
.RS 4
کاربران ناشناخته را در گزارش سیستم ثبت می‌کند\&.
.RE
.PP
شرط‌ها (\fICondition\fRs) سه کلمه هستند: یک فیلد، یک آزمون، و مقداری برای آزمودن\&.
.PP
فیلدهای موجود عبارتند از
\fIuser\fR,
\fIuid\fR,
\fIgid\fR,
\fIshell\fR,
\fIhome\fR,
\fIruser\fR,
\fIrhost\fR,
\fItty\fR
و
\fIservice\fR:
.PP
field < number
.RS 4
مقدار فیلد از نظر عددی کمتر از number است\&.
.RE
.PP
field <= number
.RS 4
مقدار فیلد از نظر عددی کمتر یا مساوی number است\&.
.RE
.PP
field eq number
.RS 4
مقدار فیلد از نظر عددی برابر با number است\&.
.RE
.PP
field >= number
.RS 4
مقدار فیلد از نظر عددی بزرگتر یا مساوی number است\&.
.RE
.PP
field > number
.RS 4
مقدار فیلد از نظر عددی بزرگتر از number است\&.
.RE
.PP
field ne number
.RS 4
مقدار فیلد از نظر عددی متفاوت از number است\&.
.RE
.PP
field = string
.RS 4
فیلد دقیقاً با string داده‌شده مطابقت دارد\&.
.RE
.PP
field != string
.RS 4
فیلد با string داده‌شده مطابقت ندارد\&.
.RE
.PP
field =~ glob
.RS 4
فیلد با glob داده‌شده مطابقت دارد\&.
.RE
.PP
field !~ glob
.RS 4
فیلد با glob داده‌شده مطابقت ندارد\&.
.RE
.PP
field in item:item:\&.\&.\&.
.RS 4
فیلد در فهرست آیتم‌های جداشده با دونقطه قرار دارد\&.
.RE
.PP
field notin item:item:\&.\&.\&.
.RS 4
فیلد در فهرست آیتم‌های جداشده با دونقطه قرار ندارد\&.
.RE
.PP
user ingroup group[:group:\&.\&.\&.\&.]
.RS 4
کاربر در گروه(های) داده‌شده قرار دارد\&.
.RE
.PP
user notingroup group[:group:\&.\&.\&.\&.]
.RS 4
کاربر در گروه(های) داده‌شده قرار ندارد\&.
.RE
.PP
user innetgr netgroup
.RS 4
زوج (user,host) در netgroup داده‌شده قرار دارد\&.
.RE
.PP
user notinnetgr group
.RS 4
زوج (user,host) در netgroup داده‌شده قرار ندارد\&.
.RE
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.PP
تمام انواع ماژول (\fBaccount\fR,
\fBauth\fR,
\fBpassword\fR
و
\fBsession\fR) ارائه می‌شوند\&.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
PAM_SUCCESS
.RS 4
شرط درست (true) بود\&.
.RE
.PP
PAM_AUTH_ERR
.RS 4
شرط نادرست (false) بود\&.
.RE
.PP
PAM_SERVICE_ERR
.RS 4
یک خطای سرویس رخ داده است یا امکان تجزیه صحیح آرگومان‌ها وجود ندارد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای شبیه‌سازی رفتار
\fIpam_wheel\fR، به جز اینکه هیچ حالت بازگشتی (fallback) برای گروه 0 وجود ندارد و فقط با بررسی عضویت در گروه root نیز تقریب زده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
auth required pam_succeed_if\&.so quiet user ingroup wheel:root

.fi
.if n \{\
.RE
.\}
.PP
با فرض اینکه نوع مطابقت داشته باشد، قاعده othermodule را تنها در صورتی بارگذاری می‌کند که UID بیش از ۵۰۰ باشد\&. عدد پس از default را برای نادیده گرفتن چندین قاعده تنظیم کنید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
type [default=1 success=ignore] pam_succeed_if\&.so quiet uid > 500
type required othermodule\&.so arguments\&.\&.\&.

.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBglob\fR(7),
\fBpam\fR(8)
.SH "نویسنده (AUTHOR)"
.PP
Nalin Dahyabhai <nalin@redhat\&.com>