نام (NAME)

sha3-384sum - محاسبه و بررسی چکیده‌های پیام SHA3-384

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

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

توضیحات (DESCRIPTION)

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

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