نام (NAME)

widl - کامپایلر زبان تعریف رابط (IDL) برای Wine

خلاصه دستور (SYNOPSIS)

widl [options] IDL_file
widl [options] --dlldata-only name1 [name2...]

توضیحات (DESCRIPTION)

هنگامی که هیچ گزینه‌ای استفاده نشود، برنامه بسته به محتوای فایل IDL، یک فایل هدر و احتمالاً استاب‌های کلاینت و سرور، فایل‌های پروکسی و dlldata، یک typelib و یک فایل UUID تولید خواهد کرد. اگر هر یک از گزینه‌های -c، -h، -p، -s، -t، -u یا --local-stubs مشخص شود، widl تنها فایل‌های درخواستی را تولید می‌کند و نه هیچ فایل دیگری را. در صورت اجرا با --dlldata-only ، دستور widl تنها یک فایل dlldata تولید خواهد کرد که شامل فهرستی از نام‌های ارائه‌شده به عنوان آرگومان است. معمولاً شیوه به‌روزرسانی این فایل بدین صورت است که با هر بار اجرای widl ، فایل dlldata موجود را خوانده و در صورت لزوم آن را با همان فهرست نام‌ها، اما همراه با فایل پروکسی فعلی، مجدداً بازتولید می‌کند.

هنگامی که بدون هیچ آرگومانی اجرا شود، widl یک پیام راهنما چاپ خواهد کرد.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی:

-V

چاپ شماره نسخه و خروج.

-o, --output=name

تنظیم نام فایل خروجی. هنگام تولید چندین فایل خروجی، این گزینه تنها نام پایهٔ فایل را مشخص می‌کند؛ سپس فایل‌های خروجی مربوطه به صورت name.h، name_p.c و غیره نام‌گذاری می‌شوند. اگر یک نام فایل کامل همراه با پسوند مشخص شود، تنها همان فایل تولید خواهد شد.

-b, --target=cpu-manufacturer[-kernel]-os

تعیین معماری مقصد هنگام کامپایل متقاطع (cross-compiling). مشخصات مقصد در قالب استاندارد autoconf به همان صورتی است که توسط config.sub بازگردانده می‌شود.

-m32, -m64, --win32, --win64

اجبار معماری مقصد به ۳۲ بیتی یا ۶۴ بیتی.

--sysroot=dir

پیشوندگذاری مسیرهای include استاندارد با dir.

--nostdinc

عدم جستجو در مسیرهای include استاندارد مانند /usr/include و /usr/local/include.

گزینه‌های هدر:

-h

تولید فایل‌های هدر. نام فایل خروجی پیش‌فرض infile.h است.

--oldnames

استفاده از قواعد نام‌گذاری قدیمی.

گزینه‌های کتابخانه نوع (Type library):

-t

تولید یک کتابخانه نوع (type library). نام فایل خروجی پیش‌فرض infile.tlb است. اگر نام فایل خروجی به .res ختم شود، در عوض یک فایل منبع (resource) باینری حاوی کتابخانه نوع تولید می‌شود.

-L path

افزودن یک دایرکتوری به مسیر جستجوی کتابخانه برای typelibهای واردشده. این گزینه می‌تواند چندین بار مشخص شود.

--oldtlb

تولید یک کتابخانه نوع در قالب قدیمی (قالب SLTG).

گزینه‌های فایل UUID:

-u

تولید یک فایل UUID. نام فایل خروجی پیش‌فرض infile_i.c است.

گزینه‌های تولید پروکسی/استاب:

--align=n, --packing=n

تنظیم بسته‌بندی ساختار (structure packing) به n. مقادیر پشتیبانی‌شده ۲، ۴ و ۸ هستند.

-c

تولید فایل استاب کلاینت. نام فایل خروجی پیش‌فرض infile_c.c است.

-Os

تولید استاب‌های درون‌خطی (inline).

-Oi

تولید استاب‌های تفسیرشده با سبک قدیمی.

-Oif, -Oic, -Oicf

تولید استاب‌های کاملاً تفسیرشده با سبک جدید. این حالت پیش‌فرض است.

-p

تولید یک پروکسی. نام فایل خروجی پیش‌فرض infile_p.c است.

--prefix-all=prefix

پیشوندی برای قرار دادن در نام هر دو استاب کلاینت و سرور.

--prefix-client=prefix

پیشوندی برای قرار دادن در نام استاب‌های کلاینت.

--prefix-server=prefix

پیشوندی برای قرار دادن در نام استاب‌های سرور.

-s

تولید یک فایل استاب سرور. نام فایل خروجی پیش‌فرض infile_s.c است.

--winrt

فعال‌سازی حالت Windows Runtime.

--ns_prefix

پیشوندگذاری فضاهای نام با فضای نام ABI.

گزینه‌های اسکریپت ثبت:

-r

تولید یک اسکریپت ثبت. نام فایل خروجی پیش‌فرض infile_r.rgs است. اگر نام فایل خروجی به .res ختم شود، در عوض یک فایل منبع باینری حاوی اسکریپت تولید می‌شود.

گزینه‌های فایل Dlldata:

--dlldata-only name1 [name2...]

بازتولید فایل dlldata از ابتدا با استفاده از نام‌های پروکسی مشخص‌شده. نام فایل خروجی پیش‌فرض dlldata.c است.

گزینه‌های فایل متادیتا:

--winmd

تولید یک فایل متادیتای Windows Runtime. این گزینه حالت --winrt را نیز فعال می‌کند. نام فایل خروجی پیش‌فرض infile.winmd است.

گزینه‌های پیش‌پردازنده:

-I path

افزودن یک دایرکتوری به مسیر جستجوی include. مشخص کردن چندین دایرکتوری include مجاز است.

-D id[=val]

تعریف ماکروی پیش‌پردازنده id با مقدار val.

-E

فقط پیش‌پردازش انجام شود.

-N

ورودی پیش‌پردازش نشود.

گزینه‌های اشکال‌زدایی:

-W

فعال‌سازی هشدارهای سخت‌گیرانه (pedantic).

-d n

تنظیم سطح اشکال‌زدایی روی عدد صحیح غیرمنفی n. در صورت وجود پیشوند 0x، به عنوان یک عدد هگزادسیمال تفسیر می‌شود. برای مفهوم مقادیر، بخش اشکال‌زدایی (DEBUG) را ببینید.

گزینه‌های متفرقه:

-app_config

نادیده گرفته می‌شود؛ جهت سازگاری با midl وجود دارد.

--acf=file

استفاده از فایل پیکربندی برنامه مشخص‌شده.

--local-stubs=file

تولید استاب‌های خالی برای متدهای call_as/local در یک رابط شیء و نوشتن آن‌ها در file.

اشکال‌زدایی (DEBUG)

سطح اشکال‌زدایی n یک ماسک بیتی (bitmask) با معانی زیر است:
- 0x01 اعلام اینکه کدام منبع تجزیه می‌شود (حالت پرگو)
- 0x02 تخلیه ساختارهای داخلی
- 0x04 ایجاد ردگیری تجزیه‌کننده (yydebug=1)
- 0x08 پیام‌های پیش‌پردازنده
- 0x10 پیام‌های lex پیش‌پردازنده
- 0x20 ردگیری yacc پیش‌پردازنده

گزارش باگ‌ها (BUGS)

باگ‌ها را می‌توان در سامانه ردیابی باگ Wine گزارش کرد.

نویسندگان (AUTHORS)

widl در ابتدا توسط Ove Kåven نوشته شد. این برنامه توسط Rob Shearman، Dan Hipschman و دیگران بهبود یافته است. برای مشاهده فهرست کامل، گزارش‌های ثبت (commit logs) گیت را بررسی کنید. این صفحه راهنما در ابتدا توسط Hannu Valtonen نوشته شده و سپس توسط Dan Hipschman به‌روزرسانی شد.

در دسترس بودن (AVAILABILITY)

widl بخشی از توزیع Wine است که از طریق WineHQ، یعنی مقر توسعه Wine در دسترس است.

همچنین ببینید (SEE ALSO)

مستندات و پشتیبانی Wine.