نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

-u

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

-l

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

-b

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

-c

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

-v

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

-x

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

-z

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

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

-R rate

تغییر نرخ (rate).

-C capacity

تغییر ظرفیت (capacity).

-N, -O output-size

تغییر اندازهٔ خروجی.

-S, -B state-size

تغییر اندازهٔ وضعیت (state).

-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) استفاده شود.