نام (NAME)

dbus-update-activation-environment - بهروزرسانی متغیرهای محیطی سرویسهای D-Bus

خلاصه دستور (SYNOPSIS)

dbus-update-activation-environment [--systemd] [--verbose] --all | VAR... | VAR=VAL...

توضیحات (DESCRIPTION)

دستور dbus-update-activation-environment فهرست متغیرهای محیطی مورد استفاده توسط dbus-daemon --session را هنگامی که سرویس‌های نشست را بدون استفاده از systemd فعال می‌کند، به‌روزرسانی می‌نماید.

با گزینه --systemd، اگر نمونه‌ای از systemd --user روی D-Bus در دسترس باشد، همچنین فهرست متغیرهای محیطی مورد استفاده توسط systemd --user را هنگامی که سرویس‌های کاربر را فعال می‌کند به‌روزرسانی می‌کند؛ از جمله سرویس‌های نشست D-Bus که dbus-daemon به‌گونه‌ای پیکربندی شده است که فعال‌سازی آن‌ها را به systemd واگذار کند. این کار بسیار شبیه به دستور import-environment ارائه‌شده توسط systemctl(1) است.

متغیرهایی که برای dbus-daemon یا systemd خاص هستند ممکن است مقداردهی شوند، اما مقادیر آن‌ها هنگام شروع یک سرویس بازنویسی خواهد شد. برای نمونه، افزودن DBUS_SESSION_BUS_ADDRESS به محیط فعال‌سازی dbus-daemon مفید نیست، اگرچه ممکن است افزودن آن به محیط فعال‌سازی systemd همچنان مفید باشد.

گزینه‌ها (OPTIONS)

--all

--systemd

--verbose

VAR

VAR=VAL

مثال‌ها (EXAMPLES)

دستور dbus-update-activation-environment در درجه نخست برای استفاده در اسکریپت‌های راه‌اندازی نشست‌های X11 توزیع‌های لینوکس، همراه با الگوی «گذرگاه کاربر» (user bus) طراحی شده است.

برای انتشار DISPLAY و XAUTHORITY به dbus-daemon و (در صورت وجود) به systemd، و انتشار DBUS_SESSION_BUS_ADDRESS به systemd:

dbus-update-activation-environment --systemd \
    DBUS_SESSION_BUS_ADDRESS DISPLAY XAUTHORITY

برای انتشار تمام متغیرهای محیطی به جز XDG_SEAT، XDG_SESSION_ID و XDG_VTNR به dbus-daemon (و در صورت وجود به systemd) جهت سازگاری با اسکریپت‌های راه‌اندازی قدیمی نشست‌های X11:

# in a subshell so the variables remain set in the
# parent script
(
  unset XDG_SEAT
  unset XDG_SESSION_ID
  unset XDG_VTNR
  dbus-update-activation-environment --systemd --all
)

وضعیت خروج (EXIT STATUS)

دستور dbus-update-activation-environment در صورت موفقیت با وضعیت 0 خارج می‌شود؛ با EX_USAGE (64) در صورت گزینه‌های نامعتبر خط فرمان؛ با EX_OSERR (71) در صورت عدم توانایی در اتصال به گذرگاه نشست؛ یا با EX_UNAVAILABLE (69) در صورت عدم توانایی در تنظیم متغیرهای محیطی خارج می‌شود. کدهای خروج غیرصفر دیگری ممکن است در نسخه‌های آینده افزوده شوند.

محیط (ENVIRONMENT)

متغیرهای DBUS_SESSION_BUS_ADDRESS، XDG_RUNTIME_DIR و/یا DISPLAY برای یافتن آدرس گذرگاه نشست استفاده می‌شوند.

محدودیت‌ها (LIMITATIONS)

برنامه dbus-daemon راهکاری برای لغو تنظیم (unset) متغیرهای محیطی پس از تنظیم شدن آن‌ها فراهم نمی‌کند (اگرچه systemd این کار را می‌کند)، بنابراین dbus-update-activation-environment نیز این قابلیت را ارائه نمی‌دهد.

استاندارد POSIX نحوه کدگذاری (encoding) نام‌ها یا مقادیر غیر ASCII متغیرهای محیطی را تعیین نکرده و اجازه می‌دهد شامل هر بایت غیرصفری باشند، اما نه dbus-daemon و نه systemd از متغیرهای محیطی با نام‌ها یا مقادیر غیر UTF-8 پشتیبانی نمی‌کنند. بر این اساس، dbus-update-activation-environment فرض می‌کند هر نام یا مقداری که به نظر می‌رسد UTF-8 معتبر باشد، برای UTF-8 در نظر گرفته شده است، و سایر نام‌ها یا مقادیر را با یک هشدار نادیده می‌گیرد.

گزارش اشکالات (BUGS)

لطفاً گزارش‌های باگ را به سامانه ردیابی باگ یا فهرست پستی D-Bus ارسال کنید. ببینید:
https://www.freedesktop.org/wiki/Software/dbus

نویسندگان (AUTHORS)

ببینید:
https://dbus.freedesktop.org/doc/AUTHORS

همچنین ببینید (SEE ALSO)

dbus-daemon(1), systemd(1), دستور import-environment از systemctl(1)

حق نشر (COPYRIGHT)

کپی‌رایت © 2015 Collabora Ltd.

این صفحه راهنما تحت همان شرایط dbus-update-activation-environment (مجوز MIT/X11) توزیع می‌شود. تا حد مجاز طبق قانون، هیچ‌گونه ضمانتی وجود ندارد.