====
a8xd
====

--------------------------
Atari ASCII aware hex dump
--------------------------

.. include:: manhdr.rst

SYNOPSIS
========

*a8xd* [**-i**] [**-m**] [**-v**] [*infile*]

DESCRIPTION
===========

**a8xd** is a hex dump utility, similar to **xxd**\(1), but it
understands and prints ATASCII characters rather than ASCII.

The ATASCII codes are converted to UTF-8, in the same way as
**a8cat**\(1). Codes with the high bit set are displayed in inverse
video, using ANSI/VT-100 escape sequences.

By default, the output is colorized:

  - Normal characters are green. This includes alphanumerics, spaces, and
    punctuation.

  - Codes **$00** (null, or ATASCII heart) and **$9B** (EOL) are red.

  - Control characters are yellow. This includes codes **$01** to **$1F**,
    (control + letters, escape, punctuation, and arrow keys), **$60**, **$7B**, **$7D**
    (clear screen), **$7E** (backspace), and **$7F** (tab).

The colors and inverse rendering apply to both the ATASCII and hex bytes.

Without *infile*, or if *infile* is **-**, **a8xd** reads from standard input.

OPTIONS
=======

Options marked with **\*** are not yet implemented.

-i
  Print XL/XE International Character Set conversions instead of ATASCII.

-l *len*
  **\*** Stop after dumping *len* bytes. *len* may be given in decimal or hex (with
  leading *0x* or *$*).

-m
  Monochrome mode. Disables color, but ATASCII characters with the high bit
  set are still displayed in inverse.

-o *offset*
  Add *offset* to displayed file position. *offset* can be given in decimal
  or hex (with leading *0x* or *$*).

-s *[-]seek*
  **\*** Start at *seek* bytes. Without *-*, this is an absolute offset. With *-*,
  it's relative to the end of the file. The *-* option won't work when
  reading from standard input. *seek* may be given in decimal or hex
  (with leading *0x* or *$*).

-u
  Use uppercase letters for hex digits; the default is lowercase.

-v
  Verbose. Currently, this option is accepted, but it doesn't do anything yet.

**--**
  End of options; the nex argument is the filename. Use this if you're
  trying to work with files whose names begin with *-*.

**-h**, **--help**
  Show built-in help and exit.

**--version**
  Show version number and exit.

NOTES
=====

**a8xd** supports a useful subset of **xxd**\(1) options. The main things
missing are:

- **-r** (revert).

- **-include** (output as C include) and all options related to it.

- **-g** (grouping; **a8xd** always uses a group size of 1 byte).

- **-E** (EBCDIC mode).

- **-p** (PostScript/continuous dump).

- **-cols** (**a8xd** only supports 16 column dumps).

- **-b** (bits mode).

.. include:: manftr.rst