نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

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