.TH WINE 1 "July 2013" "Wine 11.17" "Windows On Unix"
.SH "نام (NAME)"
wine \- اجرای برنامه‌های Windows روی Unix
.SH "خلاصه دستور (SYNOPSIS)"
.B wine
.IR "program " [ arguments ]
.br
.B wine --help
.br
.B wine --version
.PP
برای دریافت دستورالعمل‌های مربوط به ارسال آرگومان‌ها به برنامه‌های Windows، لطفاً بخش
.B "برنامه/آرگومان‌ها (PROGRAM/ARGUMENTS)"
صفحه راهنما را ببینید.
.SH "توضیحات (DESCRIPTION)"
.B wine
برنامه داده‌شده را بارگذاری کرده و اجرا می‌کند، که می‌تواند یک فایل اجرایی DOS،
Windows 3.x، Win32 یا Win64 (در سیستم‌های ۶۴ بیتی) باشد.
.PP
برای اشکال‌زدایی wine، به‌جای آن از
.B winedbg
استفاده کنید.
.PP
برای اجرای فایل‌های اجرایی CUI (برنامه‌های کنسولی Windows)، به‌جای
.BR wine ،
از
.B wineconsole
استفاده کنید. این کار خروجی را در یک پنجره جداگانه نمایش می‌دهد. عدم استفاده از
.B wineconsole
برای برنامه‌های CUI تنها پشتیبانی بسیار محدودی از کنسول ارائه می‌دهد و ممکن است برنامه شما به‌درستی کار نکند.
.PP
هنگامی که فقط با
.B --help
یا
.B --version
فراخوانی شود،
.B wine
تنها یک پیام راهنمای کوتاه یا نسخه خود را به‌ترتیب چاپ کرده و خارج می‌شود.
.SH "برنامه/آرگومان‌ها (PROGRAM/ARGUMENTS)"
نام برنامه می‌تواند در قالب DOS
.RI ( C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE )
یا در قالب Unix
.RI ( /msdos/windows/sol.exe )
مشخص شود. می‌توانید با افزودن آرگومان‌ها به انتهای خط فرمانی که
.B wine
را فراخوانی می‌کند، آن‌ها را به برنامه در حال اجرا ارسال کنید
(مانند: \fIwine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT\fR).
توجه داشته باشید که هنگام فراخوانی Wine از طریق یک شل، باید نویسه‌های خاص (و فاصله‌ها) را با '\(rs' فراردهی (escape) کنید، مانند:
.PP
wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMyPrg\(rs\(rstest.exe
.PP
همچنین برنامه می‌تواند یکی از فایل‌های اجرایی Windows همراه Wine باشد که در این صورت مشخص کردن مسیر کامل اجباری نیست، مانند \fIwine explorer\fR یا \fIwine notepad\fR.
.PP
.SH "محیط (ENVIRONMENT)"
.B wine
متغیرهای محیطی شلی را که از آن اجرا شده است، در دسترس فرایندهای اجراشده Windows/DOS قرار می‌دهد. بنابراین، از نحو مناسب شل خود برای وارد کردن متغیرهای محیطی مورد نیازتان استفاده کنید.
.TP 
.B WINEPREFIX
در صورت تنظیم، محتوای این متغیر به عنوان نام دایرکتوری‌ای در نظر گرفته می‌شود که Wine داده‌های خود را در آن ذخیره می‌کند (پیش‌فرض
.IR $HOME/.wine
است).
این دایرکتوری همچنین برای شناسایی سوکتی که برای ارتباط با
.B wineserver
استفاده می‌شود، به کار می‌رود. تمام فرایندهای
.B wine
که از یک
.B wineserver
یکسان استفاده می‌کنند (یعنی: کاربر یکسان)، مواردی مانند رجیستری، حافظه اشتراکی و فایل پیکربندی را به اشتراک می‌گذارند.
با تنظیم
.B WINEPREFIX
روی مقادیر مختلف برای فرایندهای مختلف
.BR wine ،
امکان اجرای چندین فرایند کاملاً مستقل از
.B wine
فراهم می‌شود.
.TP
.B WINESERVER
مسیر و نام باینری
.B wineserver
را مشخص می‌کند. اگر تنظیم نشده باشد، Wine به دنبال فایلی به نام "wineserver" در مسیرهای متغیر PATH و چند مکان محتمل دیگر خواهد گشت.
.TP
.B WINEDEBUG
پیام‌های اشکال‌زدایی را روشن یا خاموش می‌کند. نحو (syntax) این متغیر به شکل زیر است:
.RI [ class ][\fB+\fR|\fB-\fR] channel [,[ class2 ][\fB+\fR|\fB-\fR] channel2 ]
.RS +7
.PP
.I class
اختیاری است و می‌تواند یکی از موارد زیر باشد:
.BR err ،
.BR warn ،
.BR fixme
یا
.BR trace .
اگر
.I class
مشخص نشود، تمام پیام‌های اشکال‌زدایی برای کانال (channel) مشخص‌شده روشن می‌شوند. هر کانال پیام‌هایی را درباره یک مؤلفه خاص از Wine چاپ می‌کند.
نویسه بعدی می‌تواند \fB+\fR یا \fB-\fR باشد تا کانال مشخص‌شده را به‌ترتیب روشن یا خاموش کند. اگر بخش
.I class
پیش از آن وجود نداشته باشد، می‌توان از \fB+\fR\fR ابتدایی صرف‌نظر کرد. توجه داشته باشید که درج فاصله در هیچ‌جای رشته مجاز نیست.
.PP
مثال‌ها:
.TP
WINEDEBUG=warn+all
تمام پیام‌های هشدار را روشن می‌کند (برای اشکال‌زدایی توصیه می‌شود).
.br
.TP
WINEDEBUG=warn+dll,+heap
پیام‌های هشدار DLL و تمام پیام‌های heap را روشن می‌کند.
.br
.TP
WINEDEBUG=fixme-all,warn+cursor,+relay
تمام پیام‌های FIXME را خاموش، پیام‌های هشدار cursor را روشن و تمام پیام‌های relay (فراخوانی‌های API) را روشن می‌کند.
.br 
.TP
WINEDEBUG=relay
تمام پیام‌های relay را روشن می‌کند. برای کنترل بیشتر بر گنجاندن یا حذف توابع و dllها در ردگیری relay، کلید رجیستری
.B HKEY_CURRENT_USER\\\\Software\\\\Wine\\\\Debug
را بررسی کنید.
.PP
برای کسب اطلاعات بیشتر درباره پیام‌های اشکال‌زدایی، به فصل
.I Running Wine
از Wine User Guide مراجعه کنید.
.RE
.TP
.B WINEDLLPATH
مسیر(هایی) را که باید در آن‌ها به دنبال dllهای داخلی (builtin) و برنامه‌های Winelib گشت، مشخص می‌کند. این یک فهرست از دایرکتوری‌ها است که با ":" از یکدیگر جدا شده‌اند. علاوه بر هر دایرکتوری مشخص‌شده در
.BR WINEDLLPATH ،
برنامه Wine دایرکتوری محل نصب را نیز بررسی خواهد کرد.
.TP
.B WINEDLLOVERRIDES
نوع جایگزینی (override) و اولویت بارگذاری dllها را در فرایند بارگذاری برای هر dll تعیین می‌کند. در حال حاضر دو نوع کتابخانه وجود دارد که می‌توانند در فضای آدرس فرایند بارگذاری شوند: dllهای بومی Windows
.RI ( native )
و dllهای داخلی Wine
.RI ( builtin ).
نوع را می‌توان با حرف اول آن خلاصه کرد
.RI ( n
یا
.RI b ).
همچنین کتابخانه را می‌توان غیرفعال کرد (\(aq\(aq). هر دنباله از اولویت‌ها باید با کاما از یکدیگر جدا شود.
.RS
.PP
هر dll می‌تواند اولویت بارگذاری خاص خود را داشته باشد. اولویت بارگذاری تعیین می‌کند کدام نسخه از dll برای بارگذاری در فضای آدرس مورد تلاش قرار گیرد. اگر بارگذاری نسخه اول ناموفق بود، نسخه بعدی امتحان می‌شود و به همین ترتیب ادامه می‌یابد. کتابخانه‌های متعدد با اولویت بارگذاری یکسان را می‌توان با کاما از هم جدا کرد. همچنین می‌توان با جدا کردن مدخل‌ها با ";"، اولویت‌های بارگذاری متفاوتی را برای کتابخانه‌های مختلف تعیین کرد.
.PP
اولویت بارگذاری برای یک dll شانزده‌بیتی همواره با اولویت بارگذاری dll سی‌ودوبیتی دربردارنده آن تعیین می‌شود (که می‌توان آن را با نگاه کردن به پیوند نمادین فایل .dll.so شانزده‌بیتی شناسایی کرد). برای نمونه اگر
\fIole32.dll\fR
به عنوان builtin پیکربندی شده باشد،
\fIstorage.dll\fR
نیز به صورت builtin بارگذاری خواهد شد، زیرا \fIole32.dll\fR ۳۲ بیتی حاوی \fIstorage.dll\fR ۱۶ بیتی است.
.PP
مثال‌ها:
.TP
WINEDLLOVERRIDES="comdlg32,shell32=n,b"
.br
ابتدا تلاش می‌کند comdlg32 و shell32 را به صورت dll بومی Windows بارگذاری کند و در صورت ناموفق بودن بارگذاری بومی، نسخه builtin را امتحان می‌کند.
.TP
WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
.br
تلاش می‌کند کتابخانه‌های comdlg32 و shell32 را به صورت dllهای بومی Windows بارگذاری کند. علاوه بر این، اگر برنامه‌ای درخواست بارگذاری \fIc:\(rsfoo\(rsbar\(rsbaz.dll\fR را داشته باشد، کتابخانه داخلی \fIbaz\fR را بارگذاری می‌کند..TP
WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="
.br
تلاش می‌کند تا comdlg32 ابتدا به صورت توکار (builtin) بارگذاری شود و در صورت شکست، نسخهٔ محلی (native) آن امتحان شود؛ shell32 همواره به صورت توکار و comctl32 همواره به صورت محلی بارگذاری می‌شوند؛ oleaut32 نیز غیرفعال خواهد بود.
.RE
.TP
.B WINEPATH
مسیر(های) اضافه‌ای را برای افزوده شدن به ابتدای متغیر محیطی پیش‌فرض
.B PATH
ویندوز مشخص می‌کند. این مقدار فهرستی از دایرکتوری‌ها به سبک ویندوز است که با «;» از یکدیگر جدا شده‌اند.
.RS
.PP
برای ایجاد یک جایگزین دائمی، مقدار
.B PATH
را در زیرکلید رجیستری
.B HKEY_CURRENT_USER\\\\Environment
ویرایش کنید (در صورت نیاز ایجاد نمایید).
.RE
.TP
.B WINEARCH
معماری ویندوز مورد پشتیبانی را مشخص می‌کند. این مقدار می‌تواند روی
.B win32
(فقط پشتیبانی از برنامه‌های ۳۲ بیتی)، روی
.B win64
(پشتیبانی از هر دو برنامه‌های ۶۴ بیتی و ۳۲ بیتی)، یا روی
.B wow64
(پشتیبانی از برنامه‌های ۶۴ بیتی و ۳۲ بیتی، با استفاده از فرایند میزبان ۶۴ بیتی در تمام حالات) تنظیم شود.
.br
معماری پشتیبانی‌شده توسط یک پیشوند (prefix) مشخصِ Wine در هنگام ایجاد پیشوند تعیین می‌شود و پس از آن قابل تغییر نیست. هنگام اجرا با یک پیشوند موجود، اگر
.B WINEARCH
با معماری پیشوند مطابقت نداشته باشد، Wine از راه‌اندازی خودداری خواهد کرد. با این وجود، تغییر آزادانه میان \fBwin64\fR و \fBwow64\fR در یک پیشوند ۶۴ بیتیِ موجود امکان‌پذیر است.
.TP
.B WINE_D3D_CONFIG
گزینه‌های پیکربندی Direct3D را مشخص می‌کند. این متغیر می‌تواند به جای تغییر کلید رجیستری
.B HKEY_CURRENT_USER\\\\Software\\\\Wine\\\\Direct3D
به کار رود. مقدار آن فهرستی از جفت‌های کلید-مقدار است که با کاما یا نقطه-ویرگول از هم جدا شده‌اند.
.RS
برای مثال:
.TP
WINE_D3D_CONFIG="renderer=vulkan;VideoPciVendorID=0xc0de"
.PP
اگر تنظیمی به صورت جداگانه هم در متغیر محیطی و هم در رجیستری مشخص شده باشد، متغیر محیطی اولویت خواهد داشت.
.RE
.TP
.B DISPLAY
نمایشگر X11 مورد استفاده را مشخص می‌کند.
.TP
متغیرهای پیکربندی درایور صوتی OSS:
.TP
.B AUDIODEV
دستگاه ورودی / خروجی صدا را تعیین می‌کند. پیش‌فرض
.IR /dev/dsp .
.TP
.B MIXERDEV
دستگاه مربوط به کنترل‌های میکسر را تعیین می‌کند. پیش‌فرض
.IR /dev/mixer .
.TP
.B MIDIDEV
دستگاه MIDI (ترتیب‌سنج) را تعیین می‌کند. پیش‌فرض
.IR /dev/sequencer .
.SH "فایل‌ها (FILES)"
.TP
.I wine
بارگذار برنامهٔ Wine.
.TP
.I wineconsole
بارگذار برنامهٔ Wine برای برنامه‌های رابط کاربری متنی/کنسول (CUI).
.TP
.I wineserver
سرور Wine.
.TP
.I winedbg
دیباگر Wine.
.TP
.I $WINEPREFIX/dosdevices
دایرکتوری حاوی نگاشت‌های دستگاه‌های DOS. هر فایل در این دایرکتوری یک پیوند نمادین به فایل دستگاه یونیکس مربوطه است که آن دستگاه را پیاده‌سازی می‌کند. برای نمونه، اگر COM1 به \fI/dev/ttyS0\fR نگاشت شده باشد، یک پیوند نمادین به صورت \fI$WINEPREFIX/dosdevices/com1\fR -> \fI/dev/ttyS0\fR خواهید داشت.
.br
درایوهای DOS نیز با پیوندهای نمادین مشخص می‌شوند؛ برای نمونه اگر درایو D: متناظر با CDROM سوارشده در \fI/mnt/cdrom\fR باشد، پیوندی نمادین به صورت \fI$WINEPREFIX/dosdevices/d:\fR -> \fI/mnt/cdrom\fR خواهید داشت. دستگاه یونیکس متناظر با یک درایو DOS را نیز می‌توان به همین روش مشخص کرد، تنها با این تفاوت که به جای «:» از «::» استفاده می‌شود. بنابراین برای مثال پیشین، اگر دستگاه CDROM از مسیر \fI/dev/hdc\fR سوار شده باشد، پیوند نمادین مربوطه به صورت \fI$WINEPREFIX/dosdevices/d::\fR -> \fI/dev/hdc\fR خواهد بود..SH "نویسندگان (AUTHORS)"
Wine به لطف تلاش توسعه‌دهندگان بسیاری در دسترس است. برای مشاهده فهرستی از نویسندگان، لطفاً فایل
.I AUTHORS
را در بالاترین سطح دایرکتوری توزیع سورس‌کد بررسی کنید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Wine تحت شرایط مجوز LGPL قابل توزیع است. نسخه‌ای از این مجوز در فایل
.I COPYING.LIB
در بالاترین سطح دایرکتوری توزیع سورس‌کد قرار دارد.
.SH "گزارش باگ‌ها (BUGS)"
.PP
گزارش وضعیت بسیاری از برنامه‌ها در
.UR https://appdb.winehq.org
.B پایگاه داده برنامه‌های Wine
.UE
موجود است. لطفاً در صورت نیاز، برای برنامه‌هایی که در حال حاضر اجرا می‌کنید، مدخل‌هایی را به این فهرست بیفزایید.
.PP
باگ‌ها را می‌توان در
.UR https://bugs.winehq.org
.B سامانه ردیابی باگ Wine
.UE
گزارش کرد.
.SH "در دسترس بودن (AVAILABILITY)"
تازه‌ترین نسخه عمومی 
.B wine
از طریق WineHQ، یعنی
.UR https://www.winehq.org
.B مرکز توسعه Wine
.UE
در دسترس است.
.SH "همچنین ببینید (SEE ALSO)"
.BR wineserver (1),
.BR winedbg (1),
.br
.UR https://www.winehq.org/help
.B مستندات و پشتیبانی Wine
.UE .