نام (NAME)

shake512sum - محاسبه و بررسی چکیده‌های پیام SHAKE512

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

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

توضیحات (DESCRIPTION)

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

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