.\"
.\" cinnamon-session manual page.
.\" (C) 2000 Miguel de Icaza (miguel@helixcode.com)
.\" (C) 2009-2010 Vincent Untz (vuntz@gnome.org)
.\"
.TH GNOME-SESSION 1 "GNOME"
.SH "نام (NAME)"
cinnamon-session \- مدیریت نشست‌های میزکار سینامون
.SH "خلاصه دستور (SYNOPSIS)"
.B cinnamon-session
[\-a|\-\-autostart=\fIDIR\fR] [\-\-session=\fISESSION\fR] [\-\-failsafe|\-f] [\-\-debug] [\-\-whale]
.SH "توضیحات (DESCRIPTION)"
برنامه
\fIcinnamon-session\fP
محیط میزکار را راه‌اندازی می‌کند. این دستور معمولاً توسط مدیر ورود به سیستم شما (مانند mdm، xdm، یا از طریق اسکریپت‌های راه‌اندازی X) اجرا می‌شود. این برنامه یا نشست ذخیره‌شده شما را بارگذاری می‌کند، یا یک نشست پیش‌فرض برای کاربر بر اساس تعریف مدیر سیستم (یا نصب پیش‌فرض سیستم) فراهم می‌سازد.
.PP
نشست پیش‌فرض در
\fBgnome.session\fP
تعریف می‌شود؛ فایلی با قالبی شبیه به .desktop که در مسیرهای زیر جستجو می‌گردد:
\fB$XDG_CONFIG_HOME/cinnamon-session/sessions\fP،
\fB$XDG_CONFIG_DIRS/cinnamon-session/sessions\fP
و
\fB$XDG_DATA_DIRS/cinnamon-session/sessions\fP.
.PP
هنگام ذخیره یک نشست،
\fIcinnamon-session\fP
برنامه‌های در حال اجرای فعلی را در پوشه
\fB$XDG_CONFIG_HOME/cinnamon-session/saved-session\fP
ذخیره می‌کند.
.PP
برنامه
\fIcinnamon-session\fP
یک مدیر نشست X11R6 است. این برنامه می‌تواند هم برنامه‌های گنوم و هم هر برنامه سازگار با مدیریت نشست X11R6 SM را مدیریت کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.I "--autostart=DIR"
راه‌اندازی تمام برنامه‌های تعریف‌شده در
\fIDIR\fP
به جای راه‌اندازی برنامه‌های تعریف‌شده در
\fBgnome.session\fP
یا مشخص‌شده از طریق گزینه
\fI--session\fP.
می‌توان چندین گزینه
\fI--autostart\fP
را به کار برد.
.TP
.I "--session=SESSION"
استفاده از برنامه‌های تعریف‌شده در
\fBSESSION.session\fP.
در صورت مشخص نشدن، از
\fBgnome.session\fP
استفاده خواهد شد.
.TP
.I "--failsafe"
اجرا در حالت امن (fail-safe). برنامه‌های تعیین‌شده توسط کاربر راه‌اندازی نخواهند شد.
.TP
.I "--debug"
فعال‌سازی کدهای اشکال‌زدایی.
.TP
.I "--whale"
نمایش پنجره اعلان خطای بحرانی (fail whale) به منظور اشکال‌زدایی.
.SH "تعریف نشست (SESSION DEFINITION)"
نشست‌ها در فایل‌های
\fB.session\fP
تعریف می‌شوند که از ساختاری مشابه با پرونده‌های .desktop استفاده کرده و شامل کلیدهای زیر در گروه
\fBGNOME Session\fP
هستند:
.TP
.I Name
نام نشست. این مقدار می‌تواند بومی‌سازی (ترجمه) شود.
.TP
.I RequiredComponents
فهرست شناسه‌های مؤلفه‌ها (فایل‌های desktop) که برای نشست ضروری هستند. مؤلفه‌های ضروری همواره در طول نشست اجرا خواهند شد.
.TP
.I RequiredProviders
فهرست ارائه‌دهندگان وظایف که برای نشست ضروری هستند. ارائه‌دهنده پیش‌فرض هر وظیفه باید با کلید
\fIDefaultProvider-TASK\fP
تعریف شود؛ این ارائه‌دهنده می‌تواند توسط مؤلفه‌های ضروری، نشست ذخیره‌شده یا برنامه‌های راه‌اندازی خودکار جایگزین شود. ارائه‌دهندگان وظایف همواره در نشست اجرا خواهند شد.
.TP
.I DefaultProvider-TASK
شناسه (پرونده desktop) ارائه‌دهنده پیش‌فرض برای
\fBTASK\fP.
اگر ارائه‌دهنده‌ای برای
\fBTASK\fP
در مؤلفه‌های ضروری، نشست ذخیره‌شده و برنامه‌های راه‌اندازی خودکار یافت نشود، این ارائه‌دهنده پیش‌فرض راه‌اندازی خواهد شد.
.PP
در ادامه نمونه‌ای از تعریف یک نشست آورده شده است:
.PP
.in +4n
.nf
[GNOME Session]
Name=GNOME fallback
RequiredComponents=gnome-panel;metacity;gnome-settings-daemon;
RequiredProviders=notifications;
DefaultProvider-notifications=notification-daemon
.in
.fi
.PP
فایل‌های
\fB.session\fP
در مسیرهای زیر جستجو می‌شوند:
\fB$XDG_CONFIG_HOME/cinnamon-session/sessions\fP،
\fB$XDG_CONFIG_DIRS/cinnamon-session/sessions\fP
و
\fB$XDG_DATA_DIRS/cinnamon-session/sessions\fP.
.SH "محیط (ENVIRONMENT)"
برنامه
\fIcinnamon-session\fP
چندین متغیر محیطی را برای استفاده فرآیندهای فرزند خود مقداردهی می‌کند:
.PP
.B SESSION_MANAGER
.IP
این متغیر توسط کلاینت‌های آگاه از مدیر نشست جهت برقراری ارتباط با
cinnamon-session
استفاده می‌شود.
.PP
.B DISPLAY
.IP
این متغیر روی نمایشگر X مورد استفاده توسط
\fIcinnamon-session\fP
تنظیم می‌گردد. توجه داشته باشید در صورتی که گزینه
\fI--display\fP
استفاده شود، ممکن است این مقدار با تنظیمات متغیر محیطی در هنگام فراخوانی cinnamon-session متفاوت باشد.
.SH "فایل‌ها (FILES)"
.PP
.B $XDG_CONFIG_HOME/config/autostart
.B $XDG_CONFIG_DIRS/config/autostart
.B /usr/share/gnome/autostart
.IP
برنامه‌های تعریف‌شده در این پوشه‌ها هنگام ورود به سیستم راه‌اندازی می‌شوند.
می‌توان از
\fIcinnamon-settings(1)\fP
برای پیکربندی آسان آن‌ها استفاده کرد.
.PP
.B $XDG_CONFIG_HOME/cinnamon-session/sessions
.B $XDG_CONFIG_DIRS/cinnamon-session/sessions
.B $XDG_DATA_DIRS/cinnamon-session/sessions
.IP
این پوشه‌ها شامل فایل‌های
\fB.session\fP
هستند که می‌توان آن‌ها را همراه با گزینه
\fI--session\fP
استفاده نمود.
.PP
.B $XDG_CONFIG_HOME/cinnamon-session/saved-session
.IP
این پوشه شامل فهرست برنامه‌های نشست ذخیره‌شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR cinnamon-settings (1),
.BR cinnamon-session-quit (1)