.TH VBETOOL "1" "31 December 2004" "vbetool 0.2" "User Commands"
.SH "نام (NAME)"
vbetool \- اجرای کد بایوس ویدیویی در حالت واقعی (real-mode) برای تغییر وضعیت سخت‌افزار

.SH "خلاصه دستور (SYNOPSIS)"
.B "vbetool [[vbestate save|restore]|[vbemode set|get]|[vgamode]|[dpms on|off|standby|suspend|reduced]|[post [romfile]]|[vgastate on|off]|[vbefp panelid|panelsize|getbrightness|setbrightness|invert]]"

.SH "توضیحات (DESCRIPTION)"
دستور
.B vbetool
از lrmi برای اجرای کد از بایوس ویدیویی (video BIOS) استفاده می‌کند. در حال حاضر، این ابزار قادر است وضعیت‌های DPMS را تغییر دهد، وضعیت کارت گرافیک را ذخیره یا بازیابی کند، و تلاش نماید تا کارت گرافیک را از ابتدا مقداردهی اولیه کند.

.SH "گزینه‌ها (OPTIONS)"
دستور
.B vbetool
گزینه‌های زیر را می‌پذیرد:
.IP "vbestate"
دستور
.B vbetool
از افزونه‌های VESA 0x4f0f برای ذخیره یا بازیابی وضعیت سخت‌افزار استفاده خواهد کرد. این داده‌ها به ورودی استاندارد (stdin) فرستاده شده یا از آن خوانده می‌شوند. این اطلاعات بسیار وابسته به سخت‌افزار هستند \- از تلاش برای بازیابی وضعیتِ ذخیره‌شده از سامانه‌ای دیگر خودداری کنید. این دستور تنها در صورتی کار می‌کند که در یک کنسول متنی باشید، چرا که تداخل شدیدی با X ایجاد می‌کند.

.IP "dpms"
دستور
.B vbetool
از افزونه‌های VESA 0x4f10 برای تغییر وضعیت مدیریت مصرف انرژی صفحه نمایش شما استفاده خواهد کرد. گزینه‌های تکمیلیِ مجاز شامل \(lqon\(rq، \(lqoff\(rq، \(lqstandby\(rq، \(lqsuspend\(rq و \(lqreduced\(rq هستند و مشخص می‌کنند کدام وضعیت فعال شود.

.IP "vbemode"
دستور
.B vbetool
حالت فعلی VESA را دریافت یا تنظیم می‌کند. مقدار \(lqget\(rq شماره حالت جاری را در خروجی استاندارد (stdout) بازمی‌گرداند؛ و مقدار \(lqset\(rq حالت را روی آرگومان بعدی تنظیم خواهد کرد.

.IP "vgamode"
دستور
.B vbetool
حالت سنتی VGA را روی آرگومان عددیِ بعدی تنظیم می‌کند.

.IP "post"
دستور
.B vbetool
تلاش خواهد کرد کد بایوس واقع در نشانی c000:0003 را اجرا کند. این همان کدی است که در زمان راه‌اندازی (boot) توسط بایوس سیستم برای مقداردهی اولیه سخت‌افزار گرافیک اجرا می‌شود. توجه داشته باشید که در برخی رایانه‌ها (به‌ویژه لپ‌تاپ‌ها)، تمام این کد پس از بوت در حافظه باقی نمی‌ماند؛ در نتیجه اجرای این دستور ممکن است رفتاری پیش‌بینی‌نشده به همراه داشته باشد. این دستور باید از داخل یک کنسول متنی اجرا شود، در غیر این صورت در عملکرد سامانه پنجره‌ای X تداخل ایجاد می‌کند. این دستور یک آرگومان اختیاری می‌پذیرد که مسیر یک فایلِ حاوی تصویر ROM است. در صورت تعیین، این تصویر در بخش c000 نگاشت شده و به جای بایوس ویدیویی سیستم به کار می‌رود.

.IP "vgastate"
دستور
.B vbetool
کارت گرافیک فعلی را فعال یا غیرفعال می‌کند. در بیشتر سخت‌افزارها، غیرفعال‌سازی موجب می‌شود سخت‌افزار تا زمان فعال‌سازی دوباره به هیچ درخواستی پاسخ ندهد. در صورت استفاده از framebuffer، احتمالاً تمایلی به انجام این کار نخواهید داشت.

.IP "vbefp"
دستور
.B vbetool
یک فراخوانی در رابطه با واسط صفحه نمایش تخت (flat panel) بر اساس استاندارد VESA اجرا می‌کند.
.IP
مقدار panelid اطلاعاتی درباره پنل صفحه نمایش ارائه می‌دهد.
.IP
مقدار panelsize ابعاد پنل صفحه نمایش را مشخص می‌سازد.
.IP 
مقدار getbrightness روشنایی کنونی صفحه نمایش را به صورت یک عدد صحیح ارائه می‌دهد.
.IP
مقدار setbrightness یک عدد صحیح را به عنوان آرگومان می‌پذیرد و روشنایی صفحه نمایش را روی آن مقدار تنظیم می‌کند.
.IP
مقدار invert رنگ‌های صفحه نمایش را معکوس می‌سازد.

.SH "گزارش باگ‌ها (BUGS)"
تغییر حالت‌های dpms در برخی سیستم‌ها ممکن است تداخل نامطلوبی با X ایجاد کند.
.PP
دستور vbestate ممکن است رفتارهای عجیب و پیش‌بینی‌نشده‌ای داشته باشد.
.PP
دستور post ممکن است به اجرای کدهای تصادفی بینجامد که اتفاقاً در محدوده‌ای قرار گرفته‌اند که پیش‌تر بخش‌هایی از بایوس ویدیویی در آنجا مستقر بوده است.
.PP
مشخصات VESA این الزام را ایجاد نمی‌کند که در صورت تنظیم حالت جاری از طریقی غیر از افزونه‌های بایوس VESA، دستور \(lqvbemode get\(rq حالت صحیح را ارائه کند.
.PP
توسعه واسط صفحه نمایش تخت VESA در همان مرحله طرح اولیه (proposal) متوقف شد. پارامترهای panelid و panelsize در بسیاری از رایانه‌ها کار می‌کنند، اما پیاده‌سازی سایر آرگومان‌ها روی سخت‌افزارهای موجود بعید به نظر می‌رسد.

.SH "نویسندگان (AUTHORS)"
ابزار vbetool توسط Matthew Garrett <mjg59@srcf.ucam.org>، بر مبنای کدهایی از پروژه read-edid اثر John Fremlin <john@fremlin.de>، کتابخانه LRMI
(http://sourceforge.net/projects/lrmi)
و XFree
(http://www.xfree86.org)
نوشته شده است. این نرم‌افزار تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) عرضه می‌شود.