نام (NAME)

dbus-run-session - اجرای یک فرایند در قالب یک نشست جدید D-Bus

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

dbus-run-session [--config-file FILENAME] [--dbus-daemon BINARY] [--] PROGRAM [ARGUMENTS...]

dbus-run-session --help

dbus-run-session --version

توضیحات (DESCRIPTION)

دستور dbus-run-session برای راه‌اندازی یک نمونه از گذرگاه نشست dbus-daemon از یک اسکریپت شل، و اجرای یک برنامه مشخص درون آن نشست استفاده می‌شود. dbus-daemon تا زمانی که آن برنامه در حال اجرا باشد کار خواهد کرد و پس از آن خاتمه می‌یابد.

یک کاربرد آن، اجرای یک شل به همراه dbus-daemon اختصاصی خودش در یک نشست متنی یا SSH است، به طوری که dbus-daemon هنگام خروج از زیرشل به صورت خودکار پایان یابد؛ مانند زیر:

dbus-run-session -- bash

یا جایگزین کردن کامل شل ورود، از طریق ترکیب dbus-run-session با دستور توکار exec:

exec dbus-run-session -- bash

کاربرد دیگر، اجرای آزمون‌های پس‌رفت (regression tests) و موارد مشابه در یک نشست مجزای D-Bus است، تا از تداخل با نشست «واقعی» D-Bus یا وابستگی به فعال بودن پیشین یک نشست D-Bus جلوگیری شود؛ به عنوان مثال:

dbus-run-session -- make check

یا (در automake(1)):

AM_TESTS_ENVIRONMENT = export MY_DEBUG=all;
LOG_COMPILER = dbus-run-session
AM_LOG_FLAGS = --

گزینه‌ها (OPTIONS)

--config-file=FILENAME, --config-file FILENAME

--dbus-daemon=BINARY, --dbus-daemon BINARY

--help

--version

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

dbus-run-session با وضعیت خروج PROGRAM خارج می‌شود؛ در صورت استفاده از گزینه‌های --help یا --version با مقدار 0، در صورت بروز خطایی در درون خودِ dbus-run-session با مقدار 127، یا اگر PROGRAM توسط سیگنال n کشته شده باشد با مقدار 128+n خارج می‌شود.

محیط (ENVIRONMENT)

متغیر PATH برای یافتن PROGRAM، و (اگر گزینه --dbus-daemon استفاده نشده باشد یا آرگومان آن شامل نویسه / نباشد) برای یافتن dbus-daemon جست‌وجو می‌شود.

آدرس گذرگاه نشست در متغیر محیطی DBUS_SESSION_BUS_ADDRESS در اختیار PROGRAM قرار می‌گیرد.

متغیرهای DBUS_SESSION_BUS_PID، DBUS_SESSION_BUS_WINDOWID، DBUS_STARTER_BUS_TYPE و DBUS_STARTER_ADDRESS در صورت وجود، از محیط حذف می‌شوند.

گزارش باگ‌ها (REPORTING BUGS)

لطفاً گزارش‌های باگ را به فهرست پستی یا سامانه ردیابی اشکالات D-Bus ارسال کنید؛ به نشانی زیر مراجعه کنید:

https://www.freedesktop.org/wiki/Software/dbus

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

نگاه کنید به:

https://dbus.freedesktop.org/doc/AUTHORS

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

dbus-daemon(1), dbus-launch(1)