.Dd Aug 25, 2023
.Dt RZ_DIFF 1
.Sh "نام (NAME)"
.Nm RZ_DIFF
.Nd مقایسه فایل‌ها و یافتن تفاوت‌های باینری.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm rz-diff
.B rz-diff
[\fIOPTIONS\fR]
\fIfile0\fR
\fIfile1\fR
.Sh "توضیحات (DESCRIPTION)"
ابزار rz-diff دو فایل یا برنامه باینری را مقایسه کرده و تفاوت‌های میان آن‌ها را برجسته می‌سازد. این ابزار بر اساس گزینه‌های به‌کاررفته، از مقایسه جنبه‌های گوناگون مانند بایت‌های خام، خطوط متنی، توابع، بخش‌ها (sections)، رشته‌ها و غیره پشتیبانی می‌کند.
.Pp
.Bl -tag -width Fl
.It Fl A
مقایسه آدرس‌های مجازی از file0 با آدرس‌های فیزیکی در file1
.It Fl a Ar [arch]	
مشخص کردن پلاگین معماری مورد استفاده برای تحلیل (مانند x86، arm)
.It Fl b Ar [bits]
مشخص کردن اندازه ثبات‌ها (register size) برای معماری انتخاب‌شده (مانند 16، 32، 64)
.It Fl B
اجرای دستور 'aaa' هنگام بارگذاری باینری
.It Fl C
غیرفعال کردن استفاده از رنگ‌ها در خروجی
.It Fl d Ar [algo]
محاسبه فاصله ویرایشی (edit distance) میان فایل‌ها با استفاده از الگوریتم انتخابی:
.Bl -tag -width
.It Ic myers
الگوریتم O(ND) یوجین دبلیو. مایرز (Eugene W. Myers) (بدون جایگزینی)
.It Ic leven
الگوریتم O(N^2) لون‌اشتاین (Levenshtein) (با جایگزینی)
.It Ic ssdeep
مقایسه درهم‌سازی تکه‌ای مبتنی بر متن (Context triggered piecewise hashing)
.El
.It Fl e Ar [k=v]
تنظیم یک متغیر پیکربندی قابل ارزیابی
.It Fl H 
فعال کردن حالت بصری هگزادسیمال برای مقایسه فایل‌ها در قالب شانزده‌شانزدهی
.It Fl h
نمایش پیام راهنما
.It Fl i 
استفاده از آرگومان‌های خط فرمان به جای فایل‌ها (تنها برای ‎-d)
.It Fl j
ارائه نتایج مقایسه در قالب JSON
.It Fl q
تولید خروجی بی‌صدا با حداقل اطلاعات
.It Fl 0 Ar [cmd]
ورودی برای file0 در صورت مشخص شدن گزینه ‎-t 'commands'
.It Fl 1 Ar [cmd]
ورودی برای file1 در صورت مشخص شدن گزینه ‎-t 'commands'
.It Fl S Ar [WxH]
تنظیم عرض و ارتفاع ترمینال برای حالت بصری
.It Fl t Ar [type]
محاسبه تفاوت میان دو فایل بر اساس نوع مشخص‌شده:
.Bl -tag -width
.It Ic bytes
مقایسه بایت‌های خام در فایل‌ها (تنها برای فایل‌های کوچک)
.It Ic lines
مقایسه فایل‌های متنی
.It Ic functions
مقایسه توابع یافت‌شده در فایل‌ها
.It Ic classes
مقایسه کلاس‌های یافت‌شده در فایل‌ها
.It Ic command
مقایسه خروجی فرمانی که هنگام اجرا روی هر دو فایل بازگردانده می‌شود.
نیاز به ‎-0 <cmd>‎ دارد؛ ‎-1 <cmd>‎ اختیاری است.
.It Ic entries
مقایسه مدخل‌های (entries) یافت‌شده در فایل‌ها
.It Ic fields
مقایسه فیلدهای یافت‌شده در فایل‌ها
.It Ic graphs
مقایسه ۲ تابع و ارائه خروجی در قالب graphviz/dot.
نیاز به ‎-0 <fcnname|offset>‎ دارد؛ ‎-1 <fcn name|offset>‎ اختیاری است.
.It Ic imports
مقایسه واردات (imports) یافت‌شده در فایل‌ها
.It Ic libraries
مقایسه کتابخانه‌های یافت‌شده در فایل‌ها
.It Ic sections
مقایسه بخش‌های (sections) یافت‌شده در فایل‌ها
.It Ic strings
مقایسه رشته‌های یافت‌شده در فایل‌ها
.It Ic symbols
مقایسه نمادهای (symbols) یافت‌شده در فایل‌ها
.El
.It Fl T
نمایش اطلاعات برچسب زمانی در خروجی
.It Fl V
نمایش اطلاعات نسخه rz-diff
.It Fl v
پرگویی بیشتر در خروجی (خروجی stderr)
.El
.Pp 
رنگ‌های پالت را می‌توان با افزودن خطوط زیر درون فایل $HOME/.rizinrc تغییر داد:
.Bl -tag
.It Ic ec diff.unknown blue
رنگ آفست
.It Ic ec diff.match green
رنگ مطابقت‌ها
.It Ic ec diff.unmatch red
رنگ عدم‌مطابقت‌ها	
.El
.Sh "مثال‌ها (EXAMPLES)"
.Pp
مقایسه دو فایل باینری با استفاده از تنظیمات پیش‌فرض:
.Pp
.Nm rz-diff Ar file1.bin Ar file2.bin
.Pp
مقایسه دو فایل متنی و نمایش خروجی در قالب JSON:
.Pp
.Nm rz-diff Fl j Fl t Cm lines Ar file1.txt Ar file2.txt
.Pp
مقایسه دو تابع از یک پلاگین معماری:
.Pp
.Nm rz-diff Fl t Cm graphs Fl 0 Cm function1 Fl 1 Cm function2 Ar binary1 Ar binary2
.Sh "همچنین ببینید (SEE ALSO)"
.Pp
.Xr rizin(1) ,
.Xr rz-find(1) ,
.Xr rz-hash(1) ,
.Xr rz-bin(1) ,
.Xr rz-asm(1) ,
.Xr rz-gg(1) ,
.Xr rz-run(1) ,
.Xr rz-ax(1) ,
.Sh "نویسندگان (AUTHORS)"
.Pp
pancake <pancake@nopcode.org>
.It  
byteninjaa0