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 (hex)
 /S<decStartOffset> Set startoffset (dec)
 /l<Lenght>         Length of the dump (hex)
 /L<Lenght>         Length of the dump (dec)
 /w<Width>          Sets data output width   (dec,default=16)
 /O<Width>          Sets offset output width (dec,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 usage

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

4. File List

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

5. Online Information

  DumpHex Website
    http://www.rbmp-soft.com/tools/dumphex
  DumpHex Documentation (latest version)
    http://www.rbmp-soft.com/docs/dumphex
  DumpHex Documentation (this version)
    http://www.rbmp-soft.com/docs/dumphex101.txt
  DumpHex Forum
    http://www.rbmp-soft.com/forum/dumphex
  Email Contact  
    contact@rbmp-soft.com

 If you need support for DumpHex you can post in the DumpHex Forum
 or send an email to contact@rbmp-soft.com

 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  2003 Robert Bachmann. All rights reserved.
All trademarks are property of their respective owners.
