.TH "DBUS\-BROKER\-LAUNCH" "1" "سپتامبر ۲۰۲۲" "dbus-broker" "دستورهای کاربری"
.SH "نام (NAME)"
dbus-broker-launch \- راهانداز گذرگاه پیام D-Bus مبتنی بر dbus-broker
.SH "خلاصه دستور (SYNOPSIS)"
.B dbus-broker-launch
[\fIگزینهها\fR...]
.br
.B dbus-broker-launch
\fB\-\-version\fR
.br
.B dbus-broker-launch
\fB\-\-help\fR
.SH "توضیحات (DESCRIPTION)"
برنامه \fBdbus-broker-launch\fR یک مدیر اجرای با سطح اختیارات بالا برای واسط پیامرسانی D-Bus با پیادهسازی dbus-broker است.
این برنامه یک راه‌انداز برای
.B dbus\-broker
می‌باشد که یک گذرگاه پیام D-Bus را اجرا و مدیریت می‌کند. هدف این راه‌انداز، سازگاری کامل با پیاده‌سازی مرجع D-Bus یعنی
.BR dbus\-daemon (1)
است و از همان ساختار و نحو پیکربندی و محیط زمان اجرا پشتیبانی می‌کند.
.PP
هر نمونه از
.B dbus\-broker\-launch
دقیقاً یک گذرگاه پیام را مدیریت می‌کند. هر گذرگاه پیام کاملاً مستقل است. فایل پیکربندی می‌تواند از طریق خط فرمان مشخص شود، یا به صورت پیش‌فرض از مسیر
.I /usr/share/dbus\-1
انتخاب گردد. تقریباً تمامی ویژگی‌ها و مشخصه‌های پیکربندی پشتیبانی می‌شوند. برای مشاهده جزئیات مربوط به ساختار پیکربندی به
.BR dbus\-daemon (1)
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های خط فرمان زیر پشتیبانی می‌شوند. در صورتی که گزینه‌ای ارسال شود که در این فهرست وجود ندارد، راه‌انداز از شروع کار خودداری کرده و با یک خطا خارج می‌شود.
.TP
.BR \-h ", " \-\-help
نمایش اطلاعات راهنما و نحوه استفاده و سپس خروج فوری.
.TP
.B \-\-version
نمایش نسخه ساخت برنامه و خروج فوری.
.TP
.B \-\-audit
فعال‌سازی ثبت وقایع در زیرسیستم حسابرسی (audit) لینوکس.
(اگر پشتیبانی از audit در زمان کامپایل گنجانده نشده باشد، این گزینه بی‌استفاده خواهد بود؛
.BR پیش‌فرض :
خاموش).
.TP
.BI \-\-config\-file= PATH
تعیین فایل پیکربندی مورد استفاده
.RB ( پیش‌فرض :
.IR /usr/share/dbus\-1/{system,session}.conf ).
.TP
.BI \-\-scope= SCOPE
انتخاب حوزه کاری برای اجرا (یکی از مقادیر:
.IR system ،
.IR user ؛
.BR پیش‌فرض :
.IR system ).
.SH "ثبت وقایع (LOGGING)"
.PP
به‌طور پیش‌فرض،
.B dbus\-broker\-launch
پیام‌ها را در ژورنال سیستم (system journal) ثبت می‌کند. این پیام‌ها با فراداده‌های زیادی همراه شده‌اند، بنابراین حتماً فیلدهای اضافی ژورنال را بررسی کنید. پیام‌های ثبت گزارش که برای انسان قابل خواندن هستند، عمداً کوتاه نگه داشته شده‌اند.
.PP
هنگام راه‌اندازی و خاموش شدن، راه‌انداز پیام‌های اولیه‌ای را ثبت می‌کند که حاوی اطلاعاتی درباره فایل‌های پیکربندی و تعاریف سرویس‌های پردازش‌شده هستند. هیچ پیام دیگری در لاگ تولید نمی‌شود، مگر پیام‌هایی که مستقیماً از طرف
.BR dbus\-broker (1)
ارسال شده باشند.
.SH "حوزه کاری (SCOPE)"
.PP
برخلاف
.BR dbus\-daemon (1)،
برنامه
.B dbus\-broker\-launch
تمام سرویس‌ها را به عنوان واحدهای systemd فعال می‌کند. سرویس‌هایی که از پیش دارای یک واحد systemd هستند به صورت معمول فعال می‌شوند، اما سرویس‌هایی که فاقد واحد systemd می‌باشند به صورت یک واحد گذرا (transient unit) با فایل واحد موردی (ad-hoc) که در زمان اجرا تولید می‌شود، فعال می‌گردند. این کار تضمین می‌کند که تمامی سرویس‌ها در یک محیط کاملاً استاندارد و تعریف‌شده اجرا شوند.
.PP
پارامتر
.B \-\-scope
تعیین می‌کند که راه‌انداز باید از کدام نمونه systemd برای فعال‌سازی سرویس‌ها استفاده کند. در صورت انتخاب
.IR system ،
راه‌انداز از نمونه سیستمی systemd استفاده می‌کند. در صورت انتخاب
.IR user ،
نمونه کاربری به کار گرفته می‌شود.
.PP
علاوه بر این، حوزه کاریِ انتخاب‌شده تعیین می‌کند که در صورت عدم تعیین فایل در خط فرمان، از کدام فایل پیکربندی استفاده شود.
.PP
حوزه کاریِ انتخاب‌شده هیچ اثر دیگری ندارد. این پارامتر فقط برای تعیین محیط فعال‌سازی تعاریف سرویس‌های بارگذاری‌شده نیاز است. اگر هیچ سرویس قابل فعال‌سازی تعریف نشده باشد، تعیین این حوزه هیچ اثری نخواهد داشت.
.SH "سوکت‌ها (SOCKETS)"
.PP
سوکتی که برای گوش دادن به اتصالات کلاینت استفاده می‌شود باید توسط فرایند والد ایجاد شده و به
.B dbus\-broker\-launch
تحویل داده شود. این پروتکل باید از فعال‌سازی با سوکت همان‌طور که در
.BR systemd.socket (1)
تعریف شده است پیروی کند. در حال حاضر فقط یک سوکت واحد پشتیبانی می‌شود.
.PP
ویژگی‌های اضافی
.I <listen>%path%</listen>
در فایل پیکربندی نادیده گرفته می‌شوند.
.SH "سطوح دسترسی (PRIVILEGES)"
.PP
این راه‌انداز تنها نیازمند دسترسی خواندن به فایل پیکربندی خود است. به غیر از این، به هیچ سطح اختیارات خاصی نیاز نیست. در صورتی که مشخصه پیکربندی
.I <user>%user%</user>
استفاده شود، راه‌انداز هنگام اجرای
.B dbus\-broker
اختیارات خود را کاهش می‌دهد (drop privileges).
.PP
اگر سرویس‌های قابل فعال‌سازی تعریف شده باشند، راه‌انداز به دسترسی به نمونه systemd متناظر نیاز خواهد داشت. راه‌انداز باید مجاز به ایجاد واحدهای گذرا (transient units) و همچنین مدیریت واحدهای تعریف‌شده در تعاریف سرویس باشد.
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR dbus\-daemon (1)،
.BR dbus\-broker (1)