License: This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or (at your
option) any later version. This program is distributed in the hope that it
will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

Usage: 

DUMP filename [/skip n] [/keep n] [/type c] [/address c] [/words] [/condense]
              [/compress] [/noascii] [/replace] [/width n] [/divider c]
              [/head] [/tail] [/lower]

  filename    Specifies the file to be dumped. If no file is specified then
              piped data is read from stdin.
  /skip n     Offset or address where dumping begins. Use a negative value to
              set an offset from the end of the file.
  /keep n     Number of bytes to be dumped.
  /type c     Format for displayed bytes (default hex). Code may be:
              h - hex, o - octal, d - decimal, u - unsigned decimal, c - char.
              When displaying in octal or decimal formats it will be necessary
              to increase the console width buffer or reduce the number of
              bytes per line with /width, to avoid line-wrap.
  /address c  Format for offset address marker (default hex). Code may be:
              h - hex, o - octal, u - unsigned decimal, n - no address.
  /words      Display byte data grouped in 2-byte words.
  /condense   Display bytes contiguously without spaces or divider.
  /compress   Display duplicate lines as an asterisk.
  /noascii    ASCII column will not be displayed.
  /replace c  Sets the replacement for non printable characters in the ASCII
              column, or the bytes area when using /type c. Use sp for space.
  /width n    Number of bytes to be displayed per line (default 16, max 128).
  /divider c  Specifies a divider character to be displayed in the middle of
              the line of bytes, when the number of bytes or 2-byte words on
              the line is even. Code may be: s - double space, - - hyphen.
  /head       Display first 64 bytes of the file only. Equivalent to /keep 64.
  /tail       Display last 64 bytes of the file only. Equivalent to /skip -64.
  /lower      Display alphabetic hex symbols in lowercase.

Bytes are dumped to the console. Use redirection to output to a file:
dump filename > output.txt

When no filename is specified, piped data from stdin will be dumped instead:
echo hello world! | dump
type main.c | dump

Numeric operands may be prefixed with 0x or 0X for a hex value or 0 for octal,
and appended with kb/mb/gb for kilobytes/megabytes/gigabytes respectively.
Syntax is case insensitive. Note that switches may be typed in shorthand:
/r instead of /replace. Where the typed switch is ambiguous, a warning will be
displayed and further characters will need to be typed to disambiguate.
You may precede the switch name with either / or -.

Dump is written in C to C99 standard in Pelles C for Windows.

© 2011 Thomas James
tmj2005@gmail.com