نام (NAME)

Xwayland - یک کارساز X برای اجرای کلاینت‌های X در Wayland

خلاصه دستور (SYNOPSIS)

Xwayland [گزینه ...]

توضیحات (DESCRIPTION)

برنامه Xwayland یک کارساز X و یک کلاینت Wayland است. این برنامه نقش یک پیشکار (پروکسی) را میان کلاینت‌های قدیمی X که از پروتکل‌های Wayland پشتیبانی نمی‌کنند و کارساز Wayland ایفا می‌کند.

معمولاً Xwayland به‌طور خودکار توسط کارساز Wayland اجرا می‌شود و به‌صورت بدون ریشه (rootless) اجرا می‌گردد تا کلاینت‌های X به‌طور یکپارچه با سایر بخش‌های میزکار Wayland ادغام شوند. با این وجود، امکان اجرای دستی Xwayland در حالت دارای پنجره ریشه (non-rootless/rootful) توسط کاربر، عمدتاً با اهداف آزمایشی، وجود دارد.

مانند تمام کارسازهای X، دستور Xwayland گزینه‌های خط فرمان توصیف‌شده در صفحه راهنمای Xserver(7) را می‌پذیرد. آرگومان‌های اضافی زیر نیز پشتیبانی می‌شوند.

-decorate

افزودن تزئینات پنجره به پنجره ریشه (root window) در Xwayland هنگام اجرا در حالت rootful.

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

این گزینه با حالت بدون ریشه (-rootless) سازگار نیست.

-enable-ei-portal

فعال‌سازی پشتیبانی از پورتال XDG برای شبیه‌سازی ورودی (input emulation).

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

اگر کامپوزیتور از پورتال XDG مربوطه پشتیبانی نکند یا اگر Xwayland با پشتیبانی از EI و OEFFIS کامپایل نشده باشد، این گزینه هیچ اثری ندارد.

-fullscreen

تمام‌صفحه کردن پنجره Xwayland هنگام اجرا در حالت rootful.

این گزینه با حالت بدون ریشه (-rootless) سازگار نیست.

-geometry WxH

تنظیم ابعاد و موقعیت (geometry) پنجره Xwayland به WxH هنگام اجرا در حالت rootful.

این گزینه با حالت بدون ریشه (-rootless) سازگار نیست.

-glamor [gl|es|off]

استفاده از رابط برنامه‌نویسی رندرینگ داده‌شده برای شتاب‌دهی Glamor. گزینه‌های ممکن شامل gl و es هستند. اگر Xwayland با پشتیبانی از Glamor کامپایل شده باشد، این گزینه به Xwayland دستور می‌دهد تا فقط از رابط کاربری درخواستی برای Glamor استفاده کند. اگر این مقدار روی off تنظیم شود، اثر آن با گزینه -shm برابر خواهد بود. بدون این گزینه و بدون گزینه -shm، برنامه Xwayland ابتدا رابط برنامه‌نویسی رندرینگ OpenGL را امتحان می‌کند و در صورتی که نگارش GL کمتر از ۲.۱ باشد، به GL ES رجوع می‌کند.

این گزینه با گزینه -shm سازگار نیست.

-hidpi

تنظیم و تطبیق با مقیاس خروجی‌ها هنگام اجرا در حالت پنجره‌ای rootful.

این گزینه با حالت بدون ریشه (-rootless) سازگار نیست.

-host-grab

غیرفعال کردن میان‌برهای صفحه‌کلید میزبان و محصور کردن اشاره‌گر هنگام اجرا در حالت rootful.

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

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

این گزینه با حالت بدون ریشه (-rootless) سازگار نیست.

-initfd fd

افزودن fd ارائه‌شده به‌عنوان یک سوکت شنود برای مقداردهی اولیه کلاینت‌های X. این گزینه برای کارسازهای Wayland در نظر گرفته شده است که Xwayland را بنا به نیاز (on-demand) اجرا می‌کنند، تا بتوانند کلاینت‌های خاص X را که باید پیش از اتصال سایر کلاینت‌های معمولی X به Xwayland تکمیل شوند (مانند xrdb) اجرا کنند.

-listen fd

منسوخ شده است، به‌جای آن از -listenfd استفاده کنید.

-listenfd fd

افزودن fd داده‌شده به‌عنوان یک سوکت شنود. این گزینه توسط کارساز Wayland استفاده می‌شود تا سوکتی را که کلاینت‌های X به آن متصل می‌شوند به Xwayland ارسال کند.

-noTouchPointerEmulation

غیرفعال کردن شبیه‌سازی اشاره‌گر لمسی. این قابلیت به کامپوزیتور Wayland اجازه می‌دهد سازوکار شبیه‌سازی اشاره‌گر اختصاصی خود را برای کلاینت‌های X11 که از ورودی لمسی پشتیبانی نمی‌کنند، پیاده‌سازی کند.

-force-xrandr-emulation

اجبار به ارائه حالت‌های غیربومی بیشتر در شرایطی که viewporter توسط کامپوزیتور Wayland پشتیبانی نمی‌شود.

-nokeymap

به Xwayland دستور می‌دهد نگاشت کلید (keymap) تعیین‌شده توسط کامپوزیتور Wayland را نادیده بگیرد.

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

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

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

این گزینه در صورتی که Xwayland به‌صورت تمام‌صفحه rootful اجرا نشود، هیچ اثری ندارد.

-rootless

اجرای Xwayland در حالت بدون ریشه (rootless)، تا کلاینت‌های X به‌طور یکپارچه با کلاینت‌های Wayland در میزکار Wayland ادغام شوند. این حالت مستلزم آن است که کارساز Wayland یک مدیر پنجره X نیز باشد.

-shm

اجبار به استفاده از بستر حافظه اشتراکی (shared memory) به‌جای glamor (در صورت در دسترس بودن) برای ارسال بافرها به کارساز Wayland.

این گزینه با گزینه -glamor سازگار نیست.

-verbose [n]

سطح پرگویی (verbosity) را برای اطلاعات چاپ‌شده روی stderr تنظیم می‌کند. اگر مقدار n داده نشود، هر بار تکرار این گزینه یک واحد به سطح پرگویی می‌افزاید. هنگامی که مقدار n داده شود، سطح پرگویی روی آن مقدار تنظیم می‌گردد. سطح پرگویی پیش‌فرض 0 است.

-version

نمایش نگارش کارساز و خروج.

-wm fd

این گزینه توسط کارساز Wayland استفاده می‌شود تا سوکتی را که کلاینت مدیر پنجره X به آن متصل می‌شود به Xwayland ارسال کند، زمانی که Xwayland با -rootless اجرا شده است.

محیط (ENVIRONMENT)

WAYLAND_DISPLAY

نام نمایشگر (display) کارساز Wayland.

XWAYLAND_NO_GLAMOR

غیرفعال‌سازی پشتیبانی از glamor و DRI3 در Xwayland، برای اهداف آزمایشی.

همچنین ببینید (SEE ALSO)

اطلاعات عمومی: X(7), wayland-info(7)