'\" t
.\"     Title: pam_keyinit
.\"    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_KEYINIT" "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_keyinit \- ماژول PAM برای مقداردهی اولیه جاکلیدی جلسه کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_keyinit\&.so\fR\ 'u
\fBpam_keyinit\&.so\fR [debug] [force] [revoke]
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول PAM با نام pam_keyinit تضمین می‌کند که فرایند فراخواننده، یک جاکلیدی جلسه (session keyring) به غیر از جاکلیدی جلسه پیش‌فرض کاربر داشته باشد\&.
.PP
این ماژول بررسی می‌کند که آیا جاکلیدی جلسهٔ فرایند همان
\fBuser-session-keyring\fR(7)
است یا خیر؛ و اگر چنین باشد، یک
\fBsession-keyring\fR(7)
جدید ایجاد کرده و آن را جایگزین می‌کند\&. اگر جاکلیدی جلسه جدیدی ایجاد شود، پیوندی به
\fBuser-keyring\fR(7)
در جاکلیدی جلسه نصب خواهد کرد تا کلیدهای مشترک برای کاربر به طور خودکار از طریق آن در دسترس باشند\&. از آن پس جاکلیدی جلسهٔ فرایند فراخواننده توسط تمام فرایندهای فرزند آن به ارث برده می‌شود مگر آنکه آن را لغو و بازنویسی کنند\&.
.PP
به منظور اجازه دادن به سایر ماژول‌های PAM برای ضمیمه کردن توکن‌ها به جاکلیدی، این ماژول هم یک مولفهٔ
\fIauth\fR
(محدود به
\fBpam_setcred\fR(3))
و هم یک مولفهٔ
\fIsession\fR
ارائه می‌دهد\&. جاکلیدی جلسه در ماژول فراخوانی‌شده ایجاد می‌شود\&. علاوه بر این، این ماژول باید در ابتدایی‌ترین نقطهٔ ممکن در پیکربندی PAM گنجانده شود\&.
.PP
این ماژول در درجهٔ اول برای استفاده توسط فرایندهای ورود (login) در نظر گرفته شده است\&. آگاه باشید که پس از جایگزینی جاکلیدی جلسه، جاکلیدی جلسهٔ قبلی و کلیدهای موجود در آن دیگر در دسترس نخواهند بود\&.
.PP
این ماژول به طور کلی نباید توسط برنامه‌هایی مانند
\fBsu\fR
فراخوانی شود، زیرا معمولاً مطلوب است که مجموعه کلیدها به زمینهٔ (context) جایگزین منتقل شوند\&. کلیدها سیستم مجوزهای اختصاصی خود را برای مدیریت این موضوع دارند\&.
.PP
بستهٔ keyutils برای دستکاری مستقیم‌تر کلیدها استفاده می‌شود\&. این بسته را می‌توان از نشانی زیر دریافت کرد:
.PP
\m[blue]\fBKeyutils\fR\m[]\&\s-2\u[1]\d\s+2
.SH "گزینه‌ها (OPTIONS)"
.PP
debug
.RS 4
اطلاعات اشکال‌زدایی را با
\fBsyslog\fR(3)
ثبت می‌کند\&.
.RE
.PP
force
.RS 4
باعث می‌شود جاکلیدی جلسهٔ فرایند فراخواننده بدون قید و شرط جایگزین شود\&.
.RE
.PP
revoke
.RS 4
باعث می‌شود در صورتی که جاکلیدی جلسه در ابتدا برای همین فرایند ایجاد شده باشد، هنگام خروج فرایند فراخواننده، جاکلیدی جلسه باطل شود\&.
.RE
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.PP
تنها نوع ماژول
\fBsession\fR
ارائه می‌شود\&.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
PAM_SUCCESS
.RS 4
این ماژول معمولاً این مقدار را بازمی‌گرداند\&.
.RE
.PP
PAM_AUTH_ERR
.RS 4
شکست در احراز هویت\&.
.RE
.PP
PAM_BUF_ERR
.RS 4
خطای بافر حافظه\&.
.RE
.PP
PAM_IGNORE
.RS 4
مقدار بازگشتی باید توسط بخش توزیع PAM نادیده گرفته شود\&.
.RE
.PP
PAM_SERVICE_ERR
.RS 4
نام کاربری قابل تشخیص نیست\&.
.RE
.PP
PAM_SESSION_ERR
.RS 4
در صورتی که آرگومان‌های این ماژول نامعتبر باشند یا یک خطای سیستمی مانند ENOMEM رخ دهد، این مقدار بازگردانده می‌شود\&.
.RE
.PP
PAM_USER_UNKNOWN
.RS 4
کاربر شناخته‌شده نیست\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
این خط را به مدخل‌های ورود خود اضافه کنید تا هر جلسهٔ ورود با جاکلیدی جلسهٔ اختصاصی خود آغاز شود:
.sp
.if n \{\
.RS 4
.\}
.nf
session  required  pam_keyinit\&.so

.fi
.if n \{\
.RE
.\}
.PP
این کار از نشت کلیدهای یک جلسه به جلسهٔ دیگر برای همان کاربر جلوگیری می‌کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpam.conf\fR(5),
\fBpam.d\fR(5),
\fBpam\fR(8),
\fBkeyctl\fR(1)
.SH "نویسنده (AUTHOR)"
.PP
pam_keyinit توسط David Howells <dhowells@redhat\&.com> نوشته شده است\&.
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
Keyutils
.RS 4
\%http://people.redhat.com/~dhowells/keyutils
.RE