.\" $Id: xvfb-run.1 2138 2005-01-17 23:40:27Z branden $
.\"
.\" Copyright 1998-2004 Branden Robinson <branden@debian.org>.
.\"
.\" This is free software; you may redistribute it and/or modify
.\" it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2,
.\" or (at your option) any later version.
.\"
.\" This is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License with
.\" the Debian operating system, in /usr/share/common-licenses/GPL;  if
.\" not, write to the Free Software Foundation, Inc., 59 Temple Place,
.\" Suite 330, Boston, MA 02111-1307 USA
.\"
.\" We need the URL macro from groff's www macro package, but also want
.\" things to work all right for people who don't have it.  So we define
.\" our own URL macro and let the www macro package override it if it's
.\" available.
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.TH xvfb\-run 1 "2004\-11\-12" "Debian Project"
.SH "نام (NAME)"
xvfb\-run \- اجرای کلاینت X یا دستور مشخص‌شده در محیط کارساز X مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.B xvfb\-run
[
.I options
]
.I command
.SH "توضیحات (DESCRIPTION)"
دستور
.B xvfb\-run
یک پوشش (wrapper) برای دستور
.BR Xvfb (1x)
است که وظیفهٔ اجرای دستورها (معمولاً یک کلاینت X، یا اسکریپتی حاوی فهرستی از کلاینت‌ها برای اجرا) را در یک محیط کارساز X مجازی ساده می‌کند.
.PP
دستور
.B xvfb\-run
یک فایل احراز هویت X برپا می‌کند (یا از یک فایل مشخص‌شده توسط کاربر استفاده می‌کند)، یک کوکی در آن می‌نویسد (ببینید:
.BR xauth (1x))
و سپس کارساز X
.B Xvfb
را به عنوان یک فرایند پس‌زمینه آغاز می‌کند.
شناسه فرایند (PID) مربوط به
.B Xvfb
برای استفاده‌های بعدی ذخیره می‌شود.
سپس
.I command
مشخص‌شده با استفاده از نمایشگر X متناظر با کارساز
.B Xvfb
که تازه آغاز شده و فایل احراز هویت X ایجادشده قبلی، اجرا می‌شود.
.PP
هنگامی که
.I command
پایان می‌یابد، وضعیت آن ذخیره می‌شود، کارساز
.B Xvfb
(با استفاده از شناسه فرایند ذخیره‌شده از قبل) خاتمه داده می‌شود، کوکی احراز هویت X حذف شده و فایل احراز هویت پاک می‌شود (در صورتی که کاربر فایلی را برای استفاده مشخص نکرده باشد).
سپس
.B xvfb\-run
با وضعیت خروج
.I command
خارج می‌شود.
.PP
دستور
.B xvfb\-run
برای کارکردن به دستور
.B xauth
نیاز دارد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-a\fR,\fB \-\-auto\-servernum
تلاش برای دریافت یک شماره کارساز آزاد، با شروع از 99، یا آرگومان ارائه‌شده به
.BR \-\-server\-num .
.TP
.BI \-e\  file \fR,\fB\ \-\-error\-file= file
ذخیرهٔ خروجی
.B xauth
و
.B Xvfb
در
.IR file .
مقدار پیش‌فرض
.IR /dev/null
است.
.TP
.BI \-f\  file \fR,\fB\ \-\-auth\-file= file
ذخیرهٔ داده‌های احراز هویت X در
.IR file .
به‌طور پیش‌فرض، یک دایرکتوری موقت به نام
.IR xvfb\-run. PID
(که در آن PID شناسه فرایند خودِ
.B xvfb\-run
است) در دایرکتوری مشخص‌شده توسط متغیر محیطی
.B TMPDIR
(یا
.I /tmp
در صورتی که این متغیر تهی باشد یا تنظیم نشده باشد) ایجاد می‌شود، و از دستور
.BR tempfile (1)
برای ساخت فایلی در آن دایرکتوری موقت با نام
.IR Xauthority
استفاده می‌شود.
.TP
.B \-h\fR,\fB \-\-help
نمایش پیام راهنمای استفاده و خروج.
.TP
.BI \-n\  servernumber \fR,\fB\ \-\-server\-num= servernumber
استفاده از
.I servernumber
به‌عنوان شماره کارساز (اما گزینهٔ
.B \-a\fR,\fB \-\-auto\-servernum
در بالا را ببینید).
مقدار پیش‌فرض 99 است.
.TP
.B \-l\fR,\fB \-\-listen\-tcp
فعال‌سازی شنود درگاه TCP در کارساز X.
به دلایل امنیتی (برای جلوگیری از حملات منع خدمت یا سوءاستفاده‌های امنیتی)، شنود درگاه TCP به‌طور پیش‌فرض غیرفعال است.
.TP
.BI \-p\  protocolname \fR,\fB\ \-\-xauth\-protocol= protocolname
استفاده از
.I protocolname
به‌عنوان پروتکل احراز هویت X.
مقدار پیش‌فرض \(oq.\(cq است که
.B xauth
آن را به‌عنوان پروتکل پیش‌فرض خود یعنی MIT\-MAGIC\-COOKIE\-1 تفسیر می‌کند.
.TP
.BI \-s\  arguments \fR,\fB\ \-\-server\-args= arguments
ارسال
.I arguments
به کارساز
.BR Xvfb .
دقت کنید هرگونه نویسهٔ فاصلهٔ خالی موجود در
.I arguments
را نقل‌قول (کوتیشن) کنید تا از تلقی شدن آن‌ها به‌عنوان جداکنندهٔ آرگومان‌های خودِ
.B xvfb\-run
جلوگیری شود.
همچنین توجه داشته باشید که تعیین \(oq\-nolisten tcp\(cq در
.I arguments
ممکن است عملکرد گزینهٔ
.B \-l\fR,\fB \-\-listen\-tcp
خودِ
.B xvfb\-run
را لغو کند، و مشخص کردن شماره کارساز (مانند \(oq:1\(cq) ممکن است به دلیل نحوهٔ تجزیه فهرست آرگومان‌ها توسط کارساز X نادیده گرفته شود.
برای دستیابی به عملکرد اخیر، از گزینهٔ
.BI \-n\  servernumber \fR,\fB\ \-\-server\-num= servernumber
در
.B xvfb\-run
استفاده کنید.
مقدار پیش‌فرض \(oq\-screen 0 640x480x8\(cq است.
.TP
.BI \-w\  delay \fR,\fB\ \-\-wait= delay
میزان تأخیر به مدت
.I delay
ثانیه پس از راه‌اندازی
.B Xvfb
پیش از اقدام به آغاز دستور مشخص‌شده.
مقدار پیش‌فرض 3 است.
.SH "محیط (ENVIRONMENT)"
.TP
.B COLUMNS
عرض دستگاه پایانه را بر حسب سلول‌های نویسه مشخص می‌کند.
این مقدار برای قالب‌بندی پیام‌های عیب‌یابی به کار می‌رود.
اگر تنظیم نشده باشد، پایانه با استفاده از
.BR stty (1)
پرس‌وجو می‌شود تا عرض آن تعیین شود.
اگر این کار ناموفق باشد، مقدار \(oq80\(cq فرض می‌شود.
.TP
.B TMPDIR
دایرکتوری‌ای را مشخص می‌کند که دایرکتوری موقت
.B xvfb\-run
برای ذخیرهٔ فایل احراز هویت X در آن قرار گیرد؛ تنها در صورتی استفاده می‌شود که گزینه‌های
.B \-f
یا
.B \-\-auth\-file
مشخص نشده باشند.
.SH "فایل‌های خروجی (OUTPUT FILES)"
.PP
مگر در حالتی که گزینه‌های
.B \-f
یا
.B \-\-auth\-file
مشخص شده باشند، یک دایرکتوری موقت و فایلی در داخل آن ایجاد (و حذف) می‌شوند تا کوکی‌های احراز هویت X مورد استفاده توسط کارساز
.B Xvfb
و کلاینت(های) اجراشده زیر آن را ذخیره کند.
ببینید:
.BR tempfile (1).
اگر \-f یا \-\-auth\-file استفاده شوند، فایل احراز هویت X مشخص‌شده تنها بازنویسی می‌شود و ایجاد یا حذف نخواهد شد (اگرچه
.B xauth
در صورتی که به آن دستور داده شود از فایلی استفاده کند که از قبل وجود ندارد، خودش آن فایل احراز هویت را ایجاد می‌کند).
.PP
اگر گزینه‌های
.B \-e
یا
.B \-\-error\-file
مشخص شده باشند، یک فایل خطا با نام تعیین‌شده توسط کاربر نیز ایجاد می‌شود؛ بالا را ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
دستور
.B xvfb\-run
از وضعیت خروج خود و همچنین خروجی به خطای استاندارد برای گزارش موارد عیب‌یابی استفاده می‌کند.
وضعیت خروج \(oq1\(cq مورد استفاده قرار نمی‌گیرد و باید به عنوان شکست در اجرای دستور مشخص‌شده تفسیر شود.
.TP
0
دستور
.B xvfb\-run
تنها در صورتی از این وضعیت خروج استفاده می‌کند که گزینهٔ
.B \-h\fR,\fB \-\-help
داده شده باشد.
در تمام موقعیت‌های دیگر، این کد می‌تواند به عنوان موفقیت دستور مشخص‌شده تفسیر شود.
.TP
2
هیچ دستوری برای اجرا مشخص نشده است.
.TP
3
دستور
.B xauth
در دسترس نیست.
.TP
4
دایرکتوری موقتی که قرار بود استفاده شود از قبل وجود دارد؛ از آنجا که
.B xvfb\-run
دایرکتوری‌ای با نام یکتا تولید می‌کند، این وضعیت ممکن است نشان‌دهندهٔ تلاش فرایند دیگری روی سامانه برای سوءاستفاده از شرایط رقابتی فایل‌های موقت باشد.
.TP
5
هنگام پاک‌سازی دایرکتوری موقت مشکلی رخ داد.
.TP
6
هنگام استفاده از
.BR getopt (1)
برای تجزیه آرگومان‌های خط فرمان مشکلی رخ داد.
.SH "مثال‌ها (EXAMPLES)"
.TP
.B xvfb\-run \-\-auto\-servernum \-\-server\-num=1 xlogo
کلاینت نمایشی
.BR xlogo (1x)
را درون کارساز X
.B Xvfb
روی نخستین شماره کارساز آزاد بزرگ‌تر یا مساوی 1 اجرا می‌کند.
.TP
.B xvfb\-run \-\-server\-args="\-screen 0 1024x768x24" ico \-faces
کلاینت نمایشی
.BR ico (1x)
را (و ارسال آرگومان
.B \-faces
به آن) درون کارساز X
.B Xvfb
اجرا می‌کند، که با یک پنجره ریشه با ابعاد 1024 در 768 پیکسل و عمق رنگ 24 بیتی پیکربندی شده است.
.PP
توجه داشته باشید کلاینت‌های نمایشی X استفاده‌شده در مثال‌های بالا به خودی خود خارج نخواهند شد، بنابراین پیش از خروج
.B xvfb\-run
باید خاتمه داده شوند.
.SH "گزارش باگ‌ها (BUGS)"
ببینید:
.URL "http://bugs.debian.org/xvfb" "سامانه پیگیری باگ دبیان" .
اگر می‌خواهید اشکالی را در
.B xvfb\-run
گزارش کنید، لطفاً از دستور
.BR reportbug (1)
استفاده کنید.
.SH "نویسندگان (AUTHORS)"
برنامهٔ
.B xvfb\-run
توسط Branden Robinson و Jeff Licquia با حمایت مالی Progeny Linux Systems نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR Xvfb (1x),
.BR xauth (1x)
.\" vim:set et tw=80: