XXHSUM(1)                        User Commands                       XXHSUM(1)

نام (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)

xxhsum 0.8.3                       May 2024                          XXHSUM(1)