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