نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

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