                          DumpHex 1.0.1 Documentation

Table of Contents

    1. Introduction
    2. Installation
    3. Command line Options
    4. File List
    5. Online Information
    6. Return codes
    7. License and Warranty

1. Introduction

   DumpHex is a configurable Win32 Command line Hex Viewer for any kind
   of files.
   DumpHex allows you to change the amount of bytes dumped per line,
   whether the data should also be putted out as chars, and the replace
   character for non-printable chars.
   You may also set an start offset, the length of the hex dump and
   various other options effecting the format of the outputted data.
   With its capabilities of changing all settings, DumpHex is a very
   useful tool for programmers and software developers which have to
   handle binary files.

2. Installation

   Extract all files form the Archive containing DumpHex, and copy them
   into any directory (for example "C:\DumpHex").
   If you want to use DumpHex from any directory you should add the
   directory containing DumpHex (for example "C:\DumpHex") to your path
   environment variable.

3. Command line Options

   /s<hexStartOffset> Set startoffset (hexadecimal)
   /S<decStartOffset> Set startoffset (decimal)
   /l<Length> Length of the dump (hexadecimal)
   /L<Length> Length of the dump (decimal)
   /w<Width> Sets data output width (decimal,default=16)
   /O<Width> Sets offset output width (decimal,default=8)
   /r<x> Sets the replace char to <x> (default='.')
   Use SP for SPACE
   /o<Outfile> Redirect output to <Outfile>
   /nc Do not display character data
   /v Display version information
   /? or /h Show Command line usage

   You may use "-option" instead of "/option".

4. File List

   DumpHex.exe  DumpHex Executable
   DumpHex.txt  DumpHex Documentation (this file)
   DumpHex.html DumpHex Documentation 
   pad_file.xm  Portable Application Description (PAD) of DumpHex

5. Online Information

   DumpHex Website                        
    http://rbach.priv.at/DumpHex/
   DumpHex Documentation (latest version)
    http://rbach.priv.at/DumpHex/Documentation
   DumpHex Documentation (this version)  
    http://rbach.priv.at/DumpHex/Documentation-1.0.1
   Email Contact
    DumpHex@rbach.priv.at

   If you need support for DumpHex send an email to DumpHex@rbach.priv.at

   Feel free to send us comments, questions, ideas etc.
   You can write in English or German.

6. Return Codes

   Status value returned to parent process (if any) or the operating
   system:
   0 No error
   1 No comandline arguments given
   2 No filename given
   3 Invalid comandline argument given
   4 Error when opening/reading the inputfile
   5 Error creating outputfile

7. License and Warranty

TERMS and CONDITIONS:

   This License Agreement (the "Agreement") is a legal agreement
   between you, the end-user, and Robert Bachmann
   By using this software on a computer hard drive (or other media),
   you accept and are bound to the terms of this Agreement.

LICENSE:

    1. Home and commercial users, government, educational and non-profit
       organizations may:
       a) install this program on an unlimited number of computers.
       b) use this software for an unlimited amount of time.
    2. This software may be distributed freely as all files are
       distributed in their original form.
    3. You may not alter this software in any way, including
       a) changing or removing any messages.
       b) decompiling, disassembling or reverse-engineering this
       software.

COPYRIGHT:

   DumpHex is Copyright  2002 Robert Bachmann. All rights reserved.

DISCLAIMER OF WARRANTY:

   USERS OF DUMPHEX MUST ACCEPT THIS DISCLAIMER OF WARRANTY:
   THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SUPPLIED "AS IS".
   THE AUTHOR DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING,
   WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY OR OF FITNESS
   FOR ANY PURPOSE.

LIMITATION OF LIABILITY:

   THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL,
   WHICH MAY RESULT FROM THE USE OF DUMPHEX.
     _________________________________________________________________

   DumpHex 1.0.1 Documentation

   Copyright  2002, 2003 Robert Bachmann. All rights reserved.
   All trademarks are property of their respective owners.
