نام (NAME)

keccaksum - محاسبه و بررسی خلاصه‌پیام‌های Keccak[]

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

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

توضیحات (DESCRIPTION)

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

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