.\" Automatically generated by Pandoc 3.5
.\"
.TH "HEXYL" "1" "2022\-12\-05" "hexyl 0.12.0" "General Commands Manual"
.SH "نام (NAME)"
hexyl \- یک نمایش‌دهنده هگزادسیمال در خط فرمان
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]hexyl\f[R] [\f[I]OPTIONS\f[R]] [\f[I]FILE\f[R]]
.SH "توضیحات (DESCRIPTION)"
\f[B]hexyl\f[R] یک نمایش‌دهنده ساده هگزادسیمال برای ترمینال است.
این ابزار از یک خروجی رنگی برای تفکیک دسته‌های مختلف بایت‌ها
(بایت‌های تهی یا NULL، نویسه‌های اسکی قابل‌چاپ، نویسه‌های فضای خالی اسکی،
سایر نویسه‌های اسکی و نویسه‌های غیر اسکی) استفاده می‌کند.
.SH "آرگومان‌های موقعیتی (POSITIONAL ARGUMENTS)"
.TP
\f[I]FILE\f[R]
پرونده مورد نظر برای نمایش.
اگر هیچ آرگومان \f[I]FILE\f[R] داده نشود، ورودی از STDIN خوانده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\f[B]\-n\f[R], \f[B]\-\-length\f[R] \f[I]N\f[R]
تنها خواندن \f[I]N\f[R] بایت از ورودی.
آرگومان \f[I]N\f[R] می‌تواند شامل یک واحد با پیشوند ده‌دهی
(kB, MB, ..)
یا پیشوند دودویی (kiB, MiB, ..) باشد، یا با استفاده از یک عدد در مبنای ۱۶ (هگز) مشخص شود.
.RS
.TP
مثال‌ها:
.TP
خواندن ۶۴ بایت نخست:
$ \f[B]hexyl \-\-length=64\f[R]
.TP
خواندن ۴ کیبی‌بایت نخست:
$ \f[B]hexyl \-\-length=4KiB\f[R]
.TP
خواندن ۲۵۵ بایت نخست (مشخص‌شده با عدد هگز):
$ \f[B]hexyl \-\-length=0xff\f[R]
.RE
.TP
\f[B]\-c\f[R], \f[B]\-\-bytes\f[R] \f[I]N\f[R]
نام مستعاری برای \f[B]\-n\f[R]/\f[B]\-\-length\f[R].
.TP
\f[B]\-l\f[R] \f[I]N\f[R]
نام مستعار دیگری برای \f[B]\-n\f[R]/\f[B]\-\-length\f[R].
.TP
\f[B]\-s\f[R], \f[B]\-\-skip\f[R] \f[I]N\f[R]
نادیده گرفتن \f[I]N\f[R] بایت اول از ورودی.
آرگومان \f[I]N\f[R] همچنین می‌تواند شامل یک واحد باشد (برای جزئیات به
\f[B]\-\-length\f[R]
مراجعه کنید).
مقادیر منفی نیز معتبر هستند و عمل پرش (seek) را از انتهای پرونده انجام می‌دهند.
.TP
\f[B]\-\-block\-size\f[R] \f[I]SIZE\f[R]
تنظیم اندازه واحد بلوک به \f[I]SIZE\f[R] (مقدار پیش‌فرض ۵۱۲ است).
.RS
.TP
مثال‌ها:
.TP
تنظیم اندازه بلوک به ۱۰۲۴ بایت:
$ \f[B]hexyl \-\-block\-size=1024 \-\-length=5block\f[R]
.TP
تنظیم اندازه بلوک به ۴ کیلوبایت:
$ \f[B]hexyl \-\-block\-size=4kB \-\-length=2block\f[R]
.RE
.TP
\f[B]\-v\f[R], \f[B]\-\-no\-squeezing\f[R]
نمایش تمامی داده‌های ورودی.
در غیر این صورت، هر تعداد از گروه‌های خطوط خروجی که مشابه گروه خط قبلی باشند، با یک خط شامل یک ستاره تکی جایگزین می‌شوند.
.TP
\f[B]\-\-color\f[R] \f[I]WHEN\f[R]
زمان استفاده از رنگ‌ها.
حالت خودکار (auto) تنها در صورتی رنگ‌ها را نمایش می‌دهد که خروجی به یک ترمینال تعاملی هدایت شده باشد.
.RS
.TP
مقادیر ممکن:
.IP \[bu] 2
\f[B]always\f[R] (پیش‌فرض)
.IP \[bu] 2
\f[B]auto\f[R]
.IP \[bu] 2
\f[B]never\f[R]
.RE
.TP
\f[B]\-\-border\f[R] \f[I]STYLE\f[R]
رسم کادر حاشیه با نویسه‌های یونیکد، نویسه‌های اسکی (ASCII) یا بدون هیچ حاشیه‌ای.
.RS
.TP
مقادیر ممکن:
.IP \[bu] 2
\f[B]unicode\f[R] (پیش‌فرض)
.IP \[bu] 2
\f[B]ascii\f[R]
.IP \[bu] 2
\f[B]none\f[R]
.RE
.TP
\f[B]\-o\f[R], \f[B]\-\-display\-offset\f[R] \f[I]N\f[R]
افزودن \f[I]N\f[R] بایت به موقعیت نمایش داده‌شده پرونده.
آرگومان \f[I]N\f[R] همچنین می‌تواند شامل یک واحد باشد (برای جزئیات به
\f[B]\-\-length\f[R]
مراجعه کنید).
مقادیر منفی نیز معتبر هستند و آفست را نسبت به انتهای پرونده محاسبه می‌کنند.
.TP
\f[B]\-h\f[R], \f[B]\-\-help\f[R]
چاپ اطلاعات راهنما.
.TP
\f[B]\-V\f[R], \f[B]\-\-version\f[R]
چاپ اطلاعات نسخه.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.TP
رنگ‌های \f[B]hexyl\f[R] را می‌توان از طریق متغیرهای محیطی پیکربندی کرد. متغیرهای مورد استفاده عبارتند از:
.IP \[bu] 2
\f[B]HEXYL_COLOR_ASCII_PRINTABLE\f[R]: هر نویسه اسکی قابل‌چاپ به جز فضای خالی
.IP \[bu] 2
\f[B]HEXYL_COLOR_ASCII_WHITESPACE\f[R]: نویسه‌های فضای خالی مانند فاصله یا خط جدید (تنها در پانل میانی با مقادیر بایت قابل مشاهده است)
.IP \[bu] 2
\f[B]HEXYL_COLOR_ASCII_OTHER\f[R]: هر نویسه اسکی دیگر (< \f[B]0x80\f[R]) به جز تهی (null)
.IP \[bu] 2
\f[B]HEXYL_COLOR_NULL\f[R]: بایت تهی (\f[B]0x00\f[R])
.IP \[bu] 2
\f[B]HEXYL_COLOR_NONASCII\f[R]: هر بایت غیر اسکی (> \f[B]0x7F\f[R])
.IP \[bu] 2
\f[B]HEXYL_COLOR_OFFSET\f[R]: آفست پرونده در سمت چپ
.PP
رنگ‌ها می‌توانند هر یک از ۸ رنگ استاندارد ترمینال باشند:
\f[B]black\f[R]، \f[B]blue\f[R]، \f[B]cyan\f[R]، \f[B]green\f[R]،
\f[B]magenta\f[R]، \f[B]red\f[R]، \f[B]yellow\f[R] و \f[B]white\f[R].
انواع روشن (\[lq]bright\[rq]) نیز پشتیبانی می‌شوند (مانند \f[B]bright blue\f[R]).
علاوه بر این، می‌توانید از قالب هگز RGB مانند \f[B]#abcdef\f[R] استفاده کنید.
برای مثال:
.PP
.nf
\f[B]HEXYL_COLOR_ASCII_PRINTABLE=blue\f[R]
\f[B]HEXYL_COLOR_ASCII_WHITESPACE=\[lq]bright green\[rq]\f[R]
\f[B]HEXYL_COLOR_ASCII_OTHER=\[lq]#ff7f99\[rq]\f[R]
.fi
.SH "نکات (NOTES)"
.TP
مخزن منبع:
\c
.UR https://github.com/sharkdp/hexyl
.UE \c
.SH "مثال‌ها (EXAMPLES)"
.TP
چاپ محتوای یک پرونده داده‌شده:
$ \f[B]hexyl small.png\f[R]
.TP
چاپ و مشاهده یک پرونده مشخص در صفحه‌بند ترمینال:
$ \f[B]hexyl big.png | less \-r\f[R]
.TP
چاپ ۲۵۶ بایت نخست از یک پرونده ویژه:
$ \f[B]hexyl \-n 256 /dev/urandom\f[R]
.SH "نویسندگان (AUTHORS)"
\f[B]hexyl\f[R] توسط David Peter نوشته شده است \c
.MT mail@david-peter.de
.ME \c
\&.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.TP
گزارش باگ‌ها و مشکلات در گیت‌هاب:
\c
.UR https://github.com/sharkdp/hexyl/issues
.UE \c
.SH "حق نشر (COPYRIGHT)"
.TP
\f[B]hexyl\f[R] دارای مجوز دوگانه تحت شرایط زیر است:
.IP \[bu] 2
مجوز آپاچی نسخه 2.0 (\c
.UR https://www.apache.org/licenses/LICENSE-2.0
.UE \c
)
.IP \[bu] 2
مجوز MIT (\c
.UR https://opensource.org/licenses/MIT
.UE \c
)
.SH "همچنین ببینید (SEE ALSO)"
\f[B]hexdump\f[R](1), \f[B]xxd\f[R](1)