'\" t
.\"     Title: dbus-run-session
.\"    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\-RUN\-SESSION" "1" "03/02/2025" "D\-Bus 1.16.2" "دستورهای کاربر"
.\" -----------------------------------------------------------------
.\" * 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-run-session \- اجرای یک فرایند در قالب یک نشست جدید D\-Bus
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBdbus\-run\-session\fR\ 'u
\fBdbus\-run\-session\fR [\-\-config\-file\ \fIFILENAME\fR] [\-\-dbus\-daemon\ \fIBINARY\fR] [\-\-] \fIPROGRAM\fR [\fIARGUMENTS\fR...]
.HP \w'\fBdbus\-run\-session\fR\ 'u
\fBdbus\-run\-session\fR \-\-help
.HP \w'\fBdbus\-run\-session\fR\ 'u
\fBdbus\-run\-session\fR \-\-version
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBdbus\-run\-session\fR
برای راه‌اندازی یک نمونه از گذرگاه نشست
\fBdbus\-daemon\fR
از یک اسکریپت شل، و اجرای یک برنامه مشخص درون آن نشست استفاده می‌شود.
\fBdbus\-daemon\fR
تا زمانی که آن برنامه در حال اجرا باشد کار خواهد کرد و پس از آن خاتمه می‌یابد.
.PP
یک کاربرد آن، اجرای یک شل به همراه
\fBdbus\-daemon\fR
اختصاصی خودش در یک نشست متنی یا SSH است، به طوری که
\fBdbus\-daemon\fR
هنگام خروج از زیرشل به صورت خودکار پایان یابد؛ مانند زیر:
.PP
dbus\-run\-session \-\- bash
.PP
یا جایگزین کردن کامل شل ورود، از طریق ترکیب
\fBdbus\-run\-session\fR
با دستور توکار
\fBexec\fR:
.PP
exec dbus\-run\-session \-\- bash
.PP
کاربرد دیگر، اجرای آزمون‌های پس‌رفت (regression tests) و موارد مشابه در یک نشست مجزای D\-Bus است، تا از تداخل با نشست «واقعی» D\-Bus یا وابستگی به فعال بودن پیشین یک نشست D\-Bus جلوگیری شود؛ به عنوان مثال:
.PP
dbus\-run\-session \-\- make check
.PP
یا (در
\fBautomake\fR(1)):
.sp
.if n \{\
.RS 4
.\}
.nf
  AM_TESTS_ENVIRONMENT = export MY_DEBUG=all;
  LOG_COMPILER = dbus\-run\-session
  AM_LOG_FLAGS = \-\-
.fi
.if n \{\
.RE
.\}
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-config\-file=\fR\fIFILENAME\fR, \fB\-\-config\-file\fR \fIFILENAME\fR
.RS 4
ارسال
\fB\-\-config\-file=\fR\fIFILENAME\fR
به دیمن گذرگاه، به جای ارسال آرگومان
\fB\-\-session\fR
به آن. به
\fBdbus\-daemon\fR(1)
مراجعه کنید.
.RE
.PP
\fB\-\-dbus\-daemon=\fR\fIBINARY\fR, \fB\-\-dbus\-daemon\fR \fIBINARY\fR
.RS 4
اجرای
\fIBINARY\fR
به عنوان
\fBdbus\-daemon\fR(1)،
به جای جست‌وجو در متغیر
\fBPATH\fR
به روش معمول برای یافتن فایل اجرایی با نام
\fBdbus\-daemon\fR.
.RE
.PP
\fB\-\-help\fR
.RS 4
چاپ اطلاعات استفاده و خروج.
.RE
.PP
\fB\-\-version\fR
.RS 4
چاپ نسخه dbus\-run\-session و خروج.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
\fBdbus\-run\-session\fR
با وضعیت خروج
\fIPROGRAM\fR
خارج می‌شود؛ در صورت استفاده از گزینه‌های
\fB\-\-help\fR
یا
\fB\-\-version\fR
با مقدار 0، در صورت بروز خطایی در درون خودِ
\fBdbus\-run\-session\fR
با مقدار 127، یا اگر
\fIPROGRAM\fR
توسط سیگنال
\fIn\fR
کشته شده باشد با مقدار 128+\fIn\fR
خارج می‌شود.
.SH "محیط (ENVIRONMENT)"
.PP
متغیر
\fBPATH\fR
برای یافتن
\fIPROGRAM\fR،
و (اگر گزینه \-\-dbus\-daemon استفاده نشده باشد یا آرگومان آن شامل نویسه
\fB/\fR
نباشد) برای یافتن
\fBdbus\-daemon\fR
جست‌وجو می‌شود.
.PP
آدرس گذرگاه نشست در متغیر محیطی
\fBDBUS_SESSION_BUS_ADDRESS\fR
در اختیار
\fIPROGRAM\fR
قرار می‌گیرد.
.PP
متغیرهای
\fBDBUS_SESSION_BUS_PID\fR،
\fBDBUS_SESSION_BUS_WINDOWID\fR،
\fBDBUS_STARTER_BUS_TYPE\fR
و
\fBDBUS_STARTER_ADDRESS\fR
در صورت وجود، از محیط حذف می‌شوند.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.PP
لطفاً گزارش‌های باگ را به فهرست پستی یا سامانه ردیابی اشکالات D\-Bus ارسال کنید؛ به نشانی زیر مراجعه کنید:
.PP
<https://www.freedesktop.org/wiki/Software/dbus>
.SH "نویسندگان (AUTHORS)"
.PP
نگاه کنید به:
.PP
<https://dbus.freedesktop.org/doc/AUTHORS>
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdbus\-daemon\fR(1),
\fBdbus\-launch\fR(1)