.\"
.\" Copyright (c) Matthieu Herrb <matthieu@herrb.eu>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.TH Xephyr 1 "xorg-server 21.1.24" "X Version 11"
.SH "نام (NAME)"
Xephyr \- کارساز X با خروجی درون پنجره‌ای روی یک نمایشگر X از‌پیش‌موجود
.SH "خلاصه دستور (SYNOPSIS)"
.B Xephyr
.RI [\fB:\fP display ]
.RI [ option
.IR ... ]
.SH "توضیحات (DESCRIPTION)"
دستور
.B Xephyr
یک کارساز kdrive است که خروجی خود را در پنجره‌ای روی یک نمایشگر X «میزبان» از‌پیش‌موجود نمایش می‌دهد.
می‌توان آن را مانند
.I Xnest
در نظر گرفت، اما با پشتیبانی از افزونه‌های مدرن نظیر composite ،damage و randr.
.PP
برخلاف
.I Xnest
که یک پراکسی X است (یعنی محدود به توانایی‌های کارساز X میزبان است)،
.B Xephyr
یک کارساز X واقعی است که از پنجرهٔ کارساز X میزبان به‌عنوان «framebuffer» از طریق ساختارهای پرسرعت SHM XImages بهره می‌برد.
.PP
این برنامه همچنین از اشکال‌زدایی «بصریِ» فرآیند ترسیم کارساز پشتیبانی می‌کند.
.SH "گزینه‌ها (OPTIONS)"
این کارساز تمام گزینه‌های استاندارد
.BR Xserver (1)
و گزینه‌های اضافی زیر را می‌پذیرد:
.TP 8
.BI -screen " width" x height
اندازهٔ صفحه را تعیین می‌کند.
.TP 8
.BI -parent " id"
از پنجرهٔ موجود با شناسهٔ
.I id
استفاده می‌کند. اگر آرگومان
.BI -screen
پس از یک آرگومان
.BI -parent
بیاید، این صفحه درون پنجرهٔ مشخص‌شده تعبیه می‌شود.
.TP 8
.B -host-cursor
فعال‌سازی «شتاب‌بخشی نشانگر»:
مکان‌نمای میزبان مجدداً استفاده می‌شود. این گزینه در حقیقت تنها برای کمک به اشکال‌زدایی از طریق جلوگیری از ترسیم مکان‌نما توسط کارساز تعبیه شده است. بهبود کارایی آن ناچیز است.
.TP 8
.B -resizeable
امکان تغییر اندازهٔ پنجرهٔ Xephyr را فراهم می‌کند، حتی اگر درون یک پنجرهٔ والد تعبیه نشده باشد. به‌طور پیش‌فرض، اندازهٔ پنجرهٔ Xephyr ثابت است.
.TP 8
.B -no-host-grab
تصاحب (grab) صفحه‌کلید و موشواره را غیرفعال می‌کند.
.SH "سیگنال‌ها (SIGNALS)"
ارسال یک سیگنال SIGUSR1 به کارساز (به‌عنوان مثال با دستور pkill \-USR1 Xephyr) حالت اشکال‌زدایی را فعال/غیرفعال می‌کند.
در این حالت، پیش از ترسیم محتوای اصلی، مستطیل‌های قرمزرنگی روی نواحی‌ای از صفحه که در حال ترسیم هستند کشیده می‌شود.
میزان تأخیر بین این مراحل را می‌توان با تنظیم متغیر محیطی XEPHYR_PAUSE روی مقداری بر حسب میکروثانیه مشخص کرد.
.SH "هشدارها (CAVEATS)"
.PP
.IP \(bu 2
نمایشگرهای چرخانده‌شده (rotated) در حال حاضر از طریق انتقال کامل تصویر (full blits) به‌روزرسانی می‌شوند. این کار کندتر از یک نمایشگر با جهت‌گیری عادی است؛ بنابراین حالت اشکال‌زدایی در نمایشگر چرخیده کاربرد چندانی ندارد.
.IP \(bu 2
نشانگر در حالت \(aq-host-cursor\(aq از نظر ظاهری ایستا است.
.IP \(bu 2
فرآیند ساخت با هشداری دربارهٔ \(aqnanosleep\(aq مواجه می‌شود. به نظر می‌رسد پرچم‌های ساخت مختلف \(aq-D\(aq مسبب آن هستند. هنوز راهکاری برای دور زدن آن پیدا نشده است، هرچند به نظر نمی‌رسد مشکلی در کارایی ایجاد کند.
.IP \(bu 2
مدیریت صفحه‌کلید ابتدایی است اما کار می‌کند.
.IP \(bu 2
دکمهٔ شمارهٔ ۵ موشواره احتمالاً کار نخواهد کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7)،
.BR Xserver (1)
.SH "نویسندگان (AUTHORS)"
Matthew Allum <mallum@o-hand.com> 2004