نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

-u: چاپ چک‌سام‌ها با حروف بزرگ هگزادسیمال.
-l: چاپ چک‌سام‌ها با حروف کوچک هگزادسیمال. (پیش‌فرض)
-b: چاپ چک‌سام‌ها در قالب باینری (دودویی). این گزینه از نمایش نام فایل‌ها و جداکننده‌های چک‌سام جلوگیری می‌کند. تنها خود چک‌سام‌ها چاپ می‌شوند.
-c: خواندن مقادیر Keccak-512 از فایل و بررسی آن‌ها در برابر فایل‌های موجود در سیستم شما. قالب فایل‌های ورودی باید مانند خروجی این برنامه یا مشابه آن باشد. در صورتی که نام هر یک از فایل‌ها در فایل ورودی با یک فاصلهٔ معمولی یا نویسهٔ Tab افقی آغاز شود، یا شامل خط جدید (LF)، بازگشت به ابتدای سطر (CR) یا برگه‌بران (FF) باشد، این کار انجام نخواهد شد، مگر اینکه گزینهٔ -z نیز به کار رود.
-v: چاپ پارامترهای درهم‌سازی (hashing).
-x: تبدیل فایل‌های ورودی از قالب هگزادسیمال به باینری پیش از محاسبهٔ چک‌سام‌ها.
-z: پایان خطوط به‌جای LF با NUL مشخص می‌شود. در صورت استفاده با -c، این مورد روی فایل‌های خوانده‌شده اعمال می‌شود (نه خروجی)، اما در عین حال تجزیهٔ دقیق‌تری را اعمال کرده و اجازه می‌دهد هرگونه فاصله خالی در نام فایل‌ها مجاز باشد.

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

-R rate: تغییر rate (نرخ).
-C capacity: تغییر capacity (ظرفیت).
-N, -O output-size: تغییر 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) استفاده شود.