نام (NAME)

gplink - پیونددهنده GNU PIC

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

gplink [options] [objects] [libraries]

هشدار (WARNING)

اطلاعات موجود در این صفحه راهنما گزیده‌ای از مستندات کامل gputils است و تنها به معنای گزینه‌ها محدود می‌شود. برای مشاهده مستندات کامل و به‌روز، به فایل "gputils.ps" واقع در پوشه مستندات gputils مراجعه کنید.

توضیحات (DESCRIPTION)

gplink تعدادی از فایل‌های هدف (object) و بایگانی را با هم ترکیب می‌کند، داده‌های آن‌ها را بازنشانی مکانی (relocate) می‌نماید و ارجاعات نمادهای آن‌ها را پیوند می‌دهد. این برنامه یک فایل اجرایی برای میکروکنترلرهای Microchip (TM) PIC (TM) تولید می‌کند. gplink بخشی از بسته gputils است. برای آگاهی از جزئیات سایر ابزارهای GNU PIC، صفحه راهنمای gputils(1) را بررسی کنید.

گزینه‌ها (OPTIONS)

-a FMT, --hex-format FMT: دستور gplink از قالب‌های فایل هگز inhx8m، inhx8s، inhx16 و inhx32 پشتیبانی می‌کند. این گزینه تعیین می‌کند که از کدام قالب فایل هگز استفاده شود. حالت پیش‌فرض inhx32 است.
-b OPT, --optimize-banksel OPT: حذف دستورالعمل‌های غیرضروری Banksel. [0]
-B, --experimental-banksel: استفاده از قابلیت آزمایشی حذف Banksel.
-c, --object: تولید یک شیء اجرایی در خروجی.
-C, --no-cinit-warnings: غیرفعال کردن این هشدار بخش _cinit هنگام استفاده از گزینه -O2: "Relocation symbol _cinit has no section."
-d, --debug: نمایش پیام‌های اشکال‌زدایی.
-f VALUE, --fill VALUE: پر کردن حافظه برنامه استفاده‌نشده و محافظت‌نشده با مقدار VALUE. این مقدار بر مقدار پرکننده اسکریپت پیونددهنده اولویت دارد. مقدار نباید بزرگ‌تر از 0xffff باشد. مقدار در مبنای شانزده (هگز) است و می‌تواند با "0x" شروع شود.
-h, --help: نمایش پیام راهنمای استفاده و خروج.
-I DIR, --include DIR: مشخص کردن دایرکتوری include.
-j, --no-save-local: غیرفعال کردن ذخیره ثبات‌های محلی در فایل COD.
-l, --no-list: غیرفعال کردن خروجی فایل فهرست (list file).
-m, --map: تولید یک فایل نگاشت حافظه (map file) در خروجی.
--mplink-compatible: این گزینه حالت سازگاری با MPLINK را فعال می‌کند.
-o FILE, --output FILE: نام جایگزین برای فایل خروجی.
-O OPT, --optimize OPT: سطح بهینه‌سازی. مقدار پیش‌فرض 1 است.
-p OPT, --optimize-pagesel OPT: حذف دستورالعمل‌های غیرضروری Pagesel. [0]
-P, --experimental-pagesel: استفاده از قابلیت آزمایشی حذف Pagesel.
-q, --quiet: جلوگیری از ارسال هرگونه خروجی به خروجی استاندارد.
-r, --use-shared: تلاش برای بازنشانی بخش‌های داده غیرمشترک به حافظه مشترک در صورت شکست بازنشانی مکانی.
-s FILE, --script FILE: اسکریپت پیونددهنده (Linker script).
-t SIZE, --stack SIZE: ایجاد یک بخش پشته (stack).
-S [0|1|2], --strict [0|1|2]: تنظیم سطح سخت‌گیری در مورد نمادهای مفقود. 0: این مقدار پیش‌فرض است. هیچ پیامی نمایش داده نمی‌شود. 1: در صورت وجود نماد مفقود، پیام هشدار نمایش داده می‌شود. 2: در صورت وجود نماد مفقود، پیام خطا نمایش داده می‌شود.
--strict-options: در صورت تنظیم، یک گزینه نمی‌تواند پارامتر گزینه دیگری باشد. برای مثال: -s --quiet
-u, --macro symbol=[value]: افزودن مقدار ماکرو برای اسکریپت.
-v, --version: نمایش اطلاعات نسخه و خروج.
-w, --processor-mismatch: غیرفعال کردن هشدار "processor mismatch" (عدم تطابق پردازنده).
-W, --experimental-pcallw: حذف کدهای واسط (stub) غیرضروری PCALLW ایجادشده توسط SDCC.

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

gputils(1)

نویسنده (AUTHOR)

Craig Franklin <craigfranklin@users.sourceforge.net>

حق نشر (COPYRIGHT)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه ویرایش 2 پروانه و چه (به انتخاب خودتان) هر ویرایش بالاتر دیگری، بازتوزیع کرده و/یا تغییر دهید.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب با یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.

شما باید یک نسخه از پروانه عمومی همگانی گنو را همراه با این برنامه دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به نشانی زیر بنویسید: Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.