.Dd Jan 22, 2024
.Dt RZ_ASM 1
.Sh "نام (NAME)"
.Nm rz-asm
.Nd ابزار اسمبلر و دی‌اسمبلر rizin
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm rz-asm
.Op Fl ABCdDeIEhjLpqrvxw
.Op Fl a Ar arch
.Op Fl b Ar bits
.Op Fl m Ar plugin
.Op Fl c Ar CPU
.Op Fl O Ar file
.Op Fl o Ar addr
.Op Fl @ Ar addr
.Op Fl f Ar file
.Op Fl F Ar in:out
.Op Fl i Ar len
.Op Fl k Ar kernel
.Op Fl s Ar syntax
.Op Fl l Ar len
.Sh "توضیحات (DESCRIPTION)"
این دستور بخشی از پروژه Rizin است.
.Pp
این ابزار از RzAsm برای اسمبل و دی‌اسمبل کردن فایل‌ها یا رشته‌های جفت‌هگز (hexpair) استفاده می‌کند. این ابزار از فهرست بزرگی از معماری‌ها پشتیبانی می‌کند که می‌توان با استفاده از پرچم \-L آن‌ها را مشاهده کرد.
.Pp
.Bl -tag -width Fl
.It Fl a Ar arch
تنظیم معماری برای اسمبل/دی‌اسمبل (مشاهدهٔ -L)
.It Fl A
نمایش اطلاعات تحلیل از جفت‌هگزهای داده‌شده
.It Fl b Ar bits
تنظیم اندازه ثبات CPU (8, 16, 32, 64) (RZ_ASM_BITS)
.It Fl B
ورودی/خروجی باینری (گزینه -l برای ورودی باینری الزامی است)
.It Fl c Ar CPU
انتخاب CPU مشخص (بسته به معماری)
.It Fl C
خروجی در قالب زبان C
.It Fl d, D
دی‌اسمبل از بایت‌های جفت‌هگز (-D جفت‌هگزها را نشان می‌دهد)
.It Fl e
استفاده از big endian به جای little endian
.It Fl I
نمایش کد ارتقایافته‌ی RzIL (ورودی مشابه با -d، کد IL نیز اعتبارسنجی می‌شود)
.It Fl E
نمایش عبارت ESIL (ورودی مشابه با -d)
.It Fl f Ar file
خواندن داده‌ها از فایل
.It Fl F Ar in:out
مشخص کردن فیلترهای ورودی و/یا خروجی (att2intel، x86.pseudo و ...)
.It Fl h, hh
نمایش پیام راهنما؛ hh برای راهنمای مفصل
.It Fl i Ar len
نادیده گرفتن N بایت از بافر ورودی
.It Fl j
خروجی در قالب JSON
.It Fl k Ar kernel
انتخاب سیستم‌عامل (linux، windows، darwin و ...)
.It Fl l Ar len
طول ورودی/خروجی
.It Fl L
فهرست کردن پلاگین‌های asm: (a=asm, d=disasm, A=analyze, e=ESIL)
.It Fl m Ar plugin
فهرست کردن پردازنده‌های پشتیبانی‌شده برای پلاگین انتخاب‌شده
.It Fl o, @ Ar addr
تنظیم آدرس آغازین کد (پیش‌فرض 0)
.It Fl O Ar file
نام فایل خروجی (rz-asm -Bf a.asm -O a)
.It Fl p
اجرای SPP روی ورودی برای اسمبل
.It Fl q
حالت بی‌صدا
.It Fl r
خروجی در قالب دستورهای rizin
.It Fl s Ar syntax
انتخاب نحو (intel، att)
.It Fl v
نمایش اطلاعات نسخه
.It Fl x
استفاده از dwordهای هگزادسیمال به جای جفت‌هگزها هنگام اسمبل
.It Fl w
توصیف آپ‌کد (opcode)
.El
.Sh "رهنمودها (DIRECTIVES)"
.Pp
.Bl -tag -width
.It Ic .intel_syntax
استفاده از نحو Intel به جای AT&T
.It Ic .att_syntax
استفاده از نحو AT&T به جای Intel
.It Ic .align Ar number
تنظیم تراز (alignment) کد یا داده
.It Ic .arch Ar name
تنظیم معماری کد
.It Ic .arm
تنظیم حالت ARM (در مقابل Thumb) برای معماری ARM
.It Ic .ascii Ar string
تعریف رشته ASCII
.It Ic .asciz Ar string
تعریف رشته ASCII ختم‌شده به صفر
.It Ic .bits Ar number
تعریف بیتی بودن (bitness) کد
.It Ic .big_endian
تنظیم ترتیب بایت به صورت BE (big endian)
.It Ic .cpu Ar name
تنظیم CPU برای معماری انتخاب‌شده
.It Ic .data
مشخص کردن آغاز بخش داده (data section)
.It Ic .endian Ar 1|0
تنظیم ترتیب بایت (endianness) \- عدد 1 برای BE و 0 برای LE
.It Ic .equ Ar name Ar value
تعریف مقدار ثابت
.It Ic .fill Ar repeat,size,value
پر کردن داده با الگوی تکرارشونده مقدار
.It Ic .hex Ar data
تعریف داده‌ها در قالب هگزادسیمال
.It Ic .incbin Ar filename
گنجاندن فایل باینری
.It Ic .int16 Ar number
تعریف عدد صحیح ۱۶ بیتی
.It Ic .int32 Ar number
تعریف عدد صحیح ۳۲ بیتی
.It Ic .int64 Ar number
تعریف عدد صحیح ۶۴ بیتی
.It Ic .kernel Ar name
تنظیم هسته برای فراخوان‌های سیستمی (syscalls)
.It Ic .little_endian
تنظیم ترتیب بایت به صورت LE (little endian)
.It Ic .org Ar value
تنظیم مقدار ثبات شمارنده برنامه (PC)
.It Ic .os Ar name
تنظیم سیستم‌عامل برای فراخوان‌های سیستمی (syscalls)
.It Ic .short Ar number
تعریف عدد صحیح ۱۶ بیتی
.It Ic .string Ar string
تعریف رشته ASCII
.It Ic .text
مشخص کردن آغاز بخش کد (text section)
.It Ic .thumb
تنظیم حالت Thumb (در مقابل ARM) برای معماری ARM
.El
.Sh "محیط (ENVIRONMENT)"
.Pp
RZ_ARCH:      e asm.arch \- معماری برای اسمبل/دی‌اسمبل (مشابه با rz-asm -a)
.Pp
RZ_ASM_ARCH:  معماری برای اسمبل/دی‌اسمبل (مشابه با rz-asm -a)
.Pp
RZ_ASM_BITS:  اندازه ثبات پردازنده (8, 16, 32, 64) (مشابه با rz-asm -b)
.Pp
RZ_BITS:      e asm.bits \- اندازه ثبات پردازنده (8, 16, 32, 64) (مشابه با rz-asm -b)
.Pp
RZ_DEBUG:     در صورت تعریف، نمایش پیام‌های خطا و سیگنال کرش
.Pp
RZ_NOPLUGINS: عدم بارگذاری پلاگین‌های اشتراکی (افزایش سرعت بارگذاری)
.Sh "مثال‌ها (EXAMPLES)"
.Pp
اسمبل کردن آپ‌کد:
.Pp
.Nm rz-asm Fl a Cm x86 Fl b Cm 32 Ar 'mov eax, 33'
.Pp
دی‌اسمبل کردن آپ‌کد:
.Pp
.Nm rz-asm Fl d Cm 90
.Sh "همچنین ببینید (SEE ALSO)"
.Pp
.Xr rizin 1 ,
.Xr rz-find 1 ,
.Xr rz-hash 1 ,
.Xr rz-bin 1 ,
.Xr rz-diff 1 ,
.Xr rz-gg 1 ,
.Xr rz-run 1 ,
.Xr rz-ax 1
.Sh "نویسندگان (AUTHORS)"
.Pp
pancake <pancake@nopcode.org>
.Pp
byteninjaa0