.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LLVM-MC" "1" "2026-07-15" "22" "LLVM"
.SH "نام (NAME)"
llvm-mc \- محیط آزمایش و پردازش کُد ماشین LLVM
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBllvm\-mc\fP [\fIoptions\fP] [\fIfilename\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBllvm\-mc\fP کُد اسمبلی را برای یک معماری تعیین‌شده به عنوان ورودی دریافت کرده و یک فایل شیء (object file) یا فایل اجرایی تولید می‌کند.
.sp
دستور \fBllvm\-mc\fP مجموعه‌ای از ابزارها را برای کار با کُد ماشین فراهم می‌آورد؛ از جمله کدگذاری دستورالعمل‌ها و نمایش بازنمودهای داخلی آن‌ها، دیزاسمبل کردن رشته‌ها به بایت‌ها و غیره.
.sp
انتخاب معماری برای کُد اسمبلی خروجی به‌طور خودکار از فایل ورودی تعیین می‌شود، مگر اینکه از گزینهٔ \fB\-\-arch\fP برای لغو و جایگزینی مقدار پیش‌فرض استفاده شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
چنانچه گزینهٔ \fB\-o\fP مشخص نشود، در صورتی که ورودی از ورودی استاندارد خوانده شود، \fBllvm\-mc\fP خروجی خود را به خروجی استاندارد ارسال خواهد کرد. اگر برای گزینهٔ \fB\-o\fP مقدار \(dq\fB\-\fP\(dq تعیین شود، خروجی باز هم به خروجی استاندارد فرستاده خواهد شد.
.sp
اگر هیچ گزینهٔ \fB\-o\fP مشخص نشده باشد و فایلی ورودی غیر از \(dq\fB\-\fP\(dq تعیین شده باشد، \fBllvm\-mc\fP نام فایل خروجی را از روی نام فایل ورودی، با حذف هرگونه پسوند \fB\&.s\fP موجود و افزودن پسوند \fB\&.o\fP ایجاد می‌کند.
.sp
سایر گزینه‌های \fBllvm\-mc\fP در ادامه شرح داده شده‌اند.
.SS "گزینه‌های کاربر نهایی"
.INDENT 0.0
.TP
.B \-\-help
نمایش گزینه‌های موجود (برای گزینه‌های بیشتر از \-\-help\-hidden استفاده کنید).
.UNINDENT
.INDENT 0.0
.TP
.B \-o <filename>
استفاده از \fB<filename>\fP به عنوان نام فایل خروجی. برای جزئیات بیشتر به خلاصهٔ بالا مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-arch=<string>
معماری مقصد برای اسمبل کردن؛ برای مشاهدهٔ اهداف در دسترس \-version را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-as\-lex
اعمال تحلیل‌گر لغوی (\(dqlexer\(dq) اسمبلر برای شکستن ورودی به توکن‌ها و چاپ هر یک از آن‌ها. این گزینه برای کمک به توسعه و آزمایش پیاده‌سازی یک اسمبلر در نظر گرفته شده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-assemble
اسمبل کردن فایل اسمبلی (پیش‌فرض) و چاپ نتیجه به صورت اسمبلی. این گزینه برای طراحی و آزمایش پارسرهای دستورالعمل کاربرد دارد و در صورت ترکیب با سایر پرچم‌های llvm\-mc می‌تواند ابزار مفیدی باشد. برای مثال، این گزینه برای تبدیل کُد اسمبلی میان گویش‌های مختلف کاربردی است؛ مثلاً در معماری Intel که می‌توانید از \-output\-asm\-variant=1 برای ترجمه از نحو AT&T به نحو اسمبلی Intel استفاده کنید. همچنین می‌توان آن را با \-\-show\-encoding ترکیب کرد تا چگونگی کدگذاری دستورالعمل‌ها مشخص شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-disassemble
تجزیهٔ یک رشته از بایت‌های هگزادسیمال و چاپ نتیجه به صورت نحو اسمبلی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mdis
دیزاسمبلِ نشانه‌گذاری‌شدهٔ رشته‌ای از بایت‌های هگزادسیمال.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cdis
دیزاسمبلِ رنگیِ رشته‌ای از بایت‌های هگزادسیمال.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-filetype=[asm,null,obj]
نوع فایل خروجی را تعیین می‌کند. تنظیم این پرچم روی \fIasm\fP خروجی ابزار را به صورت متن اسمبلی تولید می‌کند. تنظیم آن روی \fIobj\fP موجب ایجاد یک فایل شیء (object file) می‌شود. تنظیم آن روی \fInull\fP مانع از ایجاد هرگونه خروجی می‌شود و می‌تواند برای اهداف زمان‌سنجی استفاده شود. مقدار پیش‌فرض \fIasm\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-g
تولید اطلاعات اشکال‌زدایی DWARF برای فایل‌های منبع اسمبلی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-hex
دریافت بایت‌های خام هگزادسیمال به عنوان ورودی برای دیزاسمبل. فاصله‌های خالی نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-large\-code\-model
ایجاد دستورالعمل‌های CFI با این فرض که حجم کُد ممکن است بیش از ۲ گیگابایت باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-main\-file\-name=<string>
مشخص کردن نامی که باید برای فایل ورودی در نظر گرفته شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-masm\-hexfloats
فعال‌سازی مقداردهنده‌های اولیهٔ اعشاری هگزادسیمال به سبک MASM مانند (3F800000r).
.UNINDENT
.INDENT 0.0
.TP
.B \-mattr=a1,+a2,\-a3,...
.TP
.B ویژگی‌های خاص معماری مقصد (برای جزئیات بیشتر: \-mattr=help).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mcpu=<cpu\-name>
هدف‌گذاری یک نوع پردازندهٔ خاص (برای جزئیات بیشتر: \-mcpu=help).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-triple=<string>
سه‌گانهٔ مقصد (Target triple) برای اسمبل کردن؛ برای اهداف موجود \-version را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-split\-dwarf\-file=<filename>
نام فایل خروجی DWO.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-show\-inst\-operands
نمایش عملوندهای دستورالعمل‌ها به همان صورت که تجزیه شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-show\-inst
نمایش بازنمود داخلی دستورالعمل.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-show\-encoding
نمایش کدگذاری‌های دستورالعمل.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-save\-temp\-labels
برچسب‌های موقت دور ریخته نشوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-relax\-relocations
تولید R_X86_64_GOTPCRELX به جای R_X86_64_GOTPCREL.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-print\-imm\-hex
ترجیح دادن قالب هگزادسیمال برای مقادیر فوری (immediate values).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-preserve\-comments
حفظ توضیحات (کامنت‌ها) در اسمبلی خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-asm\-variant=<uint>
گونهٔ نحو مورد استفاده برای چاپ در خروجی. برای نمونه، در اهداف x86 گزینهٔ \-\-output\-asm\-variant=0 خروجی را با نحو AT&T و \-\-output\-asm\-variant=1 خروجی را با نحو Intel/MASM چاپ می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-compress\-debug\-sections=[none|zlib|zstd]
انتخاب نوع فشرده‌سازی بخش‌های اشکال‌زدایی DWARF.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
اگر \fBllvm\-mc\fP با موفقیت به پایان برسد، با مقدار 0 خارج خواهد شد. در غیر این صورت، در صورت بروز خطا، با مقداری غیر از صفر خارج می‌شود.
.SH "نویسندگان (AUTHORS)"
توسط تیم LLVM نگهداری می‌شود (https://llvm.org).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2003-2026, LLVM Project
.\" End of generated man page.