نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

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