نام (NAME)

rawshake128sum - محاسبه و بررسی چکیده‌های پیام RawSHAKE128

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

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

توضیحات (DESCRIPTION)

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

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

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

-R rate: تغییر دادن rate.
-C capacity: تغییر دادن capacity.
-N, -O output-size: تغییر دادن اندازه خروجی (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) استفاده شود.