.TH SHAKE256SUM 1 SHA3SUM
.SH "نام (NAME)"
shake256sum \- محاسبه و بررسی چکیده‌های پیام SHAKE256
.SH "خلاصه دستور (SYNOPSIS)"
.B shake256sum
[-u | -l | -b | -c]
[-R
.IR rate ]
[-C
.IR capacity ]
[-N
.IR output-size ]
[-S
.IR state-size ]
[-W
.IR word-size ]
[-Z
.IR squeeze-count ]
[-vxz]
.RI [ file \ ...]
.SH "توضیحات (DESCRIPTION)"
چاپ یا بررسی چِک‌سام‌های SHAKE256. اگر فایلی مشخص نشود
یا زمانی که فایل \- باشد، ورودی استاندارد خوانده می‌شود.
.TP
.B -u
خروجی دادن چِک‌سام‌ها در قالب مبنای شانزده (hexadecimal) با حروف بزرگ.
.TP
.B -l
خروجی دادن چِک‌سام‌ها در قالب مبنای شانزده (hexadecimal) با حروف کوچک. (پیش‌فرض)
.TP
.B -b
خروجی دادن چِک‌سام‌ها در قالب باینری (دودویی). این گزینه
نام فایل‌ها و جداکننده‌های چِک‌سام را حذف می‌کند. تنها
چِک‌سام‌ها چاپ می‌شوند.
.TP
.B -c
خواندن مقادیر SHAKE256 از فایل و بررسی آن‌ها در برابر
فایل‌های موجود در سیستم شما. فایل‌های ورودی باید مشابه
خروجی این برنامه یا شبیه به آن قالب‌بندی شده باشند.
در صورتی که نام هر یک از فایل‌ها در فایل ورودی با یک فاصله
معمولی یا تب افقی آغاز شود، یا حاوی خط جدید (LF)، بازگشت
مکان‌نما (CR) یا تعویض صفحه (FF) باشد، این گزینه کار نخواهد کرد؛
مگر اینکه گزینه
.B -z
نیز استفاده شده باشد.
.TP
.B -v
چاپ پارامترهای درهم‌سازی (هشینگ).
.TP
.B -x
تبدیل فایل‌های ورودی از قالب مبنای شانزده به قالب باینری
پیش از محاسبه چِک‌سام‌ها.
.TP
.B -z
خطوط به جای LF با NUL پایان می‌یابند. در صورت استفاده با
.BR -c ،
این مورد روی فایل‌های خوانده‌شده اعمال می‌شود (نه در خروجی)،
اما همچنین تجزیه دقیق‌تری را اِعمال کرده و امکان استفاده از
هرگونه نویسه فاصله (whitespace) را در نام فایل‌ها می‌دهد.
.P
گزینه‌های زیر پارامترهای درهم‌سازی را تغییر می‌دهند:
.TP
.BI -R\  rate
تغییر نرخ (rate).
.TP
.BI -C\  capacity
تغییر ظرفیت (capacity).
.TP
.BR -N ,\  -O \ \fIoutput-size\fP
تغییر اندازه خروجی.
.TP
.BR -S ,\  -B \ \fIstate-size\fP
تغییر اندازه وضعیت (state size).
.TP
.BI -W\  word-size
تغییر اندازه کلمه (word size).
.TP
.BI -Z\  squeeze-count
تغییر تعداد دفعات فشرده‌سازی/آبگیری (squeeze) انجام‌شده.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
0
اتمام موفقیت‌آمیز.
.TP
1
چِک‌سام‌ها مطابقت نداشتند یا فایلی وجود نداشت.
.TP
2
خطایی رخ داد.
.SH "نویسندگان (AUTHORS)"
Mattias Andrée
.RI < m@maandree.se >
.SH "نکات (NOTES)"
تمامی دستورات موجود در بسته sha3sum امکان تغییر پارامترهای
درهم‌سازی را می‌دهند. با این حال، این ویژگی تنها برای استفاده با
.BR keccaksum (1)،
یا در شرایطی که می‌دانید چه کاری انجام می‌دهید در نظر گرفته شده است؛
به جز گزینه
.B -N
که در نظر گرفته شده تا
.I همیشه
همراه با
.BR shake128sum (1)،
.BR shake256sum (1)،
.BR shake512sum (1)،
.BR rawshake128sum (1)،
.BR rawshake256sum (1)
و
.BR rawshake512sum (1)
به کار رود.