tinyxxd(1)

Usage

tinyxxd [options] [infile [outfile]]

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

Overview

tinyxxd is a versatile utility for creating hex, binary, and ASCII dumps from binary files. It can also reverse these dumps back into binary form. Additionally, it supports various output formats, including C include files and PostScript. tinyxxd enhances readability by optionally colorizing the output, respecting the NO_COLOR environment variable.

Options

-a | -autoskip: Toggle autoskip mode. In this mode, a single `*` replaces lines that consist only of zeros. Default is off.

-b | -bits: Output a binary digit dump instead of hexadecimal. This option is incompatible with -ps.

-c cols | -cols cols: Format the output to include cols octets per line. Default is 16 (12 in C include style, 30 in PostScript).

-C | -capitalize: Capitalize variable names in C include file style (-i).

-d: Show the offset in decimal instead of hexadecimal.

-e: Create a little-endian dump. This option is incompatible with -ps, -i, and -r.

-g bytes | -groupsize bytes: Group output into octets of bytes size in the normal output mode. Default is 2 (4 for little-endian).

-E | -EBCDIC: Display the characters in EBCDIC encoding instead of ASCII.

-h | -help | --help: Print a summary of the options.

-i | -include: Output in C include file style.

`-l len \| -len len`	Stop after len octets.
`-n name \| -name name`	Set the variable name used in C include output (-i).

-o offset: Add offset to the displayed file position.

-p | -ps | -postscript | -plain: Output in PostScript plain hexdump style.

-r | -revert: Reverse operation: convert (or patch) hexdump into binary.

-R when: Colorize the output. when can be 'always', 'auto', or 'never'. Default: 'auto'.

-s [+][-]seek: Start at seek bytes absolute (or relative, with + prefix) in the input file. When used with -r, the offset is added to file positions found in the hex dump.

-t: Append a terminating NUL byte to the array in C include file style (-i).

-u: Use uppercase letters for hexadecimal output. Default is lowercase.

-v | -version: Show version information.

Examples

Create a standard hex dump with color:: tinyxxd file.bin

Create a little-endian hex dump:: tinyxxd -e file.bin

Output in binary digit format:: tinyxxd -b file.bin

Create a C include file:: tinyxxd -i file.bin > file.h

Reverse a hex dump into binary:: tinyxxd -r dump.hex > file.bin

Exit status

0 - Success. 1-5 - Various errors (e.g., file I/O errors, invalid arguments).

Environment

NO_COLOR: If set, disables color output.

Caveats

Little-endian dumps: The -e option only affects the hexadecimal representation and not the ASCII (or EBCDIC) characters on the right side of the dump. The option is incompatible with -r, -p, or -i.

Reverse Operation (-r): The reverse operation may encounter difficulties with lines that are not formatted as expected. It will skip over non-conforming lines and continue processing. Line numbers are used for positioning when writing output, so the order and completeness of lines are important.

Version

tinyxxd 1.3.17