نام (NAME)

rawshake512sum - محاسبه و بررسی چکیده‌های پیام RawSHAKE512

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

rawshake512sum [-u | -l | -b | -c] [-R rate] [-C capacity] [-N output-size] [-S state-size] [-W word-size] [-Z squeeze-count] [-vxz] [file ...]

توضیحات (DESCRIPTION)

چاپ یا بررسی چکامه‌های RawSHAKE512. در صورت مشخص نشدن فایل یا هنگامی که فایل - باشد، ورودی استاندارد خوانده می‌شود.

-u: نمایش چکامه‌ها در قالب هگزادسیمال با حروف بزرگ.
-l: نمایش چکامه‌ها در قالب هگزادسیمال با حروف کوچک. (پیش‌فرض)
-b: نمایش چکامه‌ها در قالب باینری (دودویی). این گزینه از نمایش نام فایل‌ها و جداکننده‌های چکامه جلوگیری می‌کند؛ تنها چکامه‌ها چاپ می‌شوند.
-c: خواندن مقادیر RawSHAKE512 از فایل و بررسی آن‌ها در مقایسه با فایل‌های موجود در سامانه. فایل‌های ورودی باید مانند خروجی این برنامه یا مشابه آن قالب‌بندی شده باشند. اگر نام فایلی در فایل ورودی با یک فاصلهٔ معمولی یا تب افقی آغاز شود، یا شامل line feed، carriage return یا form feed باشد، این دستور کار نخواهد کرد؛ مگر اینکه گزینهٔ -z نیز استفاده شود.
-v: چاپ پارامترهای درهم‌سازی.
-x: تبدیل فایل‌های ورودی از حالت هگزادسیمال به حالت باینری پیش از محاسبهٔ چکامه‌ها.
-z: خطوط به جای LF با NUL پایان می‌یابند. در صورت استفاده همراه با -c، این مورد روی فایل‌های خوانده‌شده اعمال می‌شود (نه خروجی)، اما همچنین تجزیهٔ دقیق‌تری اعمال کرده و اجازهٔ وجود هرگونه فاصله خالی (whitespace) در نام فایل‌ها را می‌دهد.

گزینه‌های زیر پارامترهای درهم‌سازی را تغییر می‌دهند:

-R rate: تغییر نرخ (rate).
-C capacity: تغییر ظرفیت (capacity).
-N, -O output-size: تغییر اندازهٔ خروجی.
-S, -B state-size: تغییر اندازهٔ وضعیت (state size).
-W word-size: تغییر اندازهٔ کلمه (word size).
-Z squeeze-count: تغییر تعداد دفعات فشردن (squeeze) انجام‌شده.

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

0: پایان موفقیت‌آمیز.
1: چکامه‌ها همخوانی نداشتند یا فایلی وجود نداشت.
2: خطایی رخ داد.

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

Mattias Andrée <m@maandree.se>

نکات (NOTES)

تمام دستورهای بستهٔ sha3sum اجازهٔ تغییر پارامترهای درهم‌سازی را می‌دهند. با این وجود، این قابلیت تنها برای استفاده با keccaksum(1) در نظر گرفته شده است، یا در صورتی که بدانید دقیقاً چه کاری انجام می‌دهید؛ به استثنای -N که در نظر گرفته شده تا همیشه همراه با shake128sum(1)، shake256sum(1)، shake512sum(1)، rawshake128sum(1)، rawshake256sum(1) و rawshake512sum(1) استفاده شود.