'\" t .\" Title: pam_env .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.79.2 .\" Date: 01/26/2026 .\" Manual: Linux-PAM Manual .\" Source: Linux-PAM .\" Language: Persian .\" .TH "PAM_ENV" "8" "01/26/2026" "Linux\-PAM" "راهنمای Linux\-PAM" .\" ----------------------------------------------------------------- .\" * 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_env \- ماژول PAM برای تنظیم و حذف متغیرهای محیطی .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBpam_env\&.so\fR\ 'u \fBpam_env\&.so\fR [debug] [conffile=\fIconf\-file\fR] [envfile=\fIenv\-file\fR] [readenv=\fI0|1\fR] [user_envfile=\fIenv\-file\fR] [user_readenv=\fI0|1\fR] .SH "توضیحات (DESCRIPTION)" .PP ماژول PAM با نام pam_env امکان تنظیم یا حذف متغیرهای محیطی را فراهم می‌کند\&. استفاده از متغیرهای محیطی که پیش‌تر تنظیم شده‌اند و همچنین \fIPAM_ITEM\fRهایی مانند \fIPAM_RHOST\fR پشتیبانی می‌شود\&. .PP به‌طور پیش‌فرض قوانین مربوط به تنظیم و حذف متغیرها از پروندهٔ پیکربندی /etc/security/pam_env\&.conf خوانده می‌شود\&. یک پروندهٔ جایگزین می‌تواند با گزینهٔ \fIconffile\fR مشخص شود\&. .PP در مرحلهٔ دوم، پرونده‌ای (به‌طور پیش‌فرض /etc/environment) شامل جفت‌های سادهٔ \fIKEY=VAL\fR در خطوط جداگانه خوانده خواهد شد\&. با گزینهٔ \fIenvfile\fR می‌توان یک پروندهٔ جایگزین را مشخص کرد و با گزینهٔ \fIreadenv\fR می‌توان این فرایند را به‌طور کامل غیرفعال نمود\&. .PP در مرحلهٔ سوم، یک پروندهٔ پیکربندی کاربری (به‌طور پیش‌فرض $HOME/\&.pam_environment) خوانده می‌شود\&. پروندهٔ پیش‌فرض را می‌توان با گزینهٔ \fIuser_envfile\fR تغییر داد و خواندن آن را با گزینهٔ \fIuser_readenv\fR فعال یا غیرفعال کرد\&. .PP از آن‌جا که تنظیم متغیرهای محیطی PAM می‌تواند بر سایر ماژول‌ها عوارض جانبی داشته باشد، این ماژول باید آخرین ماژول در پشته باشد\&. .PP این ماژول تنها در صورتی اجرا می‌شود که برنامهٔ اصلی \fBpam_setcred\fR(3) یا \fBpam_open_session\fR(3) را فراخوانی کند\&. اگر ماژول توسط \fBpam_authenticate\fR(3) فراخوانی شود، هیچ کاری انجام نمی‌دهد و \fIPAM_IGNORE\fR را برمی‌گرداند\&. .SH "گزینه‌ها (OPTIONS)" .PP conffile=/path/to/pam_env\&.conf .RS 4 مشخص کردن یک پروندهٔ پیکربندی جایگزین با ساختار pam_env\&.conf برای لغو پیش‌فرض\&. این گزینه زمانی که سرویس‌های مختلف به محیط‌های متفاوتی نیاز دارند می‌تواند مفید باشد\&. .RE .PP debug .RS 4 اطلاعات اشکال‌زدایی فراوانی با \fBsyslog\fR(3) ثبت می‌شود\&. .RE .PP envfile=/path/to/environment .RS 4 مشخص کردن یک پروندهٔ محیطی جایگزین برای لغو پیش‌فرض\&. نحو این پرونده به‌صورت جفت‌های سادهٔ \fIKEY=VAL\fR در خطوط جداگانه است\&. دستور \fIexport\fR می‌تواند برای سازگاری با bash مشخص شود، اما نادیده گرفته خواهد شد\&. این گزینه زمانی که سرویس‌های مختلف به محیط‌های متفاوتی نیاز دارند می‌تواند مفید باشد\&. .RE .PP readenv=0|1 .RS 4 خواندن پروندهٔ مشخص‌شده توسط envfile را فعال یا غیرفعال می‌کند (۰ خاموش، ۱ روشن)\&. به‌طور پیش‌فرض این گزینه فعال است\&. .RE .PP user_envfile=filename .RS 4 مشخص کردن یک پروندهٔ \&.pam_environment جایگزین برای لغو پیش‌فرض\&. نحو آن همانند پروندهٔ \fI/etc/security/pam_env\&.conf\fR است\&. نام پرونده نسبت به پوشهٔ خانگی کاربر در نظر گرفته می‌شود\&. این گزینه زمانی که سرویس‌های مختلف به محیط‌های متفاوتی نیاز دارند می‌تواند مفید باشد\&. .RE .PP user_readenv=0|1 .RS 4 خواندن پروندهٔ محیطی مختص به کاربر را فعال یا غیرفعال می‌کند\&. ۰ خاموش، ۱ روشن است\&. به‌طور پیش‌فرض این گزینه غیرفعال است، زیرا متغیرهای محیطی تعیین‌شده توسط کاربر در محیط PAM ممکن است رفتار ماژول‌های بعدی در پشته را بدون رضایت مدیر سیستم تغییر دهند\&. .sp به دلیل مسائل امنیتی، این قابلیت از نسخهٔ 1\&.5\&.0 منسوخ شده است و در آینده به‌طور کامل حذف خواهد شد\&. .RE .SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)" .PP انواع ماژول‌های \fBauth\fR و \fBsession\fR ارائه می‌شوند\&. .SH "مقادیر بازگشتی (RETURN VALUES)" .PP PAM_ABORT .RS 4 تمام داده‌ها یا گزینه‌های مربوطه قابل دریافت نبودند\&. .RE .PP PAM_BUF_ERR .RS 4 خطای بافر حافظه\&. .RE .PP PAM_IGNORE .RS 4 هیچ پروندهٔ pam_env\&.conf یا پروندهٔ محیطی یافت نشد، یا ماژول توسط \fBpam_authenticate\fR(3) فراخوانی شده است\&. .RE .PP PAM_SUCCESS .RS 4 متغیرهای محیطی با موفقیت تنظیم شدند\&. .RE .SH "فایل‌ها (FILES)" .PP /etc/security/pam_env\&.conf .RS 4 پروندهٔ پیکربندی پیش‌فرض .RE .PP /etc/environment .RS 4 پروندهٔ محیطی پیش‌فرض .RE .PP $HOME/\&.pam_environment .RS 4 پروندهٔ محیطی مختص کاربر .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBpam_env.conf\fR(5), \fBpam.d\fR(5), \fBpam\fR(8), \fBenviron\fR(7)\&. .SH "نویسنده (AUTHOR)" .PP pam_env توسط Dave Kinchlea نوشته شده است\&.