DumpHex: Documentation

Introduction
Installation
Command line Options
File List
Online Information
Return codes
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 can be a 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:

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.
This software may be distributed freely as all files are distributed in their original form.
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:

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