نام (NAME)

tinyxxd - ابزار دامپ هگزادسیمال، باینری و ASCII با پشتیبانی از رنگ

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

tinyxxd [options] [infile [outfile]]

tinyxxd -r [-s [-]offset] [-c cols] [-ps] [infile [outfile]]

توضیحات (DESCRIPTION)

دستور tinyxxd ابزاری چندمنظوره برای ساخت دامپ‌های هگزادسیمال، باینری و ASCII از فایل‌های باینری است. این ابزار همچنین می‌تواند این دامپ‌ها را مجدداً به فرمت باینری بازگردانی کند. علاوه بر این، از قالب‌های خروجی گوناگونی از جمله فایل‌های include زبان C و PostScript پشتیبانی می‌کند. tinyxxd با رنگی‌سازی اختیاری خروجی و با پیروی از متغیر محیطی NO_COLOR خوانایی را بهبود می‌بخشد.

گزینه‌ها (OPTIONS)

-a | -autoskip: تغییر وضعیت حالت پرش خودکار (autoskip). در این حالت، یک علامت `*` جایگزین خطوطی می‌شود که تنها از صفر تشکیل شده‌اند. پیش‌فرض غیرفعال است.
-b | -bits: خروجی دادن دامپ ارقام باینری به‌جای هگزادسیمال. این گزینه با -ps ناسازگار است.
-c cols | -cols cols: قالب‌بندی خروجی برای قرار دادن cols اوکتت در هر سطر. پیش‌فرض ۱۶ است (۱۲ در سبک فایل include زبان C، و ۳۰ در PostScript).
-C | -capitalize: بزرگ نوشتن حروف اول نام متغیرها در سبک فایل include زبان C (-i).
-d: نمایش آفست به‌صورت ده‌دهی (decimal) به‌جای هگزادسیمال.
-e: ایجاد یک دامپ لیتل‌اندین (little-endian). این گزینه با -ps، -i و -r ناسازگار است.
-g bytes | -groupsize bytes: گروه‌بندی خروجی در قالب اوکتت‌هایی با اندازه bytes بایت در حالت خروجی عادی. پیش‌فرض ۲ است (۴ برای little-endian).
-E | -EBCDIC: نمایش کاراکترها با کدگذاری EBCDIC به‌جای ASCII.
-h | -help | --help: چاپ خلاصه‌ای از گزینه‌ها.
-i | -include: خروجی دادن در سبک فایل include زبان C.
-l len | -len len: توقف پس از len اوکتت.
-n name | -name name: تنظیم نام متغیر مورد استفاده در خروجی include زبان C (-i).
-o offset: افزودن offset به موقعیت نمایش‌داده‌شده فایل.
-p | -ps | -postscript | -plain: خروجی دادن در سبک دامپ هگز خام (plain) سازگار با PostScript.
-r | -revert: عملیات معکوس: تبدیل (یا وصله‌زدن) هگز‌دامپ به باینری.
-R when: رنگی‌سازی خروجی. مقدار when می‌تواند 'always'، 'auto' یا 'never' باشد. پیش‌فرض: 'auto'.
-s [+][-]seek: شروع از مقدار seek بایت به‌صورت مطلق (یا نسبی با پیشوند +) در فایل ورودی. هنگام استفاده با -r، آفست به موقعیت‌های فایل موجود در هگز‌دامپ افزوده می‌شود.
-t: الحاق یک بایت پایانی NUL به آرایه در سبک فایل include زبان C (-i).
-u: استفاده از حروف بزرگ برای خروجی هگزادسیمال. پیش‌فرض حروف کوچک است.
-v | -version: نمایش اطلاعات نسخه.

مثال‌ها (EXAMPLES)

ساخت یک هگز‌دامپ استاندارد به همراه رنگ:

tinyxxd file.bin

ساخت یک هگز‌دامپ لیتل‌اندین:

tinyxxd -e file.bin

خروجی در قالب ارقام باینری:

tinyxxd -b file.bin

ساخت یک فایل include زبان C:

tinyxxd -i file.bin > file.h

بازگردانی یک هگز‌دامپ به باینری:

tinyxxd -r dump.hex > file.bin

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

0 - موفقیت. 1-5 - خطاهای گوناگون (مانند خطاهای I/O فایل، آرگومان‌های نامعتبر).

محیط (ENVIRONMENT)

NO_COLOR: در صورت تنظیم، خروجی رنگی را غیرفعال می‌کند.

هشدارها (CAVEATS)

دامپ‌های لیتل‌اندین (Little-endian dumps): گزینه -e تنها بر نمایش هگزادسیمال تأثیر می‌گذارد و نه کاراکترهای ASCII (یا EBCDIC) در سمت راست دامپ. این گزینه با -r، -p یا -i ناسازگار است.
عملیات بازگردانی (-r): عملیات بازگردانی ممکن است در مواجهه با سطرهایی که طبق انتظار قالب‌بندی نشده‌اند با مشکل مواجه شود. این عملیات از سطور نامنطبق صرف‌نظر کرده و پردازش را ادامه می‌دهد. شماره خطوط هنگام نوشتن خروجی برای موقعیت‌یابی استفاده می‌شوند، بنابراین ترتیب و کامل بودن سطرها اهمیت دارد.

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

تاکنون باگ شناخته‌شده‌ای گزارش نشده است. مشکلات را می‌توان در این نشانی گزارش کرد: https://github.com/xyproto/tinyxxd/issues

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

tinyxxd توسط افراد زیر نوشته شده است:

Bram Moolenaar <Bram@vim.org>
Jürgen Weigert <jnweiger@gmail.com>
DungSaga <dungsaga@users.noreply.github.com>
Atsushi SUGAWARA <peanutsjamjam@gmail.com>
Yegappan Lakshmanan <yegappan@yahoo.com>
Erik Auerswald <auerswal@unix-ag.uni-kl.de>
David Gow <david@ingeniumdigital.com>
Philip H <47042125+pheiduck@users.noreply.github.com>
Aapo Rantalainen <aapo.rantalainen@gmail.com>
Christian Brabandt <cb@256bit.org>
Ken Takata <kentkt@csc.jp>
tristhaus <tristhaus@yahoo.de>
OldWorldOrdr <joey.t.reinhart@gmail.com>
Keith Thompson <Keith.S.Thompson@gmail.com>
Igor Todorovski <itodorov@ca.ibm.com>
Kuratius <Kuratius@gmx.net>
Goffredo Baroncelli <kreijack@inwind.it>
Lennard Hofmann <lennard.hofmann@web.de>
RestorerZ <restorer@mail2k.ru>
Husam Harazi <i@vimmer.dev>
Oliver Webb <aquahobbyist@proton.me>
Andre Chang <andre@augmentcode.com>
Randy Eckenrode <randy@largeandhighquality.com>
Alexander F. Rødseth <xyproto@archlinux.org>
Noah Gitsham <me@noahgitsham.com>
Lukáš Jiřiště <kyci@ljiriste.work>

نسخه (VERSION)

tinyxxd 1.3.16

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

xxd(1) - ابزار اصلی دامپ هگز.