.Dd Jan 24, 2024
.Dt RZ_HASH 1
.Sh "نام (NAME)"
.Nm rz-hash
.Nd ابزار محاسبه هش بر پایه بلوک
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm rz-hash
.Op Fl vhBkjLq
.Op Fl a Ar algorithm
.Op Fl b Ar size
.Op Fl c Ar hash
.Op Fl D Ar algo
.Op Fl E Ar algo
.Op Fl s Ar string
.Op Fl x Ar hexstr
.Op Fl f Ar from
.Op Fl t Ar to
.Op Fl c Ar hash
.Op [file] ...
.Sh "توضیحات (DESCRIPTION)"
این برنامه بخشی از پروژه Rizin است.
.Pp
دستور
.Nm rz-hash
به شما امکان می‌دهد مقادیر هش هر بلوک از فایل هدف را محاسبه، بررسی و نمایش دهید. اندازه پیش‌فرض هر بلوک ۳۲۷۶۸ بایت است. با استفاده از '-' به عنوان فایل هدف، امکان محاسبه هش از stdin نیز مجاز است. می‌توانید مقدار محاسبه‌شده را با یک هش مشخص مقایسه کرده و نتیجه را در وضعیت خروج (exit status) دریافت کنید.
.Pp
می‌توانید فایل‌های بزرگ را با محاسبه هش هر بلوک، هش کنید و بعداً مشخص نمایید کدام بخش از آن تغییر یافته است. این قابلیت برای تحلیل سامانه‌های پرونده (فایل‌سیستم) مفید است.
.Pp
این دستور می‌تواند برای محاسبه هش بخش مشخصی از یک فایل یا یک رشته متنی ارسال‌شده از خط فرمان استفاده شود.
.Pp
این همان دستوری است که توسط دستور 'ph' در rizin استفاده می‌شود.
.Bl -tag -width Fl
.It Fl v
نمایش اطلاعات نسخه
.It Fl h
نمایش پیام راهنمای نحوه استفاده
.It Fl 
خواندن ورودی از stdin به جای فایل
.It Fl a Ar algo
الگوریتم هش مورد استفاده؛ می‌توانید با افزودن کاما چندین الگوریتم را مشخص کنید (مثال: sha1,md4,md5,sha256)
.It Fl B
خروجی دادن مقدار محاسبه‌شده برای هر بلوک
.It Fl b Ar size
تنظیم اندازه بلوک
.It Fl c Ar value
مقایسه مقدار محاسبه‌شده با یک مقدار داده‌شده (هگزادسیمال)
.It Fl e Ar endian
تنظیم ترتیب بایت‌ها (اندیان) (پیش‌فرض: 'big'؛ مقادیر مجاز: 'big' یا 'little')
.It Fl D Ar algo
رمزگشایی ورودی داده‌شده؛ از
.Fl S
برای تنظیم کلید و از
.Fl I
برای تنظیم IV (در صورت نیاز) استفاده کنید
.It Fl E Ar algo
رمزنگاری ورودی داده‌شده؛ از
.Fl S
برای تنظیم کلید و از
.Fl I
برای تنظیم IV (در صورت نیاز) استفاده کنید
.It Fl f Ar from
شروع محاسبه از آفست داده‌شده
.It Fl t Ar to
توقف محاسبه در آفست داده‌شده
.It Fl I Ar iv
تنظیم بردار مقداردهی اولیه (IV)
.It Fl i Ar times
تکرار محاسبه به تعداد N بار
.It Fl j
خروجی دادن نتیجه در قالب ساختار JSON
.It Fl k
خروجی دادن مقدار محاسبه‌شده با استفاده از الگوریتم randomkey در openssh
.It Fl L
فهرست کردن تمام الگوریتم‌ها
.It Fl q
حالت بی‌صدا (استفاده از
.Fl qq
برای دریافت تنها مقدار محاسبه‌شده)
.It Fl S Ar seed
تنظیم سید (seed) برای
.Fl a Ns
؛ استفاده از '^' برای افزودن آن پیش از ورودی. از پیشوند '@' برای بارگذاری از یک فایل و '-' برای خواندن آن استفاده کنید
.It Fl K Ar key
تنظیم کلید HMAC برای
.Fl a
و کلید برای
.Fl E Ns / Ns Fl D Ns .
استفاده از پیشوند '@' برای بارگذاری از یک فایل و '-' برای خواندن آن از stdin (می‌توانید آن‌ها را ترکیب کنید)
.It Fl s Ar string
خواندن ورودی از یک رشته پایان‌یافته با صفر (zero-terminated) به جای فایل
.It Fl x Ar hex
خواندن ورودی از یک مقدار هگزادسیمال به جای فایل
.Pp
تمامی ورودی‌ها (به جز
.Fl s Ns / Ns Fl x Ns / Ns Fl c Ns
) در صورت تعیین پیشوند 's:' می‌توانند به صورت هگزادسیمال یا رشته باشند.
.El
.Sh "عیب‌یابی (DIAGNOSTICS)"
.Ex -std
.Pp
هنگام استفاده از
.Fl c Ns
، وضعیت خروج ۰ نشان‌دهنده تطابق هش مورد انتظار با هش محاسبه‌شده است.
.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-asm(1) ,
.Xr rz-gg(1) ,
.Xr rz-run(1) ,
.Xr rz-ax(1) ,
.Sh "نویسندگان (AUTHORS)"
.Pp
pancake <pancake@nopcode.org>
.Pp
byteninjaa0