'\" t
.\"     Title: pam_filter
.\"    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_FILTER" "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_filter \- ماژول PAM برای فیلتر کردن جریان داده‌های ورودی/خروجی جلسه
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_filter\&.so\fR\ 'u
\fBpam_filter\&.so\fR [debug] [new_term] [non_term] run1|run2 \fIfilter\fR [\fI\&.\&.\&.\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
این ماژول به عنوان بستری برای دسترسی به تمام داده‌های ورودی/خروجی که میان کاربر و برنامه ردوبدل می‌شوند در نظر گرفته شده است\&. این ماژول تنها برای برنامه‌های مبتنی بر tty و (stdin/stdout) مناسب است\&.
.PP
این ماژول برای کارکرد خود به نصب بودن
\fIfilters\fR
(فیلترها) روی سیستم نیاز دارد\&. تک فیلتر ارائه‌شده همراه با این ماژول، صرفاً حروف بزرگ و کوچک را در جریان‌های ورودی و خروجی جابه‌جا می‌کند\&. (این کار می‌تواند بسیار آزاردهنده باشد و با ویرایشگرهای مبتنی بر termcap سازگاری خوبی ندارد)\&.
.PP
هر مؤلفه از ماژول پتانسیل فراخوانی فیلتر موردنظر را دارد\&. فیلتر همواره با
\fBexecv\fR(2)
و با سطح دسترسی برنامهٔ فراخوان اجرا می‌شود و
\fInot\fR
(نه) با دسترسی کاربر\&. به همین دلیل معمولاً کاربر نمی‌تواند آن را بدون بستن جلسهٔ (نشست) خود متوقف کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
debug
.RS 4
اطلاعات اشکال‌زدایی را چاپ می‌کند\&.
.RE
.PP
new_term
.RS 4
اقدام پیش‌فرض فیلتر این است که مورد
\fIPAM_TTY\fR
را جهت مشخص کردن پایانه‌ای که کاربر برای اتصال به برنامه استفاده می‌کند تنظیم کند\&. این آرگومان مشخص می‌کند که فیلتر باید
\fIPAM_TTY\fR
را روی شبه‌پایانهٔ (pseudo\-terminal) فیلترشده تنظیم کند\&.
.RE
.PP
non_term
.RS 4
برای تنظیم مورد
\fIPAM_TTY\fR
تلاش نکن\&.
.RE
.PP
runX
.RS 4
برای اینکه ماژول بتواند فیلتری را فراخوانی کند، باید بداند چه زمانی آن را اجرا کند\&. این آرگومان برای اعلام زمان انجام این کار به فیلتر الزامی است\&.
.sp
مقدارهای مجاز برای
\fIX\fR
شامل
\fI1\fR
و
\fI2\fR
هستند\&. این مقادیر زمان دقیق اجرای فیلتر را مشخص می‌کنند\&. برای درک این مفهوم، مطالعهٔ صفحه راهنمای
\fBpam\fR(3)
مفید خواهد بود\&. اساساً برای هر گروه مدیریتی حداکثر دو روش برای فراخوانی توابع ماژول وجود دارد\&. در مورد مؤلفه‌های
\fIauthentication\fR
و
\fIsession\fR
در واقع دو تابع جداگانه وجود دارد\&. در مورد احراز هویت (authentication)، این توابع
\fBpam_authenticate\fR(3)
و
\fBpam_setcred\fR(3)
هستند؛ در اینجا
\fBrun1\fR
به معنای اجرای فیلتر از تابع
\fBpam_authenticate\fR
و
\fBrun2\fR
به معنای اجرای فیلتر از
\fBpam_setcred\fR
است\&. در مورد ماژول‌های نشست (session)، مقدار
\fIrun1\fR
بیانگر فراخوانی فیلتر در مرحلهٔ
\fBpam_open_session\fR(3)
است و
\fIrun2\fR
برای
\fBpam_close_session\fR(3)\&.
.sp
در مورد مؤلفهٔ حساب کاربری (account)، می‌توان از
\fIrun1\fR
یا
\fIrun2\fR
استفاده کرد\&.
.sp
در مورد مؤلفهٔ گذرواژه (password)، از
\fIrun1\fR
برای نشان دادن اجرای فیلتر در نخستین نوبت
\fBpam_chauthtok\fR(3)
(مرحلهٔ
\fIPAM_PRELIM_CHECK\fR)
و از
\fIrun2\fR
برای نشان دادن اجرای فیلتر در نوبت دوم (مرحلهٔ
\fIPAM_UPDATE_AUTHTOK\fR)
استفاده می‌شود\&.
.RE
.PP
filter
.RS 4
مسیر کامل پروندهٔ فیلتر برای اجرا و هرگونه آرگومان‌های خط فرمانی که فیلتر ممکن است انتظار داشته باشد\&.
.RE
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.PP
تمام انواع ماژول (\fBauth\fR،
\fBaccount\fR،
\fBpassword\fR
و
\fBsession\fR) ارائه شده‌اند\&.
.SH "مقدارهای بازگشتی (RETURN VALUES)"
.PP
.PP
PAM_SUCCESS
.RS 4
فیلتر جدید با موفقیت تنظیم شد\&.
.RE
.PP
PAM_ABORT
.RS 4
خطای بحرانی، لغو فوری\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
خط زیر را به
/etc/pam\&.d/login
اضافه کنید تا نحوهٔ پیکربندی login برای جابه‌جا کردن حروف بزرگ و کوچک پس از ورود کاربر را مشاهده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
        session required pam_filter\&.so run1 /lib/security/pam_filter/upperLOWER

.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpam.conf\fR(5)،
\fBpam.d\fR(5)،
\fBpam\fR(8)
.SH "نویسنده (AUTHOR)"
.PP
ماژول pam_filter توسط Andrew G\&. Morgan <morgan@kernel\&.org> نوشته شده است\&.