'\" t
.\"     Title: pam_echo
.\"    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_ECHO" "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_echo \- ماژول PAM برای چاپ پیام به کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_echo\&.so\fR\ 'u
\fBpam_echo\&.so\fR [file=\fI/path/message\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول PAM با نام
\fIpam_echo\fR
برای چاپ پیام‌های متنی جهت آگاه ساختن کاربر از موارد ویژه است\&. دنباله‌هایی که با نویسه
\fI%\fR
آغاز می‌شوند به صورت زیر تفسیر می‌گردند:
.PP
%H
.RS 4
نام میزبان دوردست (PAM_RHOST)\&.
.RE
.PP
%h
.RS 4
نام میزبان محلی\&.
.RE
.PP
%s
.RS 4
نام سرویس (PAM_SERVICE)\&.
.RE
.PP
%t
.RS 4
نام پایانه مهارکننده (PAM_TTY)\&.
.RE
.PP
%U
.RS 4
نام کاربری دوردست (PAM_RUSER)\&.
.RE
.PP
%u
.RS 4
نام کاربری محلی (PAM_USER)\&.
.RE
.PP
تمام دنباله‌های دیگر که با
\fI%\fR
آغاز می‌شوند، به نویسه‌های پس از نویسه
\fI%\fR
گسترش می‌یابند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
file=/path/message
.RS 4
محتوای پرونده
/path/message
با تابع تبدیل PAM به عنوان PAM_TEXT_INFO چاپ خواهد شد\&.
.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_SUCCESS
.RS 4
پیام با موفقیت چاپ شد\&.
.RE
.PP
PAM_IGNORE
.RS 4
پرچم PAM_SILENT داده شده بود یا پرونده پیام وجود ندارد، پیامی چاپ نشد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای نمونه‌ای از کاربرد این ماژول، نشان می‌دهیم که چگونه می‌توان از آن برای چاپ اطلاعاتی درباره گذرواژه‌های مناسب استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
password optional pam_echo\&.so file=/usr/share/doc/good\-password\&.txt
password required pam_unix\&.so

.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpam.conf\fR(8),
\fBpam.d\fR(5),
\fBpam\fR(8)
.SH "نویسنده (AUTHOR)"
.PP
ماژول pam_echo توسط Thorsten Kukuk <kukuk@thkukuk\&.de> نوشته شده است\&.