.\" $XdotOrg: xc/programs/Xserver/hw/vfb/Xvfb.man,v 1.3 2005/03/23 20:49:52 gisburn Exp $
.\" $Xorg: Xvfb.man,v 1.4 2001/02/09 02:04:45 xorgcvs Exp $
.\" Copyright 1993, 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.
.\"
.\" $XFree86: xc/programs/Xserver/hw/vfb/Xvfb.man,v 1.9 2001/12/14 19:59:45 dawes Exp $
.\"
.TH XVFB 1 "xorg-server 21.1.24" "X Version 11"
.SH "نام (NAME)"
Xvfb \- کارگزار X با فریم‌بافر مجازی برای X Version 11
.SH "خلاصه دستور (SYNOPSIS)"
.B Xvfb
[ گزینه ] ...
.SH "توضیحات (DESCRIPTION)"
.I Xvfb
یک کارگزار X است که می‌تواند بر روی سیستم‌های فاقد سخت‌افزار نمایشگر و بدون دستگاه‌های ورودی فیزیکی اجرا شود. این برنامه با استفاده از حافظهٔ مجازی، یک فریم‌بافر ساده را شبیه‌سازی می‌کند.
.PP
هدف و کاربرد اولیهٔ این کارگزار، آزمایش خود کارگزار بوده است. کدهای fb برای هر عمق رنگی می‌توانند بدون نیاز به سخت‌افزار واقعیِ پشتیبانی‌کننده از آن عمق، توسط این کارگزار ارزیابی و اجرا شوند. جامعهٔ کاربری X کاربردهای نوآورانهٔ بسیار دیگری برای \fIXvfb\fP یافته است، از جمله آزمایش برنامه‌های کلاینت در برابر عمق‌های رنگی و پیکربندی‌های نامتعارف صفحه، انجام پردازش دسته‌ای با استفاده از \fIXvfb\fP به عنوان موتور رندرینگ پس‌زمینه، آزمون بار، کمک به پورت کردن کارگزار X به یک بستر جدید، و فراهم کردن راهکاری نامحسوس برای اجرای برنامه‌هایی که واقعاً نیازی به کارگزار X ندارند اما در هر حال بر وجود آن اصرار می‌ورزند.
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های معمول کارگزار که در صفحهٔ راهنمای \fIXserver(1)\fP تشریح شده‌اند، \fIXvfb\fP سوئیچ‌های خط فرمان زیر را نیز می‌پذیرد:
.TP 4
.B "\-screen \fIscreennum\fP \fIWxHxD\fP"
این گزینه صفحهٔ \fIscreennum\fP را ایجاد کرده و عرض، ارتفاع و عمق رنگ آن را به ترتیب روی W و H و D تنظیم می‌کند. به طور پیش‌فرض، فقط صفحهٔ 0 وجود دارد و دارای ابعاد 1280x1024x24 است.
.TP 4
.B "\-pixdepths \fIlist-of-depths\fP"
این گزینه فهرستی از عمق‌های pixmap را مشخص می‌کند که کارگزار باید علاوه بر عمق‌های مرتبط با صفحه‌های پشتیبانی‌شده، از آن‌ها نیز پشتیبانی کند. آرگومان \fIlist-of-depths\fP فهرستی از اعداد صحیح است که با فاصله از هم جدا شده‌اند و می‌توانند مقادیری بین 1 تا 32 داشته باشند.
.TP 4
.B "\-fbdir \fIframebuffer-directory\fP"
این گزینه دایرکتوری‌ای را مشخص می‌کند که فایل‌های نگاشت‌شده در حافظه (memory-mapped) حاوی حافظهٔ فریم‌بافر باید در آن ایجاد شوند. بخش «فایل‌ها» را ببینید. این گزینه فقط در سیستم‌هایی وجود دارد که از فراخوان‌های سیستمی mmap و msync پشتیبانی می‌کنند.
.TP 4
.B "\-shmem"
این گزینه مشخص می‌کند که فریم‌بافر باید در حافظهٔ اشتراکی (shared memory) قرار گیرد. شناسهٔ حافظهٔ اشتراکی (ID) برای هر صفحه توسط کارگزار چاپ خواهد شد. قالب حافظهٔ اشتراکی xwd است. این گزینه تنها در سیستم‌هایی فعال است که از رابط حافظهٔ اشتراکی System V پشتیبانی کنند.
.PP
اگر هیچ‌یک از گزینه‌های \fB\-shmem\fP یا \fB\-fbdir\fP مشخص نشده باشند، حافظهٔ فریم‌بافر با استفاده از ()malloc تخصیص خواهد یافت.
.TP 4
.B "\-linebias \fIn\fP"
این گزینه نحوهٔ تنظیم پیکسل‌بندی خطوط باریک را تعیین می‌کند. مقدار \fIn\fP یک ماسک بیتی از هشتک‌ها (octants) است که در آن‌ها، هنگامی که عبارت خطای برزنهام (Bresenham) دقیقاً صفر است، یک گام محوری ترجیح داده می‌شود. برای اطلاعات بیشتر فایل Xserver/mi/miline.h را ببینید. این گزینه احتمالاً تنها برای توسعه‌دهندگان کارگزار مفید است تا محدودهٔ پیکسل‌بندی خطوط ممکن با کدهای fb را بیازمایند.
.TP 4
.B "\-blackpixel \fIpixel-value\fP, \-whitepixel \fIpixel-value\fP"
این گزینه‌ها مقادیر پیکسلی رنگ‌های سیاه و سفید را که کارگزار باید استفاده کند مشخص می‌کنند.
.SH "فایل‌ها (FILES)"
در صورت تعیین گزینهٔ \-fbdir، فایل‌های زیر ایجاد می‌شوند:
.TP 4
\fIframebuffer-directory\fP/Xvfb_screen<n>
فایل نگاشت‌شده در حافظه شامل حافظهٔ فریم‌بافر صفحهٔ n (یک فایل به ازای هر صفحه). این فایل در قالب xwd است. بنابراین، گرفتن یک نماگرفت کامل از صفحه می‌تواند تنها با یک دستور رونوشت فایل انجام شود، و نماگرفت حاصل حتی شامل تصویر مکان‌نما نیز خواهد بود.
.SH "مثال‌ها (EXAMPLES)"
.TP 8
Xvfb :1 -screen 0 1600x1200x24
کارگزار به عنوان کارگزار شمارهٔ 1 به اتصالات گوش می‌دهد، و صفحهٔ 0 با ابعاد 1600x1200 و عمق رنگ 24 خواهد بود.
.TP 8
Xvfb :1 -screen 1 1600x1200x16
کارگزار به عنوان کارگزار شمارهٔ 1 به اتصالات گوش می‌دهد، صفحهٔ 0 پیکربندی پیش‌فرض (1280x1024x24) را خواهد داشت، و صفحهٔ 1 با ابعاد 1600x1200 و عمق رنگ 16 تنظیم می‌شود.
.TP 8
Xvfb -pixdepths 3 27 -fbdir /var/tmp
کارگزار به عنوان کارگزار شمارهٔ 0 به اتصالات گوش می‌دهد، پیکربندی پیش‌فرض صفحه (یک صفحه با ابعاد 1280x1024x24) را اعمال می‌کند، از عمق‌های pixmap با مقادیر 3 و 27 پشتیبانی خواهد کرد، و از فایل‌های نگاشت‌شده در حافظه در /var/tmp برای فریم‌بافر بهره می‌گیرد.
.TP 8
xwud -in /var/tmp/Xvfb_screen0
صفحهٔ 0 کارگزاری را که در مثال پیشین آغاز شده است، نمایش می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.PP
X(7), Xserver(1), xwd(1), xwud(1), XWDFile.h
.SH "نویسندگان (AUTHORS)"
David P. Wiggins, The Open Group, Inc.