.TH GPASM 1 "2016-02-28" "gputils-1.5.2" "Linux user's manual" .SH "نام (NAME)" gpasm \- اسمبلر GNU PIC .SH "خلاصه دستور (SYNOPSIS)" .B gpasm [options] file .SH "هشدار (WARNING)" اطلاعات موجود در این صفحه راهنما، چکیده‌ای از مستندات کامل gputils است و به شرح معانی گزینه‌ها محدود می‌شود. برای مستندات کامل و به‌روز، به فایل "gputils.ps" واقع در دایرکتوری docs برنامه gputils مراجعه کنید. .SH "توضیحات (DESCRIPTION)" .B gpasm یک اسمبلر برای میکروکنترلرهای Microchip (TM) PIC (TM) است. هدف آن سازگاری با اسمبلر MPASM متعلق به شرکت سازنده است. .B gpasm بخشی از gputils است. برای جزئیات درباره سایر ابزارهای GNU PIC، صفحه راهنمای .BR gputils (1) را بررسی کنید. .SH "گزینه‌ها (OPTIONS)" در زیر خلاصه‌ای از گزینه‌های .B gpasm آمده است. گزینه‌های .B gpasm همواره بر هرگونه تنظیماتی در کد مبدأ برتری دارند. .TP .BR "\-a FMT", " \-\-hex\-format FMT" برنامه GPASM از قالب‌های فایل هگز inhx8m، inhx8s، inhx16 و inhx32 پشتیبانی می‌کند. این گزینه تعیین می‌کند کدام قالب فایل هگز استفاده شود. حالت پیش‌فرض inhx32 است. .TP .BR \-c ", "\-\-object تولید یک شیء بازآدرس‌پذیر (قالب جدید COFF). .TP .BR \-C ", "\-\-old\-coff تولید یک شیء بازآدرس‌پذیر (قالب قدیمی COFF). .TP .BR \-d ", " \-\-debug چاپ پیام‌های اشکال‌زدایی. .TP .BR "\-D SYM=VAL", " \-\-define SYM=VAL" تعریف SYM با مقدار VAL. این کار معادل قرار دادن "#define SYM VAL" در کد مبدأ است. .TP .BR "\-e [ON|OFF]", " \-\-expand [ON|OFF]" بسط ماکرو در فایل لیست با استفاده از دستورالعمل‌های EXPAND و NOEXPAND کنترل می‌شود. این گزینه می‌تواند نادیده گرفتن هر یک از این دستورالعمل‌ها را اجبار کند. هنگامی که "ON" انتخاب شود، ماکروها همواره بدون در نظر گرفتن حضور NOEXPAND بسط داده می‌شوند. به همین ترتیب، "OFF" ماکروها را مجبور می‌کند که بسط داده نشوند. .TP .BR \-f ", " \-\-full-address نمایش نشانی کامل در ناحیه نگاشت حافظه درون فایل .lst. .TP .BR \-g ", " \-\-debug-info استفاده از دستورالعمل‌های اشکال‌زدایی برای COFF. .TP .BR \-h ", " \-\-help نمایش پیام راهنما و خروج. .TP .BR \-i ", " \-\-ignore\-case تمام نمادها و ماکروهای تعریف‌شده توسط کاربر به بزرگی و کوچکی حروف حساس هستند. این گزینه آن‌ها را نسبت به بزرگی و کوچکی حروف غیرحساس می‌کند. .TP .BR "\-I DIR", " \-\-include DIR" فایل اسمبلی سطح بالا به عنوان یک آرگومان به gpasm ارسال می‌شود. این فایل می‌تواند حاوی دستورالعمل‌های INCLUDE باشد. این دستورالعمل‌ها فایل مشخص‌شده را باز کرده و سپس محتوای آن اسمبل می‌شود. GPASM این فایل‌ها را در دایرکتوری جاری جستجو می‌کند. اگر فایل پیدا نشد، مسیر پیش‌فرض سرآیند بررسی می‌شود. در نهایت، تمامی مسیرهای مشخص‌شده با این آرگومان جستجو می‌شوند. .TP .BR \-j ", " \-\-sdcc\-dev16\-list کمک به گسترش فایل pic16devices.txt در پروژه sdcc. استفاده مستقل از آن، تمامی دستگاه‌های '16e' را نمایش می‌دهد. همراه با گزینه '\-p'، تنها دستگاه مشخص‌شده را نشان می‌دهد. .TP .BR \-k ", " \-\-error فعال‌سازی ایجاد فایل خطاها. .TP .BR \-l[12[ce]|14[cef]|16[ce]] ", " \-\-list-chips[=([12[ce]|14[cef]|16[ce]])] فهرست کردن پردازنده‌های پشتیبانی‌شده بر اساس جنبه‌های مختلف. (f => x) .TP .BR \-L ", "\-\-force-list نادیده گرفتن دستورالعمل‌های NOLIST. این کار gpasm را وادار می‌کند تا تمامی خطوط اسمبل‌شده را در خروجی فایل لیست چاپ کند. .TP .BR \-m ", "\-\-dump پس از اتمام مرحله نهایی اسمبل، محتویات حافظه دستورالعمل نمایش داده می‌شود. .TP .BR "\-\-mpasm\-compatible" این گزینه حالت سازگاری با MPASM را فعال می‌کند. .TP .BR \-M ", "\-\-deps تولید یک فایل وابستگی. .TP .BR \-n ", "\-\-dos به‌طور پیش‌فرض، gpasm فایل‌های هگز را با استفاده از قالب ISO تولید می‌کند. با این حال، برخی از پروگرامرهای دستگاه به فایلی با قالب DOS نیاز دارند. این گزینه باعث می‌شود gpasm یک فایل هگز با قالب DOS تولید کند. .TP .BR "\-o FILE", " \-\-output FILE" نام جایگزین فایل‌های خروجی. تأثیر گزینه: .ti +0 \-\- اگر گزینه "\-c" در خط فرمان آمده باشد: .ti +3 FILE.o, FILE.lst, FILE.err .ti +3 (باید "FILE.o" مشخص شود.) .ti +0 \-\- اگر گزینه "\-c" در خط فرمان نیامده باشد: .ti +3 FILE.hex, FILE.cod, FILE.lst, FILE.err .ti +3 (باید "FILE.hex" مشخص شود.) .TP .BR "\-p PROC", " \-\-processor PROC" انتخاب پردازنده. .TP .BR "\-P FILE", " \-\-preprocess FILE" نوشتن فایل asm پیش‌پردازش‌شده در FILE. .TP .BR \-q ", "\-\-quiet فرونشاندن هر چیزی که به خروجی استاندارد ارسال می‌شود. .TP .BR "\-r RADIX", " \-\-radix RADIX" مبناهای پشتیبانی‌شده عبارتند از BIN، DEC، OCT و HEX. حالت پیش‌فرض HEX است. .TP .BR "\-s[12[ce]|14[cef]|16[ce]]", .BR "\-\-list\-processor\-properties[=([12[ce]|14[cef]|16[ce]])]" ویژگی‌های پردازنده‌ها را فهرست می‌کند. استفاده مستقل از آن، تمامی دستگاه‌ها یا گروهی از دستگاه‌ها را نمایش می‌دهد. همراه با گزینه '\-p'، تنها دستگاه مشخص‌شده را نشان می‌دهد. (f => x) .TP .BR "\-S [0|1|2]", " \-\-strict [0|1|2]" تنظیم سطح سخت‌گیری برای پارامترهای توصیه‌شدهٔ دستورالعمل‌ها (W یا F و A یا B). «پیام‌های سخت‌گیرانه» اولویت بالاتری نسبت به هشدارها دارند. (ببینید: \-w [0|1|2]) [0] .ti +4 0: مقدار پیش‌فرض است. هیچ پیام سخت‌گیرانه‌ای نمایش داده نمی‌شود. .ti +4 1: در صورت نبود یکی از آن‌ها، پیام هشدار را نمایش می‌دهد. .ti +4 2: در صورت نبود یکی از آن‌ها، پیام خطا را نمایش می‌دهد. .TP .BR \-t ", " \-\-sdcc\-dev14\-list کمک به گسترش فایل pic14devices.txt در پروژه sdcc. استفاده مستقل از آن، تمامی دستگاه‌های '14' و '14e' را نمایش می‌دهد. همراه با گزینه '\-p'، تنها دستگاه مشخص‌شده را نشان می‌دهد. .TP .BR \-\-strict-options اگر این گزینه تنظیم شود، یک گزینه نمی‌تواند پارامتر گزینهٔ دیگری باشد. برای مثال: \-I \-c .TP .BR \-u ", "\-\-absolute استفاده از مسیرهای مطلق. .TP .BR \-v ", "\-\-version نمایش اطلاعات نسخه و خروج. .TP .BR "\-w [0|1|2]", " \-\-warning [0|1|2]" این گزینه سطح پیام را تعیین می‌کند. .ti +4 0: مقدار پیش‌فرض است. اجازه می‌دهد تمامی پیام‌ها، هشدارها و خطاها گزارش شوند. .ti +4 1: پیام‌ها را فرومی‌نشاند. .ti +4 2: پیام‌ها و هشدارها را فرومی‌نشاند. .TP .BR \-X ", "\-\-macro\-dereference استفاده از مبدأیی که ماکرو از آن فراخوانی شده برای گزارش خطاها. .TP .BR \-y ", "\-\-extended فعال‌سازی حالت گسترش‌یافته 18xx. .SH "همچنین ببینید (SEE ALSO)" .BR gputils (1) .SH "نویسندگان (AUTHORS)" Craig Franklin .SH "کپی‌رایت و تکثیر (COPYRIGHT)" Copyright (C) 2002, 2003, 2004, 2005 James Bowman, Craig Franklin این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بالاتری از آن، بازتوزیع کرده و/یا تغییر دهید. این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «پروانه عمومی همگانی گنو» مراجعه کنید. شما باید به همراه این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر مکاتبه کنید: Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.