'\" t
.\"     Title: dbus-update-activation-environment
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/02/2025
.\"    Manual: User Commands
.\"    Source: D-Bus 1.16.2
.\"  Language: Persian
.\"
.TH "DBUS\-UPDATE\-ACTIVA" "1" "03/02/2025" "D\-Bus 1\&.16\&.2" "User Commands"
.\" -----------------------------------------------------------------
.\" * 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)"
dbus-update-activation-environment \- بهروزرسانی متغیرهای محیطی سرویسهای D-Bus
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBdbus\-update\-activation\-environment\fR\ 'u
\fBdbus\-update\-activation\-environment\fR [\-\-systemd] [\-\-verbose] \-\-all | \fIVAR\fR... | \fIVAR\fR=\fIVAL\fR... 
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBdbus\-update\-activation\-environment\fR
فهرست متغیرهای محیطی مورد استفاده توسط
\fBdbus\-daemon \-\-session\fR
را هنگامی که سرویس‌های نشست را بدون استفاده از
\fBsystemd\fR
فعال می‌کند، به‌روزرسانی می‌نماید.
.PP
با گزینه
\fB\-\-systemd\fR،
اگر نمونه‌ای از
\fBsystemd \-\-user\fR
روی D\-Bus در دسترس باشد، همچنین فهرست متغیرهای محیطی مورد استفاده توسط
\fBsystemd \-\-user\fR
را هنگامی که سرویس‌های کاربر را فعال می‌کند به‌روزرسانی می‌کند؛ از جمله سرویس‌های نشست D\-Bus که
\fBdbus\-daemon\fR
به‌گونه‌ای پیکربندی شده است که فعال‌سازی آن‌ها را به
\fBsystemd\fR
واگذار کند. این کار بسیار شبیه به دستور
\fBimport\-environment\fR
ارائه‌شده توسط
\fBsystemctl\fR(1)
است.
.PP
متغیرهایی که برای
\fBdbus\-daemon\fR
یا
\fBsystemd\fR
خاص هستند ممکن است مقداردهی شوند، اما مقادیر آن‌ها هنگام شروع یک سرویس بازنویسی خواهد شد. برای نمونه، افزودن
\fBDBUS_SESSION_BUS_ADDRESS\fR
به محیط فعال‌سازی
\fBdbus\-daemon\fR
مفید نیست، اگرچه ممکن است افزودن آن به محیط فعال‌سازی
\fBsystemd\fR
همچنان مفید باشد.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-all\fR
.RS 4
تنظیم تمام متغیرهای محیطی موجود در محیط مورد استفاده توسط
\fBdbus\-update\-activation\-environment\fR\&.
.RE
.PP
\fB\-\-systemd\fR
.RS 4
تنظیم متغیرهای محیطی برای سرویس‌های کاربری systemd و همچنین برای سرویس‌های سنتی نشست D\-Bus.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
چاپ پیام‌ها در خروجی خطای استاندارد (stderr) برای توضیح کارهایی که dbus\-update\-activation\-environment انجام می‌دهد.
.RE
.PP
\fIVAR\fR
.RS 4
اگر
\fIVAR\fR
در محیط
\fBdbus\-update\-activation\-environment\fR
وجود داشته باشد، آن را با همان مقدار برای سرویس‌های D\-Bus تنظیم می‌کند. مقدار آن باید UTF\-8 باشد (اگر نباشد، با یک هشدار نادیده گرفته می‌شود). اگر
\fIVAR\fR
در محیط وجود نداشته باشد، این آرگومان بدون هیچ پیامی نادیده گرفته می‌شود.
.RE
.PP
\fIVAR\fR=\fIVAL\fR
.RS 4
مقداردهی
\fIVAR\fR
به
\fIVAL\fR،
که باید UTF\-8 باشد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
دستور
\fBdbus\-update\-activation\-environment\fR
در درجه نخست برای استفاده در اسکریپت‌های راه‌اندازی نشست‌های X11 توزیع‌های لینوکس، همراه با الگوی «گذرگاه کاربر» (user bus) طراحی شده است.
.PP
برای انتشار
\fBDISPLAY\fR
و
\fBXAUTHORITY\fR
به
\fBdbus\-daemon\fR
و (در صورت وجود) به
\fBsystemd\fR،
و انتشار
\fBDBUS_SESSION_BUS_ADDRESS\fR
به
\fBsystemd\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
        dbus\-update\-activation\-environment \-\-systemd \e
            DBUS_SESSION_BUS_ADDRESS DISPLAY XAUTHORITY
      
.fi
.if n \{\
.RE
.\}
.PP
برای انتشار تمام متغیرهای محیطی به جز
\fBXDG_SEAT\fR،
\fBXDG_SESSION_ID\fR
و
\fBXDG_VTNR\fR
به
\fBdbus\-daemon\fR
(و در صورت وجود به
\fBsystemd\fR)
جهت سازگاری با اسکریپت‌های راه‌اندازی قدیمی نشست‌های X11:
.sp
.if n \{\
.RS 4
.\}
.nf
        # 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
        )
      
.fi
.if n \{\
.RE
.\}
.sp
.SH "وضعیت خروج (EXIT STATUS)"
.PP
دستور
\fBdbus\-update\-activation\-environment\fR
در صورت موفقیت با وضعیت 0 خارج می‌شود؛ با EX_USAGE (64) در صورت گزینه‌های نامعتبر خط فرمان؛ با EX_OSERR (71) در صورت عدم توانایی در اتصال به گذرگاه نشست؛ یا با EX_UNAVAILABLE (69) در صورت عدم توانایی در تنظیم متغیرهای محیطی خارج می‌شود. کدهای خروج غیرصفر دیگری ممکن است در نسخه‌های آینده افزوده شوند.
.SH "محیط (ENVIRONMENT)"
.PP
متغیرهای
\fBDBUS_SESSION_BUS_ADDRESS\fR،
\fBXDG_RUNTIME_DIR\fR
و/یا
\fBDISPLAY\fR
برای یافتن آدرس گذرگاه نشست استفاده می‌شوند.
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
برنامه
\fBdbus\-daemon\fR
راهکاری برای لغو تنظیم (unset) متغیرهای محیطی پس از تنظیم شدن آن‌ها فراهم نمی‌کند (اگرچه
\fBsystemd\fR
این کار را می‌کند)، بنابراین
\fBdbus\-update\-activation\-environment\fR
نیز این قابلیت را ارائه نمی‌دهد.
.PP
استاندارد POSIX نحوه کدگذاری (encoding) نام‌ها یا مقادیر غیر ASCII متغیرهای محیطی را تعیین نکرده و اجازه می‌دهد شامل هر بایت غیرصفری باشند، اما نه
\fBdbus\-daemon\fR
و نه
\fBsystemd\fR
از متغیرهای محیطی با نام‌ها یا مقادیر غیر UTF\-8 پشتیبانی نمی‌کنند. بر این اساس،
\fBdbus\-update\-activation\-environment\fR
فرض می‌کند هر نام یا مقداری که به نظر می‌رسد UTF\-8 معتبر باشد، برای UTF\-8 در نظر گرفته شده است، و سایر نام‌ها یا مقادیر را با یک هشدار نادیده می‌گیرد.
.SH "گزارش اشکالات (BUGS)"
.PP
لطفاً گزارش‌های باگ را به سامانه ردیابی باگ یا فهرست پستی D\-Bus ارسال کنید. ببینید:
.br
<https://www.freedesktop.org/wiki/Software/dbus>
.SH "نویسندگان (AUTHORS)"
.PP
ببینید:
.br
<https://dbus.freedesktop.org/doc/AUTHORS>
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdbus-daemon\fR(1),
\fBsystemd\fR(1),
دستور
\fBimport\-environment\fR
از
\fBsystemctl\fR(1)
.SH "حق نشر (COPYRIGHT)"
.br
کپی‌رایت \(co 2015 Collabora Ltd.
.br
.PP
این صفحه راهنما تحت همان شرایط dbus\-update\-activation\-environment (مجوز MIT/X11) توزیع می‌شود. تا حد مجاز طبق قانون، هیچ‌گونه ضمانتی وجود ندارد.
.sp