'\" t
.TH "ENVIRONMENT\&.D" "5" "" "systemd 261.2" "environment.d"
.\" -----------------------------------------------------------------
.\" * 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)"
environment.d \- تعریف متغیرهای محیطی برای نشستهای کاربری
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.RS 4
~/\&.config/environment\&.d/*\&.conf
.RE
.RS 4
/etc/environment\&.d/*\&.conf
.RE
.RS 4
/run/environment\&.d/*\&.conf
.RE
.RS 4
/usr/local/lib/environment\&.d/*\&.conf
.RE
.RS 4
/usr/lib/environment\&.d/*\&.conf
.RE
.RS 4
/etc/environment
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
فایل‌های پیکربندی در دایرکتوری‌های
environment\&.d/
شامل فهرست‌هایی از مقداردهی‌های متغیرهای محیطی هستند که به سرویس‌های آغازشده توسط نمونه کاربری systemd ارسال می‌شوند\&.
\fBsystemd-environment-d-generator\fR(8)
آن‌ها را تجزیه کرده و محیط صادرشده توسط نمونه کاربری systemd را به‌روزرسانی می‌کند\&. برای بررسی اینکه کدام فرآیندها این متغیرها را به ارث می‌برند، ادامه متن را ببینید\&.
.PP
دایرکتوری پیکربندی در سطح کاربر به طور پیش‌فرض
~/\&.config/environment\&.d/\&
است\&. اگر
\fI$XDG_CONFIG_HOME\fR
روی یک مسیر مطلق در محیط مدیر سرویس کاربر تنظیم شده باشد (مثلاً از طریق PAM یا
/etc/environment)،
بر
~/\&.config/
اولویت دارد\&. توجه داشته باشید که این مسئله نکته‌ای در راه‌اندازی اولیه (bootstrapping) ایجاد می‌کند: متغیرهای تنظیم‌شده در فایل‌های
environment\&.d/،
از جمله خودِ
\fI$XDG_CONFIG_HOME\fR،
هنگامی که مولد تعیین می‌کند کدام دایرکتوری را بخواند، در دسترس نیستند\&.
.PP
توصیه می‌شود برای ساده‌سازی ترتیب‌بندی، از پیشوندهای عددی در نام فایل‌ها استفاده شود\&.
.PP
برای سازگاری با نسخه‌های پیشین، یک پیوند نمادین (symlink) به
/etc/environment
نصب شده است، بنابراین این فایل نیز تجزیه می‌شود\&.
.SH "دایرکتوریهای پیکربندی و اولویتبندی (CONFIGURATION DIRECTORIES AND PRECEDENCE)"
.PP
فایل‌های پیکربندی از دایرکتوری‌های موجود در
/etc/،
/run/،
/usr/local/lib/
و
/usr/lib/،
به ترتیب اولویت، همان‌طور که در بخش خلاصه دستور در بالا فهرست شده است، خوانده می‌شوند\&. فایل‌ها باید پسوند
"\&.conf"
داشته باشند\&. فایل‌های موجود در
/etc/
بر فایل‌های هم‌نام در
/run/،
/usr/local/lib/
و
/usr/lib/
ارجحیت دارند\&. فایل‌های موجود در
/run/
بر فایل‌های هم‌نام زیر
/usr/
ارجحیت دارند\&.
.PP
تمام فایل‌های پیکربندی صرف‌نظر از دایرکتوری محل قرارگیری‌شان، بر اساس نام فایل به ترتیب واژه‌نگاری (lexicographic) مرتب می‌شوند\&. اگر چندین فایل یک گزینه را مشخص کنند، مدخل فایلی که از لحاظ واژه‌نگاری نام مؤخرتری دارد اولویت خواهد داشت\&. بنابراین، پیکربندی موجود در یک فایل خاص می‌تواند یا به طور کامل جایگزین شود (با قرار دادن فایلی با همان نام در دایرکتوری دارای اولویت بالاتر)، یا تنظیمات مجزا می‌توانند تغییر یابند (با مشخص کردن تنظیمات بیشتر در فایلی با نام دیگر که از نظر ترتیب در رده بعدی قرار می‌گیرد)\&.
.PP
بسته‌ها باید فایل‌های پیکربندی خود را در
/usr/lib/
(بسته‌های توزیع) یا
/usr/local/lib/
(نصب‌های محلی)
\&\s-2\u[1]\d\s+2\&
نصب کنند\&. فایل‌های موجود در
/etc/
برای مدیر سیستم محلی محفوظ هستند، که می‌تواند با استفاده از این منطق، فایل‌های پیکربندی ارائه‌شده توسط بسته‌های توزیع‌کننده را بازنویسی (override) کند\&.
.PP
توصیه می‌شود برای ساده‌سازی ترتیب‌بندی، تمام نام‌های فایل با یک عدد دورقمی و یک خط تیره شروع شوند\&. توصیه می‌شود از محدوده 10\-40 برای فایل‌های پیکربندی در
/usr/
و محدوده 60\-90 برای فایل‌های پیکربندی در
/etc/
و
/run/
استفاده شود تا اطمینان حاصل گردد که فایل‌های پیکربندی محلی و گذرا همواره بر فایل‌های پیکربندی ارائه‌شده توسط توزیع‌کننده سیستم‌عامل اولویت خواهند داشت\&.
.PP
اگر مدیر سیستم بخواهد یک فایل پیکربندی ارائه‌شده توسط توزیع‌کننده را غیرفعال کند، روش توصیه‌شده قرار دادن یک پیوند نمادین (symlink) به
/dev/null
در دایرکتوری پیکربندی در
/etc/،
با همان نام فایل پیکربندی توزیع‌کننده است\&. اگر فایل پیکربندی توزیع‌کننده در ایمیج initrd گنجانده شده باشد، ایمیج باید بازتولید شود\&.
.SH "فرمت پیکربندی (CONFIGURATION FORMAT)"
.PP
فایل‌های پیکربندی حاوی فهرستی از انتساب‌های متغیرهای محیطی به صورت
"\fIKEY\fR=\fIVALUE\fR"
هستند که با خط جدید جدا می‌شوند\&. سمت راست این انتساب‌ها می‌تواند با استفاده از قالب
"${OTHER_KEY}"
و
"$OTHER_KEY"
به متغیرهای محیطی تعریف‌شده قبلی ارجاع دهد\&. همچنین می‌توان از
"${\fIFOO\fR:\-\fIDEFAULT_VALUE\fR}"
استفاده کرد تا همانند
"${\fIFOO\fR}"
بسط یابد، مگر اینکه نتیجه بسط خالی باشد که در این صورت به
\fIDEFAULT_VALUE\fR
بسط می‌یابد، و از
"${\fIFOO\fR:+\fIALTERNATE_VALUE\fR}"
برای بسط یافتن به
\fIALTERNATE_VALUE\fR
تا زمانی که
"${\fIFOO\fR}"
به مقداری غیرخالی بسط داده شود استفاده کرد\&. می‌توانید نویسه دلار واقعی
"$"
را با دو بار نوشتن آن اسکیپ کنید، مانند
"$$"\&.
.PP
نویسه بک‌اسلش
"\e"
اگر بلافاصله با یک خط جدید دنبال شود، به عنوان ادامه خط عمل می‌کند (هر دو نویسه نادیده گرفته می‌شوند)؛ در تمام موارد دیگر، بک‌اسلش مصرف شده و نویسه پس از آن به صورت لفظی (literal) در مقدار گنجانده می‌شود\&. این کار می‌تواند برای حفظ فاصله‌های خالی ابتدایی/انتهایی یا درج بک‌اسلش‌های واقعی استفاده شود\&.
.PP
می‌توانید به دلخواه، سمت راست انتساب‌ها را در جفت‌های
\fB\*(Aq\fRکوتیشن تکی\fB\*(Aq\fR
یا
\fB"\fRدابل کوتیشن\fB"\fR
محصور کنید؛ این نشانه‌ها قبل از ذخیره مقدار حذف خواهند شد\&. استفاده از هر کدام از شیوه‌های نقل‌قول بر بسط متغیر تأثیری ندارد؛ با این حال، کوتیشن تکی اسکیپ کردن با بک‌اسلش را کاملاً غیرفعال می‌کند، در حالی که دابل کوتیشن بک‌اسلش‌هایی را که پیش از دابل کوتیشن
"""،
علامت دلار
"$"،
بک‌اسلش
"\e"،
بک‌تیک
"`"
و خط‌های جدید قرار دارند حذف می‌کند و سایر بک‌اسلش‌ها را دست‌نخورده باقی می‌گذارد\&.
.PP
نویسه‌های فاصله‌گذاری ابتدایی و انتهایی از هر دو سمت چپ و راست انتساب حذف می‌شوند\&. برای حفظ چنین فاصله‌هایی در مقدار، می‌توانید کل مقدار را در کوتیشن قرار دهید، یا نویسه‌های فاصله را با بک‌اسلش اسکیپ کنید\&. همچنین می‌توانید خطوط جدید واقعی را با قرار دادن مقدار در کوتیشن لحاظ نمایید\&.
.PP
هر
\fIKEY\fR
باید یک نام متغیر معتبر باشد\&. خطوط خالی و خطوطی که با نویسه‌های توضیحات
"#"
یا
";"
آغاز می‌شوند نادیده گرفته خواهند شد\&. هیچ عنصر دیگری از نحو شل پشتیبانی نمی‌شود\&.
.SH "مثالها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&آماده‌سازی محیط برای دسترسی به برنامه‌ای که در /opt/foo نصب شده است\fR
.PP
/etc/environment\&.d/60\-foo\&.conf:
.sp
.if n \{\
.RS 4
.\}
.nf
FOO_DEBUG=force\-software\-gl,log\-verbose
PATH=/opt/foo/bin:$PATH
LD_LIBRARY_PATH=/opt/foo/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}
XDG_DATA_DIRS=/opt/foo/share:${XDG_DATA_DIRS:\-/usr/local/share/:/usr/share/}
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&2.\ \&اسکیپ کردن و بسط متغیر\fR
.PP
/etc/environment\&.d/70\-bar\&.conf:
.sp
.if n \{\
.RS 4
.\}
.nf
# A comment
test_var=(variable)
; Another comment
test_comment=value # This is a part of the variable, and not a comment!

test_none= \e before\e
after "" \*(Aq\*(Aq \e${test_var}
test_double=" \e before\e
after "" \*(Aq\*(Aq \e${test_var}"
test_single=\*(Aq \e before\e
after "" \*(Aq\*(Aq \e${test_var}\*(Aq

# The above example produces the following environment variables, written using
# C\-style string escapes:
#
# test_var="(variable)"
# test_comment="value # This is a part of the variable, and not a comment!"
# test_none=" beforeafter \e"\e" \*(Aq\*(Aq (variable)"
# test_double=" \e\e beforeafter  \*(Aq\*(Aq (variable)"
# test_single=" \e\e before\e\e\enafter \e"\e"  \e\e(variable)"
.fi
.if n \{\
.RE
.\}
.SH "دامنه کاربرد (APPLICABILITY)"
.PP
متغیرهای محیطی صادرشده توسط مدیر سرویس کاربر (نمونه
\fBsystemd \-\-user\fR
آغازشده در سرویس سیستمی
user@\fIuid\fR\&.service)
به تمام سرویس‌های آغازشده توسط آن مدیر سرویس منتقل می‌شوند\&. به طور خاص، این ممکن است شامل سرویس‌هایی باشد که شل‌های کاربر را اجرا می‌کنند\&. برای مثال در محیط GNOME، شبیه‌ساز ترمینال گرافیکی به عنوان واحد کاربری
gnome\-terminal\-server\&.service
اجرا می‌شود که به نوبه خود شل کاربر را اجرا می‌کند، بنابراین آن شل متغیرهای محیطی صادرشده توسط مدیر کاربر را به ارث خواهد برد\&. برای سایر نمونه‌های شل که توسط مدیر سرویس کاربر راه‌اندازی نشده‌اند، محیطی که به ارث می‌برند توسط برنامه‌ای که آنها را آغاز کرده است تعریف می‌شود\&. نکته: به طور کلی، واحدهای
\fBsystemd.service\fR(5)
حاوی برنامه‌های راه‌اندازی‌شده توسط systemd هستند و واحدهای
\fBsystemd.scope\fR(5)
حاوی برنامه‌های راه‌اندازی‌شده توسط چیز دیگری می‌باشند\&.
.PP
توجه داشته باشید که این فایل‌ها بر بلوک محیطی خودِ مدیر سرویس تأثیری نمی‌گذارند، بلکه منحصراً بر بلوک‌های محیطی ارسال‌شده به سرویس‌هایی که مدیریت می‌کند اثرگذارند\&. بنابراین متغیرهای محیطی تنظیم‌شده از این طریق نمی‌توانند برای تغییر رفتار مدیر سرویس استفاده شوند\&. به منظور اعمال تغییرات در بلوک محیطی مدیر سرویس، محیط باید قبل از فراخوانی مدیر سرویس کاربر اصلاح شود، به عنوان مثال از طریق مدیر سرویس سیستم یا از طریق یک ماژول PAM\&.
.PP
به طور خاص، برای ورودهای ssh، سرویس
\fBsshd\fR(8)
محیطی می‌سازد که ترکیبی از متغیرهای هدایت‌شده از سیستم راه دور و متغیرهای تعریف‌شده توسط
\fBsshd\fR
است؛ به بحث در
\fBssh\fR(1)
مراجعه کنید\&. یک نشست نمایشگر گرافیکی نیز سازوکار مشابهی برای تعریف محیط خواهد داشت\&. توجه داشته باشید که برخی از مدیرها نمونه کاربری systemd را برای محیط صادرشده پرس‌وجو کرده و این پیکربندی را با استفاده از
\fBsystemctl show\-environment\fR
یا فراخوانی بنیادین D\-Bus به برنامه‌هایی که شروع می‌کنند تزریق می‌نمایند\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-environment-d-generator\fR(8), \fBsystemd.environment-generator\fR(7)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
💣💥🧨💥💥💣 لطفاً توجه داشته باشید که این فایل‌های پیکربندی باید در تمام زمان‌ها در دسترس باشند\&. اگر
/usr/local/
یک پارتیشن جداگانه باشد، ممکن است در اوایل بوت در دسترس نباشد و نباید برای پیکربندی استفاده شود\&.