نام (NAME)

rawshake256sum - محاسبه و بررسی خلاصه‌پیام‌های RawSHAKE256

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

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

توضیحات (DESCRIPTION)

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

-u: نمایش چکسام‌ها در قالب هگزادسیمال با حروف بزرگ.
-l: نمایش چکسام‌ها در قالب هگزادسیمال با حروف کوچک. (پیش‌فرض)
-b: نمایش چکسام‌ها در قالب دودویی (باینری). این گزینه از نمایش نام فایل‌ها و جداکننده‌های چکسام جلوگیری می‌کند و تنها چکسام‌ها چاپ می‌شوند.
-c: خواندن چکسام‌های RawSHAKE256 از فایل و بررسی آن‌ها در برابر فایل‌های موجود در سیستم شما. قالب فایل‌های ورودی باید همانند خروجی این برنامه یا مشابه آن باشد. در صورتی که هر یک از نام فایل‌ها در فایل ورودی با یک فاصله معمولی یا تب افقی آغاز شود، یا حاوی تعویض خط (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) استفاده شود.