DLLTOOL(1) GNU Development Tools DLLTOOL(1)

avr-dlltool - ایجاد پرونده‌های لازم برای ساخت و استفاده از DLLها

dlltool [-d|--input-def def-file-name]
[-b|--base-file base-file-name]
[-e|--output-exp exports-file-name]
[-z|--output-def def-file-name]
[-l|--output-lib library-file-name]
[-y|--output-delaylib library-file-name]
[--export-all-symbols]
[--no-export-all-symbols]
[--exclude-symbols list]
[--no-default-excludes]
[-S|--as path-to-assembler]
[-f|--as-flags options]
[-D|--dllname name]
[-m|--machine machine]
[-a|--add-indirect]
[-U|--add-underscore]
[--add-stdcall-underscore]
[-k|--kill-at]
[-A|--add-stdcall-alias]
[-p|--ext-prefix-alias prefix]
[-x|--no-idata4]
[-c|--no-idata5]
[--use-nul-prefixed-import-tables]
[-I|--identify library-file-name]
[--identify-strict]
[-i|--interwork]
[-n|--nodelete]
[-t|--temp-prefix prefix]
[-v|--verbose]
[-h|--help]
[-V|--version]
[--no-leading-underscore]
[--leading-underscore]
[--deterministic-libraries]
[--non-deterministic-libraries]
[object-file ...]

دستور dlltool ورودی‌های خود را می‌خواند که می‌توانند از طریق گزینه‌های -d و -b و همچنین پرونده‌های شیء (object files) مشخص‌شده در خط فرمان دریافت شوند. سپس این ورودی‌ها را پردازش کرده و در صورتی که گزینه -e مشخص شده باشد یک پرونده صادرات (exports file) ایجاد می‌کند. اگر گزینه -l مشخص شده باشد یک پرونده کتابخانه ایجاد می‌نماید و اگر گزینه -z مشخص شده باشد یک پرونده def تولید می‌کند. هر یک یا تمامی گزینه‌های -e، -l و -z می‌توانند در یک بار اجرای dlltool حضور داشته باشند.

هنگام ساخت یک DLL، علاوه بر کد منبع DLL، وجود سه پرونده دیگر نیز ضروری است. ابزار dlltool می‌تواند در ایجاد این پرونده‌ها کمک کند.

پرونده نخست یک پرونده .def است که مشخص می‌کند کدام توابع از DLL صادر می‌شوند، DLL چه توابعی را وارد می‌کند و مواردی از این قبیل. این یک پرونده متنی است و می‌توان آن را به صورت دستی ایجاد کرد، یا می‌توان از dlltool با گزینه -z برای ساخت آن استفاده نمود. در این حالت، dlltool پرونده‌های شیء مشخص‌شده در خط فرمان را پویش کرده و توابعی را که به طور ویژه به عنوان صادرشونده علامت‌گذاری شده‌اند جستجو می‌کند و مدخل‌هایی برای آن‌ها در پرونده .def تولیدی قرار می‌دهد.

برای اینکه تابعی به عنوان صادرشونده از یک DLL نشانه‌گذاری شود، باید یک مدخل -export:<name_of_function> در بخش .drectve پرونده شیء داشته باشد. در زبان C می‌توان این کار را با استفاده از عملگر asm() انجام داد:

asm (".section .drectve");
asm (".ascii \"-export:my_func\"");

int my_func (void) { ... }

پرونده دوم مورد نیاز برای ساخت DLL، پرونده صادرات (exports file) است. این پرونده با پرونده‌های شیء تشکیل‌دهنده بدنه اصلی DLL پیوند می‌یابد و رابط میان DLL و دنیای خارج را مدیریت می‌کند. این یک پرونده باینری است و می‌توان آن را با دادن گزینه -e به dlltool هنگام ایجاد یا خواندن پرونده .def تولید کرد.

پرونده سوم مورد نیاز برای ساخت DLL، پرونده کتابخانه‌ای است که برنامه‌ها برای دسترسی به توابع موجود در DLL با آن پیوند می‌خورند (یک «کتابخانه واردات» یا import library). این پرونده را می‌توان با ارائه گزینه -l به dlltool در هنگام ساخت یا خواندن پرونده .def ایجاد کرد.

اگر گزینه -y مشخص شود، dlltool یک کتابخانه واردات با تاخیر (delay-import library) تولید می‌کند که می‌تواند به جای کتابخانه واردات معمول استفاده شود تا به برنامه اجازه دهد تنها پس از اولین فراخوانی یک تابع واردشده، پیوند با DLL را برقرار سازد. برنامه اجرایی حاصل باید با کتابخانه ایستا delayimp حاوی __delayLoadHelper2() پیوند داده شود که به نوبه خود LoadLibraryA و GetProcAddress را از kernel32 وارد می‌کند.

ابزار dlltool پرونده کتابخانه را مستقیماً می‌سازد، اما پرونده صادرات را با ایجاد پرونده‌های موقت حاوی دستورات اسمبلی و سپس اسمبل کردن آن‌ها ایجاد می‌کند. گزینه خط فرمان -S می‌تواند برای مشخص کردن مسیر اسمبلری که dlltool استفاده خواهد کرد به کار رود و گزینه -f می‌تواند برای ارسال فلگ‌های مشخص به آن اسمبلر استفاده شود. گزینه -n می‌تواند برای جلوگیری از حذف این پرونده‌های موقت اسمبلی پس از اتمام کار dlltool به کار رود، و در صورتی که -n دو بار مشخص شود، از حذف پرونده‌های موقت شیء که برای ساخت کتابخانه استفاده شده‌اند نیز جلوگیری خواهد کرد.

در اینجا نمونه‌ای از ساخت یک DLL از پرونده منبع dll.c و همچنین ساخت برنامه‌ای (از پرونده شیء به نام program.o) که از آن DLL استفاده می‌کند آورده شده است:

gcc -c dll.c
dlltool -e exports.o -l dll.lib dll.o
gcc dll.o exports.o -o dll.dll
gcc program.o dll.lib -o program

همچنین می‌توان از dlltool برای پرس‌وجو از یک کتابخانه واردات موجود جهت تعیین نام DLL مرتبط با آن استفاده کرد. توضیحات گزینه -I یا --identify را ببینید.

گزینه‌های خط فرمان دارای معانی زیر هستند:

نام پرونده .def را جهت خواندن و پردازش مشخص می‌کند.
نام پرونده پایه (base file) را جهت خواندن و پردازش مشخص می‌کند. محتویات این پرونده به بخش بازآرایی (relocation section) در پرونده صادرات تولیدشده توسط dlltool اضافه خواهد شد.
نام پرونده صادراتی (exports file) تولیدی توسط dlltool را مشخص می‌کند.
نام پرونده .def ایجادشده توسط dlltool را تعیین می‌کند.
نام پرونده کتابخانه‌ای را که باید توسط dlltool ایجاد شود تعیین می‌کند.
نام پرونده کتابخانه واردات با تاخیر را که باید توسط dlltool ایجاد شود مشخص می‌کند.
هنگام ساخت کتابخانه‌های خروجی در پاسخ به گزینه‌های --output-lib یا --output-delaylib، برای مهرهای زمانی، شناسه‌های کاربری و شناسه‌های گروهی ایجادشده از مقدار صفر استفاده می‌کند (--deterministic-libraries) یا مهرهای زمانی و شناسه‌های کاربری و گروهی واقعی را به کار می‌گیرد (--non-deterministic-libraries).
تمام نمادهای عمومی و ضعیف (weak) تعریف‌شده در پرونده‌های شیء ورودی را به عنوان نمادهای صادراتی در نظر می‌گیرد. فهرست کوچکی از نمادها وجود دارد که به طور پیش‌فرض صادر نمی‌شوند؛ گزینه --no-default-excludes را ببینید. می‌توانید با استفاده از گزینه --exclude-symbols نمادهایی را به این فهرست استثناها بیفزایید.
تنها نمادهایی را صادر می‌کند که به طور صریح در پرونده .def ورودی یا در بخش‌های .drectve پرونده‌های شیء ورودی فهرست شده‌اند. این رفتار پیش‌فرض برنامه است. بخش‌های .drectve توسط ویژگی‌های dllexport در کد منبع ایجاد می‌شوند.
نمادهای موجود در list را صادر نمی‌کند. این فهرست شامل نام نمادهایی است که با کاما یا دونقطه از هم جدا شده‌اند. نام نمادها نباید با خط زیر (underscore) شروع شود. این گزینه فقط زمانی معنا دارد که از --export-all-symbols استفاده شده باشد.
هنگامی که از --export-all-symbols استفاده می‌شود، به طور پیش‌فرض از صدور برخی نمادهای ویژه خودداری می‌گردد. فهرست کنونی این نمادها شامل DllMain@12، DllEntryPoint@0 و impure_ptr است. با استفاده از گزینه --no-default-excludes می‌توانید این نمادهای ویژه را نیز صادر کنید. این گزینه تنها زمانی معتبر است که از --export-all-symbols استفاده شده باشد.
مسیر کامل به همراه نام پرونده اسمبلری را که باید برای ایجاد پرونده صادرات استفاده شود مشخص می‌کند.
گزینه‌های خط فرمان مشخصی را تعیین می‌کند که هنگام ساخت پرونده صادرات به اسمبلر ارسال خواهند شد. این گزینه حتی اگر گزینه -S استفاده نشود نیز کار می‌کند. این گزینه تنها یک آرگومان می‌پذیرد و در صورت تکرار در خط فرمان، مقادیر بعدی جایگزین مقادیر قبلی می‌شوند؛ بنابراین برای ارسال چند گزینه به اسمبلر، آن‌ها را در گیومه دوتایی محصور کنید.
نامی را مشخص می‌کند که در صورت استفاده از گزینه -e، به عنوان نام DLL در پرونده .def ذخیره می‌شود. اگر این گزینه مشخص نشود، نام پرونده ارسال‌شده به گزینه -e به عنوان نام DLL به کار می‌رود.
نوع ماشینی (معماری) را مشخص می‌کند که پرونده کتابخانه باید برای آن ساخته شود. ابزار dlltool دارای یک مقدار پیش‌فرض توکار است که به نحوه ساخت آن بستگی دارد، اما این گزینه می‌تواند آن را تغییر دهد. این ویژگی معمولاً تنها هنگام ایجاد DLL برای پردازنده ARM که محتویات آن با دستورالعمل‌های Thumb کدگذاری شده کاربرد دارد.
مشخص می‌کند که هنگام ساخت پرونده صادرات توسط dlltool، بخشی اضافه شود که به توابع صادرشده اجازه می‌دهد بدون استفاده از کتابخانه واردات ارجاع داده شوند.
مشخص می‌کند که هنگام ساخت پرونده صادرات توسط dlltool، یک خط زیر به ابتدای نام تمامی نمادهای صادرشده اضافه شود.
مشخص می‌کند که آیا نمادهای استاندارد باید به داشتن پیشوند خط زیر مجبور شوند یا خیر.
مشخص می‌کند که هنگام ساخت پرونده صادرات توسط dlltool، یک خط زیر به ابتدای نام توابع صادرشده stdcall افزوده شود. نام متغیرها و نام توابع غیر stdcall دست‌نخورده باقی می‌مانند. این گزینه هنگام ایجاد کتابخانه‌های واردات سازگار با GNU برای DLLهای ارائه‌شده توسط شخص ثالث که با ابزارهای MS-Windows ساخته شده‌اند سودمند است.
مشخص می‌کند که پسوندهای @<number> از نام توابع stdcall که از DLL وارد می‌شوند حذف شوند. این گزینه هنگام ایجاد کتابخانه واردات برای یک DLL که توابع stdcall را بدون پسوند مرسوم @<number> صادر می‌کند سودمند است.

این تغییر نام نمادهای ارائه‌شده توسط کتابخانه واردات را برای برنامه‌های پیوندیافته با آن تغییر نمی‌دهد، بلکه صرفاً مدخل‌های موجود در جدول واردات (بخش idata.) را تغییر می‌دهد.

مشخص می‌کند که هنگام ساخت پرونده صادرات توسط dlltool، علاوه بر نمادهای دارای @ <number>، نام‌های مستعار برای نمادهای stdcall بدون @ <number> نیز اضافه شوند.
باعث می‌شود dlltool نام‌های مستعار خارجی برای تمامی واردات DLL با پیشوند مشخص‌شده بسازد. این نام‌های مستعار هم برای نمادهای خارجی و هم برای نمادهای وارداتی فاقد خط زیر آغازین ایجاد می‌شوند.
مشخص می‌کند که هنگام ساخت پرونده‌های صادرات و کتابخانه توسط dlltool، بخش ".idata4" حذف شود. این گزینه برای سازگاری با برخی سیستم‌های عامل خاص است.
مشخص می‌کند که هنگام ساخت پرونده‌های صادرات و کتابخانه توسط dlltool، بخش‌های ".idata4" و ".idata5" با یک عنصر صفر پیشوند شوند. این کار نحوه تولید کتابخانه‌های واردات قدیمی gnu توسط "dlltool" را شبیه‌سازی می‌کند. این گزینه به طور پیش‌فرض غیرفعال است.
مشخص می‌کند که هنگام ساخت پرونده‌های صادرات و کتابخانه توسط dlltool، بخش ".idata5" حذف شود. این گزینه جهت سازگاری با برخی سیستم‌های عامل خاص است.
مشخص می‌کند که dlltool کتابخانه واردات مشخص‌شده توسط filename را بررسی کرده و نام DLL(های) مرتبط را در "stdout" گزارش کند. این عملیات می‌تواند علاوه بر سایر عملیات‌های تعیین‌شده توسط سایر گزینه‌ها و آرگومان‌ها اجرا شود. در صورتی که کتابخانه واردات وجود نداشته باشد یا در واقع یک کتابخانه واردات نباشد، dlltool با شکست مواجه می‌شود. همچنین گزینه --identify-strict را ببینید.
رفتار گزینه --identify را تغییر می‌دهد، به طوری که اگر filename با بیش از یک DLL مرتبط باشد، خطا گزارش شود.
مشخص می‌کند که dlltool پرونده‌های شیء موجود در پرونده کتابخانه و پرونده صادرات تولیدی را به عنوان پشتیبانی‌کننده از تعامل متقابل میان کدهای ARM و Thumb علامت‌گذاری کند.
باعث می‌شود dlltool پرونده‌های موقت اسمبلی مورد استفاده برای ساخت پرونده صادرات را حفظ کند. در صورت تکرار این گزینه، dlltool پرونده‌های موقت شیء مورد استفاده برای ساخت پرونده کتابخانه را نیز حفظ خواهد کرد.
باعث می‌شود dlltool هنگام ساخت نام پرونده‌های موقت اسمبلی و شیء از prefix استفاده کند. به طور پیش‌فرض، پیشوند پرونده‌های موقت از روی شناسه فرآیند (pid) تولید می‌شود.
باعث می‌شود dlltool عملیاتی را که انجام می‌دهد شرح دهد (حالت پرگویی).
فهرستی از گزینه‌های خط فرمان را نمایش داده و سپس خارج می‌شود.
شماره نسخه dlltool را نمایش داده و سپس خارج می‌شود.
@file
گزینه‌های خط فرمان را از file می‌خواند. گزینه‌های خوانده‌شده به جای گزینه اصلی @file قرار می‌گیرند. اگر file وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به صورت لغوی رفتار شده و حذف نمی‌شود.

گزینه‌ها در file با فاصله‌های خالی از هم جدا می‌شوند. یک نویسه فاصله خالی را می‌توان با قرار دادن کل گزینه در گیومه تکی یا دوتایی گنجاند. هر نویسه‌ای (از جمله ممیز وارونه) را می‌توان با درج یک ممیز وارونه در ابتدای آن اضافه کرد. خود file ممکن است حاوی گزینه‌های @file دیگری باشد؛ چنین گزینه‌هایی به صورت بازگشتی پردازش خواهند شد.

صفحات Info برای binutils.

حق نشر (c) 1991-2026 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)

اجازه رونوشت‌برداری، توزیع و/یا تغییر این سند تحت شرایط مجوز اسناد آزاد گنو (GNU Free Documentation License) نسخه 1.3 یا هر نسخه بالاتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد، و بدون متون پشت جلد. نسخه‌ای از این مجوز در بخش موسوم به "GNU Free Documentation License" گنجانده شده است.

2026-07-30 binutils-2.47