نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

-u

خروجی چک‌سوم‌ها را در قالب هگزادسیمال با حروف بزرگ نمایش می‌دهد.

-l

خروجی چک‌سوم‌ها را در قالب هگزادسیمال با حروف کوچک نمایش می‌دهد (پیش‌فرض).

-b

خروجی چک‌سوم‌ها را در قالب باینری نمایش می‌دهد. این گزینه نام فایل‌ها و جداکننده‌های چک‌سوم را حذف می‌کند؛ بنابراین تنها چک‌سوم‌ها چاپ می‌شوند.

-c

مجموع‌های SHA3 را از فایل ورودی خوانده و آن‌ها را در برابر فایل‌های موجود در سیستم شما بررسی می‌کند. قالب فایل‌های ورودی باید مانند خروجی این برنامه یا مشابه آن باشد. در صورتی که نام هر یک از فایل‌ها با یک فاصلهٔ معمولی یا تب افقی آغاز شود، یا شامل خط جدید (line feed)، بازگشت به ابتدای خط (carriage return) یا تعویض صفحه (form feed) باشد، این گزینه کار نخواهد کرد؛ مگر آنکه گزینهٔ -z نیز استفاده شود.

-a bits

نسخهٔ الگوریتم SHA3 را انتخاب می‌کند. مقادیر معتبر عبارت‌اند از 224 (پیش‌فرض)، 256، 384 و 512.

-v

پارامترهای درهم‌سازی را چاپ می‌کند.

-x

پیش از محاسبهٔ چک‌سوم‌ها، فایل‌های ورودی را از قالب هگزادسیمال به قالب باینری تبدیل می‌کند.

-z

خطوط به‌جای LF با نویسهٔ NUL پایان می‌یابند. در صورت استفاده همراه با -c، این مورد بر خواندن فایل‌ها (نه خروجی) اعمال می‌شود، اما همچنین قواعد بررسی دقیق‌تری را اِعمال کرده و هرگونه فاصله خالی در نام فایل‌ها را مجاز می‌شمارد.

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

-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).