'\" t
.\"     Title: gnome-session
.\"    Author: gnome-session contributors
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 05/28/2026
.\"    Manual: دستورهای کاربر
.\"    Source: gnome-session
.\"  Language: Persian
.\"
.TH "GNOME\-SESSION" "1" "" "gnome-session" "دستورهای کاربر"
.\" -----------------------------------------------------------------
.\" * 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)"
gnome-session \- راه‌اندازی محیط میزکار GNOME
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBgnome\-session\fR\ 'u
\fBgnome\-session\fR [OPTION...]
.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ
\fBgnome\-session\fR
محیط میزکار GNOME را راه‌اندازی می‌کند\&. این دستور معمولاً توسط مدیر ورود شما (مانند GDM،‏ SDDM،‏ lightdm یا موارد دیگر) اجرا می‌شود\&. این برنامه یا نشست ذخیره‌شدهٔ شما را بارگذاری می‌کند، یا یک نشست پیش‌فرض برای کاربر طبق آنچه توسط مدیر سیستم (یا نصب پیش‌فرض GNOME بر روی سیستم شما) تعریف شده است فراهم می‌آورد\&.
.PP
نشست پیش‌فرض در
gnome\&.session
تعریف شده است؛ فایلی شبیه به
\&.desktop
که در مسیرهای
$XDG_CONFIG_HOME/gnome\-session/sessions،
$XDG_CONFIG_DIRS/gnome\-session/sessions
و
$XDG_DATA_DIRS/gnome\-session/sessions
جستجو می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-session\fR=SESSION
.RS 4
استفاده از برنامه‌های تعریف‌شده در
SESSION\&.session\&.
اگر مشخص نشود، از
gnome\&.session
استفاده خواهد شد\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
فعال‌سازی کد اشکال‌زدایی\&.
.RE
.SH "سیستم‌دی (SYSTEMD)"
.PP
برنامهٔ
\fBgnome\-session\fR
برای بخش عمدهٔ مدیریت سرویس‌های خود از
\fBsystemd\fR
استفاده می‌کند\&.
\fBsystemd\fR
دو تارگت ویژه برای یکپارچگی میزکار ارائه می‌دهد:
graphical\-session\&.target
و
graphical\-session\-pre\&.target\&.
این تارگت‌ها در تمام محیط‌های میزکار کار می‌کنند و در صورت امکان باید استفاده شوند\&.
\fBgnome\-session\fR
تارگت‌های اختصاصی زیر را برای GNOME فراهم می‌کند:
.PP
gnome\-session\&.target
.RS 4
واحدی عمومی که در سراسر نشست فعال خواهد بود\&. مشابه
graphical\-session\&.target\&.
.RE
.PP
gnome\-session\-pre\&.target
.RS 4
برای وظایفی که باید پیش از راه‌اندازی نشست انجام شوند استفاده می‌شود\&. مشابه
graphical\-session\-pre\&.target\&.
.RE
.PP
gnome\-session@SESSION\&.target
.RS 4
واحد اصلی شروع‌شده برای نشست\&.
\fISESSION\fR
بر اساس نشستی که از طریق
\fB\-\-session\fR
ارسال شده، تعیین می‌شود\&.
.RE
.PP
gnome\-session\-basic\-services\&.target
.RS 4
واحدی ویژه که سرویس‌های پایه‌ای مورد نیاز هر نشست GNOME ساخته‌شده حول
\fBgnome\-shell\fR
را فهرست می‌کند\&. این ویژگی امکان استفادهٔ مجدد آسان در نشست‌های کیوسک (مانند صفحهٔ ورود GDM) را فراهم می‌سازد\&.
.RE
.PP
gnome\-session\-x11\-services\&.target
.RS 4
واحدی ویژه که در صورت نیاز به سرویس‌های X11 شروع می‌شود\&. برنامه‌ها باید به جای
\fIDISPLAY\fR
از متغیر محیطی ویژهٔ
\fIGNOME_SETUP_DISPLAY\fR
استفاده کنند\&.
.RE
.PP
توجه داشته باشید که باید در تنظیم قوانین مناسب
\fIAfter=\fR
دقت شود\&. همچنین اکیداً توصیه می‌شود این کار همواره در ترکیب با
\fIBindsTo=\fR
یا
\fIPartOf=\fR
روی یکی از تارگت‌های اصلی (مانند
graphical\-session\&.target)
انجام گیرد\&.
.PP
واحدها موظف‌اند
\fICollectMode=inactive\-or\-failed\fR
را تنظیم کنند\&. علاوه بر این، اکیداً توصیه می‌شود که
\fITimeoutStopSec=5\fR
تنظیم شود تا در صورتی که فرایند به درستی متوقف نشد، خروج از سیستم به طور نامحدود به تعویق نیفتد\&.
.SH "تعریف نشست (SESSION DEFINITION)"
.PP
نشست‌ها در فایل‌های
\&.session
تعریف می‌شوند که قالبی شبیه به فایل‌های
\&.desktop
دارند، و کلیدهای زیر در گروه
GNOME Session
آن‌ها قرار می‌گیرد:
.PP
\fIName\fR
.RS 4
نام نشست\&. این مقدار می‌تواند بومی‌سازی شود\&.
.RE
.PP
\fIKiosk\fR
.RS 4
نشست‌های کیوسک (Kiosk) نشست‌های ویژهٔ تک‌منظوره‌ای هستند که حول راه‌اندازی یک برنامهٔ خاص ساخته شده‌اند\&. برای مثال، یک نشست کیوسک ممکن است یک مرورگر وب تمام‌صفحه را اجرا کند که روی صفحه‌ای خاص قفل شده است\&. در GNOME، ما از نشست‌های کیوسک برای صفحهٔ ورود (جایی که برنامه همان رابط کاربری صفحهٔ ورود است) و تجربهٔ نخستین راه‌اندازی (initial\-setup) استفاده می‌کنیم\&. هنگامی که روی true تنظیم شود،
\fBgnome\-session\fR
هیچ تلاشی برای اجرای خودکار هیچ‌کدام از فایل‌های
\&.desktop
نخواهد کرد، و در عوض ملزم می‌کند که نشست تمام قابلیت‌های لازم را از طریق systemd پیکربندی نماید\&.
.RE
.PP
نمونه‌ای از یک تعریف نشست:
.sp
.if n \{\
.RS 4
.\}
.nf
[GNOME Session]
Name=GNOME
.fi
.if n \{\
.RE
.\}
.PP
فایل‌های
\&.session
از مسیرهای
$XDG_CONFIG_HOME/gnome\-session/sessions،
$XDG_CONFIG_DIRS/gnome\-session/sessions
و
$XDG_DATA_DIRS/gnome\-session/sessions
بارگذاری می‌شوند\&.
.PP
تعاریف نشست به خودی خود کاری انجام نمی‌دهند، و باید با پیکربندی
\fBsystemd\fR
همراه باشند تا قابلیت‌هایی را فراهم کنند (یعنی سرویس‌ها را اجرا نمایند)\&. روش توصیه‌شده برای انجام این کار، قلاب شدن به یکی از تارگت‌های شرح‌داده‌شده در بالا است\&. به عنوان مثال: هنگام تعریف نشستی به نام
foobar،
می‌توانید یک فایل drop\-in متعلق به systemd در مسیر
/etc/systemd/user/gnome\-session@foobar\&.target\&.d/session\&.conf
ایجاد کرده و وابستگی‌های
Requires=
و
Wants=
را تعریف کنید تا به systemd اعلام کند هنگام راه‌اندازی این نشست، چه سرویس‌هایی باید اجرا شوند\&.
.SH "فایل‌ها (FILES)"
.PP
.if n \{\
.RS 4
.\}
.nf
      $XDG_CONFIG_HOME/autostart
      $XDG_CONFIG_DIRS/autostart
      /usr/share/gnome/autostart
    
.fi
.if n \{\
.RE
.\}
.PP
برنامه‌های تعریف‌شده توسط فایل‌های
\&.desktop
در این دایرکتوری‌ها هنگام ورود به سیستم راه‌اندازی خواهند شد\&. توجه داشته باشید که نسخه‌های قبلی
\fBgnome\-session\fR
سرویس‌ها را از اینجا اجرا می‌کردند، اما اکنون دیگر چنین نیست\&. سرویس‌ها اکنون باید از طریق فایل‌های واحد
\fBsystemd\fR
پیکربندی شوند\&.
.PP
.if n \{\
.RS 4
.\}
.nf
      $XDG_CONFIG_HOME/gnome\-session/sessions
      $XDG_CONFIG_DIRS/gnome\-session/sessions
      $XDG_DATA_DIRS/gnome\-session/sessions
    
.fi
.if n \{\
.RE
.\}
.PP
این دایرکتوری‌ها حاوی فایل‌های
\&.session
هستند که می‌توانند با گزینهٔ
\fB\-\-session\fR
استفاده شوند\&.
.SH "گزارش باگ‌ها (BUGS)"
.PP
اگر باگی در برنامهٔ
\fBgnome\-session\fR
یافتید، لطفاً آن را در https://gitlab\&.gnome\&.org/GNOME/gnome\-session/issues گزارش دهید\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBgnome-session-quit\fR(1)