HEXYL(1)                    General Commands Manual                   HEXYL(1)

نام (NAME)
       hexyl - یک نمایش‌دهنده هگزادسیمال در خط فرمان

خلاصه دستور (SYNOPSIS)
       hexyl [OPTIONS] [FILE]

توضیحات (DESCRIPTION)
       hexyl یک نمایش‌دهنده ساده هگزادسیمال برای ترمینال است.  این ابزار از یک
       خروجی رنگی برای تفکیک دسته‌های مختلف بایت‌ها (بایت‌های تهی یا NULL،
       نویسه‌های اسکی قابل‌چاپ، نویسه‌های فضای خالی اسکی، سایر نویسه‌های اسکی و
       نویسه‌های غیر اسکی) استفاده می‌کند.

آرگومان‌های موقعیتی (POSITIONAL ARGUMENTS)
       FILE   پرونده مورد نظر برای نمایش.  اگر هیچ آرگومان FILE داده نشود،
              ورودی از STDIN خوانده می‌شود.

گزینه‌ها (OPTIONS)
       -n, --length N
              تنها خواندن N بایت از ورودی.  آرگومان N می‌تواند شامل یک واحد با
              پیشوند ده‌دهی (kB, MB, ..) یا پیشوند دودویی (kiB, MiB, ..) باشد،
              یا با استفاده از یک عدد در مبنای ۱۶ (هگز) مشخص شود.

              مثال‌ها:

              خواندن ۶۴ بایت نخست:
                     $ hexyl --length=64

              خواندن ۴ کیبی‌بایت نخست:
                     $ hexyl --length=4KiB

              خواندن ۲۵۵ بایت نخست (مشخص‌شده با عدد هگز):
                     $ hexyl --length=0xff

       -c, --bytes N
              نام مستعاری برای -n/--length.

       -l N   نام مستعار دیگری برای -n/--length.

       -s, --skip N
              نادیده گرفتن N بایت اول از ورودی.  آرگومان N همچنین می‌تواند شامل
              یک واحد باشد (برای جزئیات به --length مراجعه کنید).  مقادیر منفی
              نیز معتبر هستند و عمل پرش (seek) را از انتهای پرونده انجام
              می‌دهند.

       --block-size SIZE
              تنظیم اندازه واحد بلوک به SIZE (مقدار پیش‌فرض ۵۱۲ است).

              مثال‌ها:

              تنظیم اندازه بلوک به ۱۰۲۴ بایت:
                     $ hexyl --block-size=1024 --length=5block

              تنظیم اندازه بلوک به ۴ کیلوبایت:
                     $ hexyl --block-size=4kB --length=2block

       -v, --no-squeezing
              نمایش تمامی داده‌های ورودی.  در غیر این صورت، هر تعداد از گروه‌های
              خطوط خروجی که مشابه گروه خط قبلی باشند، با یک خط شامل یک ستاره
              تکی جایگزین می‌شوند.

       --color WHEN
              زمان استفاده از رنگ‌ها.  حالت خودکار (auto) تنها در صورتی رنگ‌ها
              را نمایش می‌دهد که خروجی به یک ترمینال تعاملی هدایت شده باشد.

              مقادیر ممکن:

              • always (پیش‌فرض)

              • auto

              • never

       --border STYLE
              رسم کادر حاشیه با نویسه‌های یونیکد، نویسه‌های اسکی (ASCII) یا بدون
              هیچ حاشیه‌ای.

              مقادیر ممکن:

              • unicode (پیش‌فرض)

              • ascii

              • none

       -o, --display-offset N
              افزودن N بایت به موقعیت نمایش داده‌شده پرونده.  آرگومان N همچنین
              می‌تواند شامل یک واحد باشد (برای جزئیات به --length مراجعه کنید).
              مقادیر منفی نیز معتبر هستند و آفست را نسبت به انتهای پرونده
              محاسبه می‌کنند.

       -h, --help
              چاپ اطلاعات راهنما.

       -V, --version
              چاپ اطلاعات نسخه.

متغیرهای محیطی (ENVIRONMENT VARIABLES)
       رنگ‌های hexyl را می‌توان از طریق متغیرهای محیطی پیکربندی کرد. متغیرهای
       مورد استفاده عبارتند از:

       • HEXYL_COLOR_ASCII_PRINTABLE: هر نویسه اسکی قابل‌چاپ به جز فضای خالی

       • HEXYL_COLOR_ASCII_WHITESPACE: نویسه‌های فضای خالی مانند فاصله یا خط
         جدید (تنها در پانل میانی با مقادیر بایت قابل مشاهده است)

       • HEXYL_COLOR_ASCII_OTHER: هر نویسه اسکی دیگر (< 0x80) به جز تهی (null)

       • HEXYL_COLOR_NULL: بایت تهی (0x00)

       • HEXYL_COLOR_NONASCII: هر بایت غیر اسکی (> 0x7F)

       • HEXYL_COLOR_OFFSET: آفست پرونده در سمت چپ

       رنگ‌ها می‌توانند هر یک از ۸ رنگ استاندارد ترمینال باشند: black، blue،
       cyan، green، magenta، red، yellow و white.  انواع روشن (“bright”) نیز
       پشتیبانی می‌شوند (مانند bright blue).  علاوه بر این، می‌توانید از قالب
       هگز RGB مانند #abcdef استفاده کنید.  برای مثال:

       HEXYL_COLOR_ASCII_PRINTABLE=blue
       HEXYL_COLOR_ASCII_WHITESPACE=“bright green”
       HEXYL_COLOR_ASCII_OTHER=“#ff7f99”

نکات (NOTES)
       مخزن منبع:
              <https://github.com/sharkdp/hexyl>

مثال‌ها (EXAMPLES)
       چاپ محتوای یک پرونده داده‌شده:
              $ hexyl small.png

       چاپ و مشاهده یک پرونده مشخص در صفحه‌بند ترمینال:
              $ hexyl big.png | less -r

       چاپ ۲۵۶ بایت نخست از یک پرونده ویژه:
              $ hexyl -n 256 /dev/urandom

نویسندگان (AUTHORS)
       hexyl توسط David Peter نوشته شده است <mail@david-peter.de>.

گزارش باگ‌ها (REPORTING BUGS)
       گزارش باگ‌ها و مشکلات در گیت‌هاب:
              <https://github.com/sharkdp/hexyl/issues>

حق نشر (COPYRIGHT)
       hexyl دارای مجوز دوگانه تحت شرایط زیر است:

       • مجوز آپاچی نسخه 2.0 (<https://www.apache.org/licenses/LICENSE-2.0>)

       • مجوز MIT (<https://opensource.org/licenses/MIT>)

همچنین ببینید (SEE ALSO)
       hexdump(1), xxd(1)

hexyl 0.12.0                      2022-12-05                          HEXYL(1)