.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "labwc" "1" "2026\-08\-22"
.PP
.SH "نام (NAME)"
.PP
labwc \- یک کامپوزیتور پشته‌ای Wayland
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBlabwc\fR [options.\&.\&.\&]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه Labwc یک کامپوزیتور پشته‌ای (stacking compositor) مبتنی بر wlroots برای Wayland است.\&
.PP
این برنامه سبک و مستقل بوده و تمرکز آن بر روی چینش پشته‌ای مناسب پنجره‌ها و رندر کردن برخی تزیینات پنجره است.\& در صورت امکان، از کلاینت‌های مجزا برای تصویر پس‌زمینه، پنل‌ها، تصویربرداری از صفحه (اسکرین‌شات) و موارد دیگر استفاده می‌کند.\&
.PP
.SH "سیگنال‌ها (SIGNALS)"
.PP
کامپوزیتور به ترتیب با دریافت سیگنال‌های SIGTERM و SIGHUP، خارج شده یا پیکربندی خود را مجدداً بارگذاری می‌کند.\& برای مثال:
.PP
.nf
.RS 4
kill \-s <signal> $LABWC_PID
killall \-s <signal> labwc
.fi
.RE
.PP
هر نمونه در حال اجرای labwc، متغیر محیطی `LABWC_PID` را برابر با PID خود قرار می‌دهد.\& این ویژگی برای ارسال سیگنال به یک نمونه خاص مفید است و گزینه‌های `\-\-exit` و `\-\-reconfigure` از همین سازوکار استفاده می‌کنند.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-c, \-\-config\fR <config\-file>
.RS 4
مشخص کردن فایل پیکربندی همراه با مسیر آن
.PP
.RE
\fB\-C, \-\-config\-dir\fR <config\-directory>
.RS 4
مشخص کردن دایرکتوری پیکربندی
.PP
.RE
\fB\-d, \-\-debug\fR
.RS 4
فعال‌سازی ثبت گزارش (logging) کامل، شامل اطلاعات اشکال‌زدایی.\& برای گزینه‌های بیشتر بخش \fBمتغیرهای محیطی (ENVIRONMENT VARIABLES)\fR در زیر را ببینید.\&
.PP
.RE
\fB\-e, \-\-exit\fR
.RS 4
خروج از کامپوزیتور با ارسال SIGTERM به `$LABWC_PID`
.PP
.RE
\fB\-h, \-\-help\fR
.RS 4
نمایش پیام راهنما و خروج
.PP
.RE
\fB\-m, \-\-merge\-config\fR
.RS 4
ادغام فایل‌های پیکربندی/تم کاربر در تمامی دایرکتوری‌های پایه XDG
.PP
.RE
\fB\-r, \-\-reconfigure\fR
.RS 4
بارگذاری مجدد پیکربندی کامپوزیتور با ارسال SIGHUP به `$LABWC_PID`
.PP
.RE
\fB\-s, \-\-startup\fR <command>
.RS 4
اجرای دستور هنگام راه‌اندازی
.PP
.RE
\fB\-S, \-\-session\fR <command>
.RS 4
اجرای دستور هنگام راه‌اندازی و خاتمه دادن به کامپوزیتور در زمان خروج.\& این گزینه برای مدیریت نشست مفید است زیرا به کلاینت نشست اجازه می‌دهد با خروج خود به labwc پایان دهد.\& این یک مورد کاربرد خاص در Wayland است، زیرا تحت X، برنامه xinit کارساز (server) را اجرا کرده و تا زمان اجرای کلاینت نشست آن را زنده نگه می‌دارد.\& بنابراین یا کلاینت نشست مدیر پنجره (Window Manager) را اجرا می‌کند، یا مدیر پنجره می‌تواند ابتدا به‌طور مستقل اجرا شود.\& در Wayland، کامپوزیتور هم کارساز نمایش (Display Server) و هم مدیر پنجره است، بنابراین سازوکارهای مدیریت نشست شرح‌داده‌شده عمل نمی‌کنند چون کامپوزیتور باید پیش از شروع به کار نشست اجرا شده باشد.\& از آنجا که برخی کلاینت‌های نشست هم از X11 و هم از Wayland پشتیبانی می‌کنند، این گزینه خط فرمان از بازنویسی و تکه‌تکه شدن جلوگیری می‌کند.\&
.PP
.RE
\fB\-t, \-\-title\fR <fmtstr>
.RS 4
تنظیم عنوان پنجره برای labwc زمانی که درون یک پنجره اجرا می‌شود (یعنی به صورت تو در تو یا nested در یک کامپوزیتور دیگر).\& <fmtstr> یک رشته قالب‌بندی برای استفاده به عنوان عنوان پنجره است که در آن `%o` با نام ناحیه خروجی جایگزین می‌شود.\& این قابلیت هنگام شبیه‌سازی چند نمایشگر، مانند اجرای labwc با متغیر محیطی `WLR_WL_OUTPUTS=2` مفید است.\& در این حالت، مقدار `%o` برای هر صفحه شبیه‌سازی‌شده منحصربه‌فرد خواهد بود.\&
.PP
.RE
\fB\-v, \-\-version\fR
.RS 4
نمایش شماره نسخه و خروج
.PP
.RE
\fB\-V, \-\-verbose\fR
.RS 4
فعال‌سازی ثبت گزارش با جزئیات بیشتر (verbose)
.PP
.RE
.SH "مدیریت نشست (SESSION MANAGEMENT)"
.PP
برای فعال‌سازی امکان استفاده از کلاینت‌های گرافیکی که از طریق فعال‌سازی سرویس systemd یا D\-Bus راه‌اندازی می‌شوند، labwc می‌تواند هر دو محیط فعال‌سازی را در هنگام راه‌اندازی به‌روزرسانی کند.\& مشروط بر اینکه labwc از یک نشست کاربری فعال D\-Bus آگاه باشد (\fBیعنی\fR متغیر محیطی `DBUS_SESSION_BUS_ADDRESS` تعریف شده باشد)، کامپوزیتور دستورهای
.PP
.nf
.RS 4
dbus\-update\-activation\-environment
systemctl \-\-user import\-environment
.fi
.RE
.PP
را (در صورت در دسترس بودن) برای آگاه‌سازی D\-Bus و systemd با مقادیر متغیرهای محیطی زیر فراخوانی می‌کند:
.PP
.nf
.RS 4
WAYLAND_DISPLAY
DISPLAY
XDG_CURRENT_DESKTOP
XDG_SESSION_TYPE
XCURSOR_SIZE
XCURSOR_THEME
LABWC_PID
.fi
.RE
.PP
این رفتار هر زمان که labwc از بک‌اند wlroots با عنوان "DRM" استفاده کند (که به معنی کامپوزیتور اصلی بودن labwc روی کنسول است)، به‌طور پیش‌فرض فعال است.\& هنگامی که سایر بک‌اندها به کار گرفته می‌شوند (برای مثال، زمانی که labwc به صورت تو در تو در یک کامپوزیتور Wayland دیگر یا یک سرور X11 اجرا می‌شود)، به‌روزرسانی‌های محیط فعال‌سازی به‌طور پیش‌فرض غیرفعال هستند.\& با تنظیم متغیر محیطی `LABWC_UPDATE_ACTIVATION_ENV` روی یکی از مقادیر مثبت مانند `1`، `true`، `yes` یا `on` می‌توان به‌روزرسانی محیط فعال‌سازی را اجبار کرد؛ یا با تنظیم این متغیر روی یکی از مقادیر منفی مانند `0`، `false`، `no` یا `off` از آن جلوگیری نمود.\&
.PP
هر زمان که labwc محیط فعال‌سازی را در هنگام راه‌اندازی به‌روز کند، در هنگام خروج نیز تلاش خواهد کرد تا محیط فعال‌سازی را پاکسازی کند.\& برای D\-Bus، که روشی برای لغو تنظیم صحیح متغیرها در محیط فعال‌سازی ارائه نمی‌دهد، این کار با تنظیم متغیرهای نشست روی رشته‌های خالی انجام می‌شود.\& برای systemd، دستور `systemctl \-\-user unset\-environment` برای حذف واقعی متغیرها از محیط فعال‌سازی فراخوانی خواهد شد.\&
.PP
یک واحد کاربری systemd با نام `labwc\-session.\&target` نیز همراه با کامپوزیتور برای کاربرانی که می‌خواهند labwc را با systemd یکپارچه کنند عرضه شده است.\& این واحد به `graphical\-session.\&target` استاندارد متصل (bind) می‌شود، بنابراین سرویس‌های کاربری systemd که وابستگی WantedBy یا PartOf را به آن هدف اعلام کرده‌اند، می‌توانند همگام با نشست labwc شروع به کار کرده و متوقف شوند.\& خود labwc این هدف را فعال نمی‌کند؛ کاربران می‌توانند با افزودن خطوطی مانند زیر به فایل‌های \fBautostart\fR و \fBshutdown\fR خود، این سازوکار را فعال کنند:
.PP
.nf
.RS 4
systemctl \-\-user \-\-no\-block start labwc\-session\&.target
systemctl \-\-user stop graphical\-session\&.target
.fi
.RE
.PP
فایل‌های نمونه \fBautostart\fR و \fBshutdown\fR عرضه شده به همراه labwc شامل این خطوط به صورت کامنت‌شده هستند.\& برای اینکه یک سرویس کاربری به‌طور خودکار همگام با نشست شروع شود، آن را فعال (enable) کنید تا پیوند نمادین (symlink) متناظر با آن در دایرکتوری graphical\-session.\&target.\&wants وجود داشته باشد؛ به عنوان مثال با اجرای "systemctl \-\-user enable dms.\&service".\&
.PP
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
متغیرهای محیطی ذکرشده در زیر را برای فعال‌سازی گزینه‌های اشکال‌زدایی خاص تنظیم کنید.\& این کار می‌تواند در فایل \fBenvironment\fR یا در خط فرمان انجام شود، به عنوان مثال: \fBLABWC_DEBUG_FOO=1 labwc\fR.\&
.PP
\fBLABWC_DEBUG_LIBSFDO\fR
.RS 4
فعال‌سازی ثبت گزارش‌های اشکال‌زدایی (debug) و اطلاعاتی (info) برای libsfdo، به عنوان مثال برای تجزیه فایل‌های دسکتاپ و جستجوی آیکون‌ها.\& توجه داشته باشید که ثبت خطاهای libsfdo صرف‌نظر از این متغیر محیطی همیشه فعال است، اما تنها با گزینه \fB\-V|\-\-version\fR نشان داده خواهد شد.\&
.PP
.RE
\fBLABWC_DEBUG_DIR_CONFIG_AND_THEME\fR
.RS 4
افزایش سطح ثبت گزارش مسیرها برای فایل‌های پیکربندی (مانند rc.\&xml، autostart، environment و menu.\&xml) و همچنین دکمه‌های نوار عنوان.\&
.PP
.RE
\fBLABWC_DEBUG_CONFIG_NODENAMES\fR
.RS 4
فعال‌سازی ثبت گزارش تمامی نام‌های گره‌ها (به عنوان مثال \fBpolicy.\&placement: Cascade\fR برای \fB<placement><policy>Cascade</policy></placement>\fR) برای فایل‌های پیکربندی و منو به‌ترتیب.\&
.PP
.RE
\fBLABWC_DEBUG_KEY_STATE\fR
.RS 4
فعال‌سازی ثبت رویدادهای فشردن و رها کردن برای کلیدهای مقید شده (عموماً کلیدهای ترکیبی مانند \fBCtrl\-Alt\-t\fR).\&
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
labwc\-actions(5), labwc\-config(5), labwc\-menu(5), labwc\-theme(5)