'\" t
.\"
.\" Copyright 1984 - 1991, 1993, 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\" shorthand for double quote that works everywhere.
.ds q \N'34'
.TH XWAYLAND 1 "xorg-server 24.1.13" "X Version 11"
.SH "نام (NAME)"
Xwayland \- یک کارساز X برای اجرای کلاینت‌های X در Wayland
.SH "خلاصه دستور (SYNOPSIS)"
.B Xwayland
[گزینه ...]
.SH "توضیحات (DESCRIPTION)"
برنامه
.I Xwayland
یک کارساز X و یک کلاینت Wayland است. این برنامه نقش یک پیشکار (پروکسی) را میان کلاینت‌های قدیمی X که از پروتکل‌های Wayland پشتیبانی نمی‌کنند و کارساز Wayland ایفا می‌کند.
.PP
معمولاً \fIXwayland\fP به‌طور خودکار توسط کارساز Wayland اجرا می‌شود و به‌صورت بدون ریشه (rootless) اجرا می‌گردد تا کلاینت‌های X به‌طور یکپارچه با سایر بخش‌های میزکار Wayland ادغام شوند. با این وجود، امکان اجرای دستی Xwayland در حالت دارای پنجره ریشه (non-rootless/rootful) توسط کاربر، عمدتاً با اهداف آزمایشی، وجود دارد.
.PP
مانند تمام کارسازهای X، دستور \fIXwayland\fP گزینه‌های خط فرمان توصیف‌شده در صفحه راهنمای \fIXserver\fP(7) را می‌پذیرد.
آرگومان‌های اضافی زیر نیز پشتیبانی می‌شوند.
.TP 8
.B \-decorate
افزودن تزئینات پنجره به پنجره ریشه (root window) در Xwayland هنگام اجرا در حالت rootful.

این گزینه زمانی که \fIXwayland\fP بدون پشتیبانی از libdecor (اختیاری) کامپایل شده باشد، هیچ اثری ندارد.

این گزینه با حالت بدون ریشه (\fI-rootless\fP) سازگار نیست.
.TP 8
.B \-enable-ei-portal
فعال‌سازی پشتیبانی از پورتال XDG برای شبیه‌سازی ورودی (input emulation).

یک کامپوزیتور Wayland که به‌صورت تو در تو (nested) اجرا می‌شود نباید از این گزینه خط فرمان با Xwayland استفاده کند.

اگر کامپوزیتور از پورتال XDG مربوطه پشتیبانی نکند یا اگر Xwayland با پشتیبانی از EI و OEFFIS کامپایل نشده باشد، این گزینه هیچ اثری ندارد.
.TP 8
.B \-fullscreen
تمام‌صفحه کردن پنجره Xwayland هنگام اجرا در حالت rootful.

این گزینه با حالت بدون ریشه (\fI-rootless\fP) سازگار نیست.
.TP 8
.B \-geometry \fIWxH\fP
تنظیم ابعاد و موقعیت (geometry) پنجره \fIXwayland\fP به \fIWxH\fP هنگام اجرا در حالت rootful.

این گزینه با حالت بدون ریشه (\fI-rootless\fP) سازگار نیست.
.TP 8
.B \-glamor " [\fIgl|es|off\fP]"
استفاده از رابط برنامه‌نویسی رندرینگ داده‌شده برای شتاب‌دهی Glamor. گزینه‌های ممکن شامل \fIgl\fP و \fIes\fP هستند.
اگر \fIXwayland\fP با پشتیبانی از Glamor کامپایل شده باشد، این گزینه به \fIXwayland\fP دستور می‌دهد تا فقط از رابط کاربری درخواستی برای Glamor استفاده کند. اگر این مقدار روی \fIoff\fP تنظیم شود، اثر آن با گزینه \fI-shm\fP برابر خواهد بود.
بدون این گزینه و بدون گزینه \fI-shm\fP، برنامه \fIXwayland\fP ابتدا رابط برنامه‌نویسی رندرینگ OpenGL را امتحان می‌کند و در صورتی که نگارش GL کمتر از ۲.۱ باشد، به GL ES رجوع می‌کند.

این گزینه با گزینه \fI-shm\fP سازگار نیست.
.TP 8
.B \-hidpi
تنظیم و تطبیق با مقیاس خروجی‌ها هنگام اجرا در حالت پنجره‌ای rootful.

این گزینه با حالت بدون ریشه (\fI-rootless\fP) سازگار نیست.
.TP 8
.B \-host-grab
غیرفعال کردن میان‌برهای صفحه‌کلید میزبان و محصور کردن اشاره‌گر هنگام اجرا در حالت rootful.

این قابلیت متکی بر پروتکل بازداری میان‌برهای صفحه‌کلید کامپوزیتور و پروتکل قفل و محصور کردن اشاره‌گر است و در صورتی که کامپوزیتور Wayland مورداستفاده از این پروتکل‌ها پشتیبانی نکند، ممکن است هیچ اثری نداشته باشد.

از کلیدهای [CTRL]+[SHIFT] به‌طور هم‌زمان برای آزادسازی دستگاه‌های صفحه‌کلید و اشاره‌گر استفاده کنید.

این گزینه با حالت بدون ریشه (\fI-rootless\fP) سازگار نیست.
.TP 8
.B \-initfd \fIfd\fP
افزودن \fIfd\fP ارائه‌شده به‌عنوان یک سوکت شنود برای مقداردهی اولیه کلاینت‌های X.
این گزینه برای کارسازهای \fIWayland\fP در نظر گرفته شده است که \fIXwayland\fP را بنا به نیاز (on-demand) اجرا می‌کنند، تا بتوانند کلاینت‌های خاص X را که باید پیش از اتصال سایر کلاینت‌های معمولی X به \fIXwayland\fP تکمیل شوند (مانند \fIxrdb\fP) اجرا کنند.
.TP 8
.B \-listen \fIfd\fP
منسوخ شده است، به‌جای آن از \fI\-listenfd\fP استفاده کنید.
.TP 8
.B \-listenfd \fIfd\\fP
افزودن fd داده‌شده به‌عنوان یک سوکت شنود. این گزینه توسط کارساز \fIWayland\fP استفاده می‌شود تا سوکتی را که کلاینت‌های X به آن متصل می‌شوند به \fIXwayland\fP ارسال کند.
.TP 8
.B \-noTouchPointerEmulation
غیرفعال کردن شبیه‌سازی اشاره‌گر لمسی. این قابلیت به کامپوزیتور Wayland اجازه می‌دهد سازوکار شبیه‌سازی اشاره‌گر اختصاصی خود را برای کلاینت‌های X11 که از ورودی لمسی پشتیبانی نمی‌کنند، پیاده‌سازی کند.
.TP 8
.B \-force-xrandr-emulation
اجبار به ارائه حالت‌های غیربومی بیشتر در شرایطی که viewporter توسط کامپوزیتور Wayland پشتیبانی نمی‌شود.
.TP 8
.B \-nokeymap
به \fIXwayland\fP دستور می‌دهد نگاشت کلید (keymap) تعیین‌شده توسط کامپوزیتور Wayland را نادیده بگیرد.

به‌طور پیش‌فرض، \fIXwayland\fP (مانند هر کلاینت Wayland دیگری) از نگاشت کلید تعیین‌شده توسط کامپوزیتور Wayland با استفاده از پروتکل استاندارد Wayland استفاده می‌کند.

این گزینه برای موارد کاربردی خاصی در نظر گرفته شده است که در آن‌ها ممکن است واگذاری کنترل نگاشت کلید مورداستفاده در Xwayland به کلاینت‌های X11 و نادیده گرفتن نگاشت کلید مشخص‌شده توسط کامپوزیتور Wayland مطلوب باشد.
.B \-output \fIname\fP
مشخص می‌کند که پنجره تمام‌صفحه rootful برنامه \fIXwayland\fP باید روی کدام خروجی قرار گیرد.
نام باید با نام یکی از خروجی‌های موجود در Wayland مطابقت داشته باشد (نام‌های خروجی را می‌توان با استفاده از wayland-info پیدا کرد).

اگر هیچ خروجی منطبقی یافت نشود، کامپوزیتور Wayland تصمیم خواهد گرفت که پنجره تمام‌صفحه rootful برنامه \fIXwayland\fP روی کدام خروجی قرار گیرد.

این گزینه در صورتی که \fIXwayland\fP به‌صورت تمام‌صفحه rootful اجرا نشود، هیچ اثری ندارد.
.TP 8
.B \-rootless
اجرای \fIXwayland\fP در حالت بدون ریشه (rootless)، تا کلاینت‌های X به‌طور یکپارچه با کلاینت‌های Wayland در میزکار Wayland ادغام شوند. این حالت مستلزم آن است که کارساز Wayland یک مدیر پنجره X نیز باشد.
.TP 8
.BI \-shm
اجبار به استفاده از بستر حافظه اشتراکی (shared memory) به‌جای glamor (در صورت در دسترس بودن) برای ارسال بافرها به کارساز Wayland.

این گزینه با گزینه \fI-glamor\fP سازگار نیست.
.TP 8
.BR \-verbose " [\fIn\fP]"
سطح پرگویی (verbosity) را برای اطلاعات چاپ‌شده روی stderr تنظیم می‌کند. اگر مقدار
.I n
داده نشود، هر بار تکرار این گزینه یک واحد به سطح پرگویی می‌افزاید. هنگامی که مقدار
.I n
داده شود، سطح پرگویی روی آن مقدار تنظیم می‌گردد. سطح پرگویی پیش‌فرض 0 است.
.TP 8
.BI \-version
نمایش نگارش کارساز و خروج.
.TP 8
.B \-wm \fIfd\fP
این گزینه توسط کارساز \fIWayland\fP استفاده می‌شود تا سوکتی را که کلاینت مدیر پنجره X به آن متصل می‌شود به \fIXwayland\fP ارسال کند، زمانی که \fIXwayland\fP با \fI-rootless\fP اجرا شده است.
.SH "محیط (ENVIRONMENT)"
.TP 8
.B WAYLAND_DISPLAY
نام نمایشگر (display) کارساز Wayland.
.TP 8
.B XWAYLAND_NO_GLAMOR
غیرفعال‌سازی پشتیبانی از glamor و DRI3 در \fIXwayland\fP، برای اهداف آزمایشی.
.SH "همچنین ببینید (SEE ALSO)"
اطلاعات عمومی: \fIX\fP(7), \fIwayland-info\fP(7)