نام (NAME)

xxhsum - چاپ یا بررسی مجموع‌های مقابله‌ای غیررمزنگاری xxHash

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

xxhsum [OPTION]... [FILE]... xxhsum -b [OPTION]...

xxh32sum معادل xxhsum -H0، xxh64sum معادل xxhsum -H1، xxh128sum معادل xxhsum -H2 و xxh3sum معادل xxhsum -H3 است.

توضیحات (DESCRIPTION)

چاپ یا بررسی مجموع‌های مقابله‌ای xxHash (۳۲، ۶۴ یا ۱۲۸ بیتی). در صورتی که هیچ FILE مشخص نشده باشد، ورودی استاندارد را می‌خواند، مگر اینکه کنسول باشد. زمانی که FILE برابر - باشد، ورودی استاندارد را حتی در صورت کنسول بودن می‌خواند.

xxhsum از نحو خط فرمانی مشابه اما نه یکسان با md5sum(1) پشتیبانی می‌کند. تفاوت‌ها عبارتند از:

xxhsum فاقد سوییچ حالت متنی (-t) است
xxhsum فاقد سوییچ کوتاه حالت باینری (-b) است
xxhsum همواره با فایل‌ها به عنوان فایل باینری رفتار می‌کند
xxhsum دارای سوییچ انتخاب درهم‌سازی (-H) است

از آنجا که xxHash یک الگوریتم سریع و غیررمزنگاری برای مجموع‌های مقابله‌ای است، xxhsum نباید برای اهداف امنیتی استفاده شود.

دستور xxhsum -b حالت محک‌زنی را فراخوانی می‌کند. برای جزئیات، بخش‌های گزینه‌ها (OPTIONS) و مثال‌ها (EXAMPLES) را ببینید.

گزینه‌ها (OPTIONS)

-V, --version: نمایش نسخهٔ xxhsum و خروج.
-HHASHTYPE: انتخاب درهم‌سازی. مقدار HASHTYPE به این صورت است: 0=XXH32، 1=XXH64، 2=XXH128، 3=XXH3. به عنوان جایگزین، HASHTYPE می‌تواند 32=XXH32، 64=XXH64، 128=XXH128 باشد. مقدار پیش‌فرض 1 (XXH64) است.
--binary: خواندن در حالت باینری.
--tag: نمایش خروجی به سبک BSD.
--little-endian: تنظیم مقدار هگزادسیمال مجموع مقابله‌ای در خروجی به صورت little-endian. به طور پیش‌فرض، مقدار به صورت big-endian نمایش داده می‌شود.
-h, --help: نمایش راهنما و خروج.

گزینه‌های زیر تنها هنگام بررسی مجموع‌های مقابله‌ای (-c) کاربرد دارند:

-c, --check FILE: خواندن مجموع‌های xxHash از FILE و بررسی آن‌ها.
-q, --quiet: عدم چاپ OK برای هر فایلی که با موفقیت اعتبارسنجی شده است.
--strict: بازگرداندن کد خطا در صورت نامعتبر بودن هر خط از فایل، و نه فقط در حالتی که برخی مجموع‌های مقابله‌ای نادرست باشند. این سیاست به طور پیش‌فرض غیرفعال است، هرچند اگر هر خطی از فایل نامعتبر تشخیص داده شود، پیامی اطلاعاتی نمایش داده خواهد شد.
--status: هیچ خروجی تولید نشود. کد وضعیت نشان‌دهندهٔ موفقیت است.
-w, --warn: ارائهٔ یک پیام هشدار در رابطه با هر خط مجموع مقابله‌ای که قالب‌بندی نادرست دارد.

گزینه‌های زیر تنها برای اهداف محک‌زنی کاربرد دارند:

-b: حالت محک‌زنی. برای جزئیات بخش مثال‌ها (EXAMPLES) را ببینید.
-b#: تعیین شناسهٔ گونه‌ای (variant) که باید آزمایش شود. می‌توان چندین گونه را به صورت جداشده با ویرگول ',' انتخاب کرد.
-BBLOCKSIZE: تنها برای حالت محک‌زنی (-b) کاربرد دارد. برای جزئیات به EXAMPLES مراجعه کنید. مقدار BLOCKSIZE اندازهٔ بلوک داده‌های آزمایشی در حالت محک‌زنی را بر حسب بایت مشخص می‌کند. مقدار پیش‌فرض 102400 است.
-iITERATIONS: تنها برای حالت محک‌زنی (-b) کاربرد دارد. برای جزئیات به EXAMPLES مراجعه کنید. مقدار ITERATIONS تعداد تکرارها در آزمون محک‌زنی را مشخص می‌کند. هر تکرار تقریباً 1000 میلی‌ثانیه طول می‌کشد. مقدار پیش‌فرض 3 است.

وضعیت خروج (EXIT STATUS)

xxhsum در صورت موفقیت با کد 0 خارج می‌شود، و با کد 1 در صورتی که حداقل یک فایل نتواند خوانده شود یا مجموع مقابله‌ای آن با گزینهٔ -c مطابقت نداشته باشد.

مثال‌ها (EXAMPLES)

ارسال مقادیر مجموع مقابله‌ای xxHash (۶۴ بیتی) فایل‌های مشخص به خروجی استاندارد:

$ xxhsum -H1 foo bar baz

ارسال مقادیر مجموع مقابله‌ای xxHash (۳۲ بیتی و ۶۴ بیتی) فایل‌های مشخص به خروجی استاندارد، و هدایت آن به xyz.xxh32 و qux.xxh64:

$ xxhsum -H0 foo bar baz > xyz.xxh32
$ xxhsum -H1 foo bar baz > qux.xxh64

خواندن مجموع‌های xxHash از فایل‌های مشخص و بررسی آن‌ها:

$ xxhsum -c xyz.xxh32 qux.xxh64

محک‌زنی الگوریتم xxHash. به طور پیش‌فرض، xxhsum گونه‌های اصلی xxHash را روی یک نمونهٔ ساختگی ۱۰۰ کیلوبایتی محک می‌زند و نتایج را در خروجی استاندارد چاپ می‌کند. ستون اول الگوریتم، ستون دوم اندازهٔ داده‌های مبدأ به بایت، ستون سوم تعداد درهم‌سازی‌های تولیدشده در ثانیه (نرخ عبور داده)، و در نهایت ستون آخر سرعت را به مگابایت بر ثانیه نشان می‌دهد.

$ xxhsum -b

در مثال زیر، اندازهٔ نمونه برای درهم‌سازی روی 16384 بایت تنظیم شده، گونه‌های مورد محک بر اساس شناسه‌شان انتخاب می‌شوند، و هر آزمون محک برای دقت بیشتر 10 بار تکرار می‌گردد.

$ xxhsum -b1,2,3 -i10 -B16384

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها در: https://github.com/Cyan4973/xxHash/issues

نویسندگان (AUTHORS)

Yann Collet

همچنین ببینید (SEE ALSO)

md5sum(1)