'\" t
.\"     Title: pam_wrapper
.\"    Author: The Samba Team
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2020-01-31
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PAM_WRAPPER" "1" "2020\-01\-31" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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_wrapper \- یک لایه واسط قابل پیش‌بارگذاری برای آزمایش برنامه‌ها و ماژول‌های PAM
.SH "خلاصه دستور (SYNOPSIS)"
.sp
LD_PRELOAD=libpam_wrapper\&.so PAM_WRAPPER=1 PAM_WRAPPER_SERVICE_DIR=/path_to_config \fB\&./myapplication\fR
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار به شما امکان می‌دهد برنامه کاربردی یا ماژول PAM خود را آزمایش کنید. برای آزمایش برنامه‌های PAM، ماژول ساده‌ای به نام
.B pam_matrix
نوشته شده است (بخش زیر را ببینید). اگر قصد دارید یک ماژول PAM را آزمایش کنید، می‌توانید از کتابخانه
.B pamtest
که پیاده‌سازی شده استفاده کنید. این کتابخانه آزمودن ماژول‌ها را ساده می‌کند. می‌توانید آن را با چارچوب آزمون واحد cmocka ترکیب کنید یا از بایندینگ‌های ارائه‌شده پایتون برای نوشتن آزمون‌های ماژول خود در پایتون بهره ببرید.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.sp
ابزار pam_wrapper از طریق متغیرهای محیطی فعال و کنترل می‌شود. می‌توانید متغیرهای زیر را تنظیم کنید:
.PP
\fBPAM_WRAPPER\fR
.RS 4
اگر pam_wrapper را بارگذاری کرده و با تنظیم PAM_WRAPPER=1 آن را فعال کنید، تمام فراخوانی‌های PAM رهگیری و پوشش داده می‌شوند تا بتوانید دایرکتوری حاوی فایل‌های سرویس مورد استفاده pam_wrapper را مشخص نمایید.
.RE
.PP
\fBPAM_WRAPPER_SERVICE_DIR\fR
.RS 4
دایرکتوری مبدا برای خواندن فایل‌های سرویس PAM.
.RE
.sp
اگر می‌خواهید از pam_matrix (توضیحات زیر را ببینید) استفاده کنید یا قصد دارید ماژول PAM اختصاصی خود را آزمایش کنید، باید مسیر مطلق ماژول خود را در فایل‌های سرویس مشخص نمایید.
.PP
\fBPAM_WRAPPER_DEBUGLEVEL\fR
.RS 4
اگر نیاز دارید از رخدادهای درون pam_wrapper مطلع شوید یا در پی یافتن باگ هستید، در صورتی که آن را با نمادهای اشکال‌زدایی (debug symbols) کامپایل کرده باشید، می‌توانید پشتیبانی از ثبت وقایع (logging) را در pam_wrapper فعال کنید.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
0 = ERROR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
1 = WARNING
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
2 = DEBUG
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
3 = TRACE
.RE
.RE
.PP
\fBPAM_WRAPPER_USE_SYSLOG\fR
.RS 4
به‌طور پیش‌فرض لاگ‌های pam به سطح لاگ DEBUG در pam_wrapper می‌روند و به syslog فرستاده نمی‌شوند. اگر می‌خواهید لاگ‌ها در syslog نیز ثبت شوند، می‌توانید این متغیر را برابر با 1 قرار دهید.
.RE
.PP
\fBPAM_WRAPPER_KEEP_DIR\fR
.RS 4
اگر این گزینه روی 1 تنظیم شود، pam_wrapper دایرکتوری‌های موقت خود را حذف نخواهد کرد. این قابلیت بیشتر برای توسعه‌دهندگان pam_wrapper مفید است.
.RE
.PP
\fBPAM_WRAPPER_DISABLE_DEEPBIND\fR
.RS 4
این متغیر امکان غیرفعال کردن اتصال عمیق (deep binding) را در pam_wrapper فراهم می‌کند. این ویژگی برای اجرای ابزارهای valgrind یا ابزارهای پاک‌سازی (مانند address، undefined، thread) کاربرد دارد.
.RE
.SH "مثال (EXAMPLE)"
.sp
یک فایل سرویس برای pam_wrapper باید به شکل زیر باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
auth            required        /usr/lib/pam_wrapper/pam_matrix\&.so passdb=/path/to/pdb
account         required        /usr/lib/pam_wrapper/pam_matrix\&.so passdb=/path/to/pdb
password        required        /usr/lib/pam_wrapper/pam_matrix\&.so passdb=/path/to/pdb
session         required        /usr/lib/pam_wrapper/pam_matrix\&.so passdb=/path/to/pdb
.fi
.if n \{\
.RE
.\}
.sp
نام فایل باید بیانگر نام سرویس مورد استفاده توسط برنامه کاربردی PAM شما باشد.
.sp
LD_PRELOAD=\&./libpam_wrapper\&.so PAM_WRAPPER=1 PAM_WRAPPER_SERVICE_DIR=\&./pam_services \&./my_pam_app
.SH "PAM_MATRIX"
.sp
ماژولی برای ساده‌تر کردن فرآیند آزمایش برنامه‌های PAM فراهم شده است. می‌توانید اطلاعات بیشتر را در صفحه راهنمای pam_matrix(8) بیابید.
.SH "نویسنده (AUTHOR)"
.PP
\fBThe Samba Team\fR
.RS 4
نویسنده.
.RE