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
DumpHex.html DumpHex Documentation (this file)
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 © 2003 Robert Bachmann. All rights reserved.
All trademarks are property of their respective owners.