README file for xd version 2.01

Copyright (c) 1992, 2000 by Jörg Heitkötter. All rights reserved.


USER COMMANDS                                               XD(1)

NAME
     xd - simple hex dump utility

SYNOPSIS
     xd [options] ...

     The options are:
          `--ascii'  or `-a', `--bytes' or `-b', `--delimiter' or
          `-d', `--formfeed' or `-f', `--help' or `-h',  `--high-
          endian'   or   `-X',  `--output  FILE'  or  `-o  FILE',
          `--shorts' or `-x', `--stats'  or  `-s',  `--strip'  or
          `-i',  `--title'  or `-t', `--verbose' or `-v', `--ver-
          sion' or `-V', `--words' or `-w', `--warranty' or `-W'.

DESCRIPTION
     Xd  is a simple hex dump utility, which is similar to od(1).
     It takes a couple of input files and dumps them to a 3  col-
     umn  output  format (see EXAMPLES below), adding headers and
     footers, depending on the options its been given.

OPTIONS
     xd recognizes the following options:

     -a, --ascii
          to print an ASCII bar of the ASCII representable  char-
          acters in the file.

     -b, --bytes
          to print the hexadecimal part in 8 bit bytes instead of
          short words

     -d, --delimiter CHAR
          to  specify  the  3rd  column   delimiting   character.
          Defaults to `"'.

     -f, --formfeed
          to  print a FF/Formfeed character between output files.

     -h, --help
          to print this information.

     -i, --strip
          to strip the 8th bit from in input file.

     -o, --output FILE
          to specify the output FILE.  If you do not  specify  an
          output  file,  the  program  writes to stdout.  If FILE
          already exists, new stuff is appended.

     -s, --stats
          to  print  statistical  information  about  the  dumped
          file(s).

Version 2.01        Last change: January 2000                   1

USER COMMANDS                                               XD(1)

     -t, --title
          to print a title on top of each dumped file.

     -v, --verbose
          to print information about what is being done.

     -V, --version
          to print version and COPYRIGHT information.

     -w, --words
          to print the hexadecimal part in native long words

     -W, --warranty
          to print WARRANTY information.

     -x, --shorts
          to print the hexadecimal part in native short words

     -X, --highendian
          to  print  the  hexadecimal  part  in highendian 16 bit
          words

SEE ALSO
     od(1).

EXAMPLES
     Dump file xd on an Ultra 5 Solaris 2.6 box:
          example% xd -fist xd

     will prompt you with:

          *** xd ***

          000000:  7f45 4c46 0102 0100 0000 0000 0000 0000  ".ELF............"
          000010:  0002 0002 0000 0001 0001 0ce4 0000 0034  "...........d...4"
          ...
          003860:  0000 0000 0000 3309 0000 013b 0000 0000  "......3....;...."
          003870:  0000 0000 0000 0001 0000 0000            "............"

          total 14460 (00387c) bytes
          ^L

BUGS
     Surely  you're  joking,  kid?  Okay,  okay!  Egil  Kvaleberg
     <egil@kvaleberg.no> found some and provided additional func-
     tionality.

AVAILABILITY
     Xd has been posted to USENET's  alt.sources  and  is  conse-
     quently available from your local netnews archive.

Version 2.01        Last change: January 2000                   2

USER COMMANDS                                               XD(1)

AUTHOR
     Xd has is copyright (c) 1992, 2000 by Joerg Heitkoetter. All
     rights reserved.  Send bugs, comments,  and  all  the  usual
     fish to joke@de.uu.net.

WARRANTY
     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 2 of the License, or (at your option) any later ver-
     sion.

     This program is distributed in the hope that it will be use-
     ful, but WITHOUT ANY WARRANTY; without even the implied war-
     ranty  of  MERCHANTABILITY  or FITNESS FOR A PARTICULAR PUR-
     POSE.  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, 59 Temple Place--Suite 330, Boston, MA
     02111-1307, USA.

Version 2.01        Last change: January 2000                   3