نام (NAME)

sha3-256sum - محاسبه و بررسی خلاصه‌پیام‌های SHA3-256

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

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

توضیحات (DESCRIPTION)

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

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