.
.TH "XXHSUM" "1" "May 2024" "xxhsum 0.8.3" "User Commands"
.
.SH "نام (NAME)"
\fBxxhsum\fR \- چاپ یا بررسی مجموع‌های مقابله‌ای غیررمزنگاری xxHash
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBxxhsum\fR [\fIOPTION\fR]\.\.\. [\fIFILE\fR]\.\.\. \fBxxhsum \-b\fR [\fIOPTION\fR]\.\.\.
.
.P
\fBxxh32sum\fR معادل \fBxxhsum \-H0\fR، \fBxxh64sum\fR معادل \fBxxhsum \-H1\fR، \fBxxh128sum\fR معادل \fBxxhsum \-H2\fR و \fBxxh3sum\fR معادل \fBxxhsum \-H3\fR است\.
.
.SH "توضیحات (DESCRIPTION)"
چاپ یا بررسی مجموع‌های مقابله‌ای xxHash (۳۲، ۶۴ یا ۱۲۸ بیتی)\. در صورتی که هیچ \fIFILE\fR مشخص نشده باشد، ورودی استاندارد را می‌خواند، مگر اینکه کنسول باشد\. زمانی که \fIFILE\fR برابر \fB\-\fR باشد، ورودی استاندارد را حتی در صورت کنسول بودن می‌خواند\.
.
.P
\fBxxhsum\fR از نحو خط فرمانی مشابه اما نه یکسان با md5sum(1) پشتیبانی می‌کند\. تفاوت‌ها عبارتند از:
.
.IP "\(bu" 4
\fBxxhsum\fR فاقد سوییچ حالت متنی (\fB\-t\fR) است
.
.IP "\(bu" 4
\fBxxhsum\fR فاقد سوییچ کوتاه حالت باینری (\fB\-b\fR) است
.
.IP "\(bu" 4
\fBxxhsum\fR همواره با فایل‌ها به عنوان فایل باینری رفتار می‌کند
.
.IP "\(bu" 4
\fBxxhsum\fR دارای سوییچ انتخاب درهم‌سازی (\fB\-H\fR) است
.
.IP "" 0
.
.P
از آنجا که xxHash یک الگوریتم سریع و غیررمزنگاری برای مجموع‌های مقابله‌ای است، \fBxxhsum\fR نباید برای اهداف امنیتی استفاده شود\.
.
.P
دستور \fBxxhsum \-b\fR حالت محک‌زنی را فراخوانی می‌کند\. برای جزئیات، بخش‌های گزینه‌ها (OPTIONS) و مثال‌ها (EXAMPLES) را ببینید\.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش نسخهٔ xxhsum و خروج\.
.
.TP
\fB\-H\fR\fIHASHTYPE\fR
انتخاب درهم‌سازی\. مقدار \fIHASHTYPE\fR به این صورت است: \fB0\fR=XXH32، \fB1\fR=XXH64، \fB2\fR=XXH128، \fB3\fR=XXH3\. به عنوان جایگزین، \fIHASHTYPE\fR می‌تواند \fB32\fR=XXH32، \fB64\fR=XXH64، \fB128\fR=XXH128 باشد\. مقدار پیش‌فرض \fB1\fR (XXH64) است\.
.
.TP
\fB\-\-binary\fR
خواندن در حالت باینری\.
.
.TP
\fB\-\-tag\fR
نمایش خروجی به سبک BSD\.
.
.TP
\fB\-\-little\-endian\fR
تنظیم مقدار هگزادسیمال مجموع مقابله‌ای در خروجی به صورت little-endian\. به طور پیش‌فرض، مقدار به صورت big-endian نمایش داده می‌شود\.
.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما و خروج\.
.
.SS "گزینه‌های زیر تنها هنگام بررسی مجموع‌های مقابله‌ای (\-c) کاربرد دارند:"
.
.TP
\fB\-c\fR, \fB\-\-check\fR \fIFILE\fR
خواندن مجموع‌های xxHash از \fIFILE\fR و بررسی آن‌ها\.
.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
عدم چاپ OK برای هر فایلی که با موفقیت اعتبارسنجی شده است\.
.
.TP
\fB\-\-strict\fR
بازگرداندن کد خطا در صورت نامعتبر بودن هر خط از فایل، و نه فقط در حالتی که برخی مجموع‌های مقابله‌ای نادرست باشند\. این سیاست به طور پیش‌فرض غیرفعال است، هرچند اگر هر خطی از فایل نامعتبر تشخیص داده شود، پیامی اطلاعاتی نمایش داده خواهد شد\.
.
.TP
\fB\-\-status\fR
هیچ خروجی تولید نشود\. کد وضعیت نشان‌دهندهٔ موفقیت است\.
.
.TP
\fB\-w\fR, \fB\-\-warn\fR
ارائهٔ یک پیام هشدار در رابطه با هر خط مجموع مقابله‌ای که قالب‌بندی نادرست دارد\.
.
.SS "گزینه‌های زیر تنها برای اهداف محک‌زنی کاربرد دارند:"
.
.TP
\fB\-b\fR
حالت محک‌زنی\. برای جزئیات بخش مثال‌ها (EXAMPLES) را ببینید\.
.
.TP
\fB\-b#\fR
تعیین شناسهٔ گونه‌ای (variant) که باید آزمایش شود\. می‌توان چندین گونه را به صورت جداشده با ویرگول \(aq,\(aq انتخاب کرد\.
.
.TP
\fB\-B\fR\fIBLOCKSIZE\fR
تنها برای حالت محک‌زنی (\fB\-b\fR) کاربرد دارد\. برای جزئیات به \fIEXAMPLES\fR مراجعه کنید\. مقدار \fIBLOCKSIZE\fR اندازهٔ بلوک داده‌های آزمایشی در حالت محک‌زنی را بر حسب بایت مشخص می‌کند\. مقدار پیش‌فرض 102400 است\.
.
.TP
\fB\-i\fR\fIITERATIONS\fR
تنها برای حالت محک‌زنی (\fB\-b\fR) کاربرد دارد\. برای جزئیات به \fIEXAMPLES\fR مراجعه کنید\. مقدار \fIITERATIONS\fR تعداد تکرارها در آزمون محک‌زنی را مشخص می‌کند\. هر تکرار تقریباً 1000 میلی‌ثانیه طول می‌کشد\. مقدار پیش‌فرض 3 است\.
.
.SH "وضعیت خروج (EXIT STATUS)"
\fBxxhsum\fR در صورت موفقیت با کد \fB0\fR خارج می‌شود، و با کد \fB1\fR در صورتی که حداقل یک فایل نتواند خوانده شود یا مجموع مقابله‌ای آن با گزینهٔ \fB\-c\fR مطابقت نداشته باشد\.
.
.SH "مثال‌ها (EXAMPLES)"
ارسال مقادیر مجموع مقابله‌ای xxHash (۶۴ بیتی) فایل‌های مشخص به خروجی استاندارد:
.
.IP "" 4
.
.nf

$ xxhsum \-H1 foo bar baz
.
.fi
.
.IP "" 0
.
.P
ارسال مقادیر مجموع مقابله‌ای xxHash (۳۲ بیتی و ۶۴ بیتی) فایل‌های مشخص به خروجی استاندارد، و هدایت آن به \fBxyz\.xxh32\fR و \fBqux\.xxh64\fR:
.
.IP "" 4
.
.nf

$ xxhsum \-H0 foo bar baz > xyz\.xxh32
$ xxhsum \-H1 foo bar baz > qux\.xxh64
.
.fi
.
.IP "" 0
.
.P
خواندن مجموع‌های xxHash از فایل‌های مشخص و بررسی آن‌ها:
.
.IP "" 4
.
.nf

$ xxhsum \-c xyz\.xxh32 qux\.xxh64
.
.fi
.
.IP "" 0
.
.P
محک‌زنی الگوریتم xxHash\. به طور پیش‌فرض، \fBxxhsum\fR گونه‌های اصلی xxHash را روی یک نمونهٔ ساختگی ۱۰۰ کیلوبایتی محک می‌زند و نتایج را در خروجی استاندارد چاپ می‌کند\. ستون اول الگوریتم، ستون دوم اندازهٔ داده‌های مبدأ به بایت، ستون سوم تعداد درهم‌سازی‌های تولیدشده در ثانیه (نرخ عبور داده)، و در نهایت ستون آخر سرعت را به مگابایت بر ثانیه نشان می‌دهد\.
.
.IP "" 4
.
.nf

$ xxhsum \-b
.
.fi
.
.IP "" 0
.
.P
در مثال زیر، اندازهٔ نمونه برای درهم‌سازی روی 16384 بایت تنظیم شده، گونه‌های مورد محک بر اساس شناسه‌شان انتخاب می‌شوند، و هر آزمون محک برای دقت بیشتر 10 بار تکرار می‌گردد\.
.
.IP "" 4
.
.nf

$ xxhsum \-b1,2,3 \-i10 \-B16384
.
.fi
.
.IP "" 0
.
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها در: https://github\.com/Cyan4973/xxHash/issues
.
.SH "نویسندگان (AUTHORS)"
Yann Collet
.
.SH "همچنین ببینید (SEE ALSO)"
md5sum(1)