'\" t
.\"     Title: pam_get_items
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 2015-11-04
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PAM_GET_ITEMS" "8" "2015\-11\-04" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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_get_items \- ماژول آزمایشی PAM برای بازیابی آیتم‌های PAM ویژه ماژول
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pam_get_items\&.so
.SH "توضیحات (DESCRIPTION)"
.sp
ماژول‌های PAM داده‌ها را در \fIآیتم‌های\fR PAM ذخیره می‌کنند\&. این آیتم‌ها تنها از بافتار ماژول در دسترس هستند و نه از بافتار برنامه کاربردی، چرا که ممکن است حاوی داده‌های خصوصی باشند (PAM_AUTHTOK معمولاً شامل گذرواژه است)\&. اما هنگام آزمودن ماژول‌های PAM، معمولاً مطلوب است تا اطمینان حاصل شود که ماژول PAM تحت آزمایش، آیتم‌ها را برای ماژول بعدی همان‌گونه که انتظار می‌رود تنظیم می‌کند\&. ماژول pam_get_items این امر را با صدور تمام آیتم‌های PAM در قالب متغیرهای محیطی با استفاده از pam_putenv امکان‌پذیر می‌سازد\&. نام متغیر محیطی همانند نام ثابت آیتم PAM است\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
هیچ گزینه‌ای وجود ندارد\&.
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.sp
تمامی انواع ماژول (\fBaccount\fR، \fBauth\fR، \fBpassword\fR و \fBsession\fR) ارائه می‌شوند\&.
.SH "مثال (EXAMPLE)"
.sp
مثالی را در نظر بگیرید که بررسی می‌کند آیا pam_unix گذرواژه‌ای را که می‌خواند در پشتهٔ PAM قرار می‌دهد یا خیر\&. فایل سرویس آزمایشی شامل موارد زیر خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
auth required        pam_unix\&.so
auth required        pam_get_items\&.so
.fi
.if n \{\
.RE
.\}
.sp
سپس آزمون مکالمهٔ PAM را اجرا می‌کند و پس از آن فراخوانی می‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
pam_getenv(pamh, "PAM_AUTHTOK");
.fi
.if n \{\
.RE
.\}
.sp
جهت بازیابی گذرواژه\&.