نام (NAME)

llvm-mc - محیط آزمایش و پردازش کُد ماشین LLVM

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

llvm-mc [options] [filename]

توضیحات (DESCRIPTION)

دستور llvm-mc کُد اسمبلی را برای یک معماری تعیین‌شده به عنوان ورودی دریافت کرده و یک فایل شیء (object file) یا فایل اجرایی تولید می‌کند.

دستور llvm-mc مجموعه‌ای از ابزارها را برای کار با کُد ماشین فراهم می‌آورد؛ از جمله کدگذاری دستورالعمل‌ها و نمایش بازنمودهای داخلی آن‌ها، دیزاسمبل کردن رشته‌ها به بایت‌ها و غیره.

انتخاب معماری برای کُد اسمبلی خروجی به‌طور خودکار از فایل ورودی تعیین می‌شود، مگر اینکه از گزینهٔ --arch برای لغو و جایگزینی مقدار پیش‌فرض استفاده شود.

گزینه‌ها (OPTIONS)

چنانچه گزینهٔ -o مشخص نشود، در صورتی که ورودی از ورودی استاندارد خوانده شود، llvm-mc خروجی خود را به خروجی استاندارد ارسال خواهد کرد. اگر برای گزینهٔ -o مقدار "-" تعیین شود، خروجی باز هم به خروجی استاندارد فرستاده خواهد شد.

اگر هیچ گزینهٔ -o مشخص نشده باشد و فایلی ورودی غیر از "-" تعیین شده باشد، llvm-mc نام فایل خروجی را از روی نام فایل ورودی، با حذف هرگونه پسوند .s موجود و افزودن پسوند .o ایجاد می‌کند.

سایر گزینه‌های llvm-mc در ادامه شرح داده شده‌اند.

گزینه‌های کاربر نهایی

--help: نمایش گزینه‌های موجود (برای گزینه‌های بیشتر از --help-hidden استفاده کنید).

-o <filename>: استفاده از <filename> به عنوان نام فایل خروجی. برای جزئیات بیشتر به خلاصهٔ بالا مراجعه کنید.

--arch=<string>: معماری مقصد برای اسمبل کردن؛ برای مشاهدهٔ اهداف در دسترس -version را ببینید.

--as-lex: اعمال تحلیل‌گر لغوی ("lexer") اسمبلر برای شکستن ورودی به توکن‌ها و چاپ هر یک از آن‌ها. این گزینه برای کمک به توسعه و آزمایش پیاده‌سازی یک اسمبلر در نظر گرفته شده است.

--assemble: اسمبل کردن فایل اسمبلی (پیش‌فرض) و چاپ نتیجه به صورت اسمبلی. این گزینه برای طراحی و آزمایش پارسرهای دستورالعمل کاربرد دارد و در صورت ترکیب با سایر پرچم‌های llvm-mc می‌تواند ابزار مفیدی باشد. برای مثال، این گزینه برای تبدیل کُد اسمبلی میان گویش‌های مختلف کاربردی است؛ مثلاً در معماری Intel که می‌توانید از -output-asm-variant=1 برای ترجمه از نحو AT&T به نحو اسمبلی Intel استفاده کنید. همچنین می‌توان آن را با --show-encoding ترکیب کرد تا چگونگی کدگذاری دستورالعمل‌ها مشخص شود.

--disassemble: تجزیهٔ یک رشته از بایت‌های هگزادسیمال و چاپ نتیجه به صورت نحو اسمبلی.

--mdis: دیزاسمبلِ نشانه‌گذاری‌شدهٔ رشته‌ای از بایت‌های هگزادسیمال.

--cdis: دیزاسمبلِ رنگیِ رشته‌ای از بایت‌های هگزادسیمال.

--filetype=[asm,null,obj]: نوع فایل خروجی را تعیین می‌کند. تنظیم این پرچم روی asm خروجی ابزار را به صورت متن اسمبلی تولید می‌کند. تنظیم آن روی obj موجب ایجاد یک فایل شیء (object file) می‌شود. تنظیم آن روی null مانع از ایجاد هرگونه خروجی می‌شود و می‌تواند برای اهداف زمان‌سنجی استفاده شود. مقدار پیش‌فرض asm است.

-g: تولید اطلاعات اشکال‌زدایی DWARF برای فایل‌های منبع اسمبلی.

--hex: دریافت بایت‌های خام هگزادسیمال به عنوان ورودی برای دیزاسمبل. فاصله‌های خالی نادیده گرفته می‌شوند.

--large-code-model: ایجاد دستورالعمل‌های CFI با این فرض که حجم کُد ممکن است بیش از ۲ گیگابایت باشد.

--main-file-name=<string>: مشخص کردن نامی که باید برای فایل ورودی در نظر گرفته شود.

--masm-hexfloats: فعال‌سازی مقداردهنده‌های اولیهٔ اعشاری هگزادسیمال به سبک MASM مانند (3F800000r).

-mattr=a1,+a2,-a3,...
ویژگی‌های خاص معماری مقصد (برای جزئیات بیشتر: -mattr=help).

--mcpu=<cpu-name>: هدف‌گذاری یک نوع پردازندهٔ خاص (برای جزئیات بیشتر: -mcpu=help).

--triple=<string>: سه‌گانهٔ مقصد (Target triple) برای اسمبل کردن؛ برای اهداف موجود -version را ببینید.

--split-dwarf-file=<filename>: نام فایل خروجی DWO.

--show-inst-operands: نمایش عملوندهای دستورالعمل‌ها به همان صورت که تجزیه شده‌اند.

--show-inst: نمایش بازنمود داخلی دستورالعمل.

--show-encoding: نمایش کدگذاری‌های دستورالعمل.

--save-temp-labels: برچسب‌های موقت دور ریخته نشوند.

--relax-relocations: تولید R_X86_64_GOTPCRELX به جای R_X86_64_GOTPCREL.

--print-imm-hex: ترجیح دادن قالب هگزادسیمال برای مقادیر فوری (immediate values).

--preserve-comments: حفظ توضیحات (کامنت‌ها) در اسمبلی خروجی.

--output-asm-variant=<uint>: گونهٔ نحو مورد استفاده برای چاپ در خروجی. برای نمونه، در اهداف x86 گزینهٔ --output-asm-variant=0 خروجی را با نحو AT&T و --output-asm-variant=1 خروجی را با نحو Intel/MASM چاپ می‌کند.

--compress-debug-sections=[none|zlib|zstd]: انتخاب نوع فشرده‌سازی بخش‌های اشکال‌زدایی DWARF.

وضعیت خروج (EXIT STATUS)

اگر llvm-mc با موفقیت به پایان برسد، با مقدار 0 خارج خواهد شد. در غیر این صورت، در صورت بروز خطا، با مقداری غیر از صفر خارج می‌شود.

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

توسط تیم LLVM نگهداری می‌شود (https://llvm.org).

کپی‌رایت و تکثیر (COPYRIGHT)

2003-2026, LLVM Project

2026-07-15