# DUMP v1.30 - dump file contents in hex/decimal/octal

#### Revised 19-Aug-97. Copyright (c) 1996-97 by Rune Berg. TextTools Freeware.

Usage - Description - Example - Options - Return codes

### USAGE

dump [log logfile] [options] infile [to outfile]

### DESCRIPTION

dump writes the contents of infile in hex format (but see -d options).

If you don't specify outfile, dump writes to standard output.

### EXAMPLE

For the 1-line file "cc.bat" containing:

            tcc -g5 -j5  -I..\ttlib hd.c ..\ttlib\ttlib.lib

the command:

            dump -w8 cc.bat

prints:

            dump of "cc.bat" -- Mon Apr 01 04:32:26 1996

            00000000  74 63 63 20 2d 67 35 20  "tcc -g5 "
            00000008  2d 6a 35 20 20 2d 49 2e  "-j5  -I."
            00000016  2e 5c 74 74 6c 69 62 20  ".\ttlib "
            00000024  68 64 2e 63 20 2e 2e 5c  "hd.c ..\"
            00000032  74 74 6c 69 62 5c 74 74  "ttlib\tt"
            00000040  6c 69 62 2e 6c 69 62 0d  "lib.lib."
            00000048  0a 0d 0a 1a              "...."

where:

            <------>  <--------------------->  <-------->
            offsets   data in hex              data in ASCII
            in decimal

### OPTIONS

dump recognizes the following command line options:

Option | Function
--- | ---
-dd -dh -do | Show data in decimal, hex (default), or octal.
-wN | Show N bytes of data per output line. For -dh, N = 1..22 (default 16). For -dd, N = 1..16 (default 12). For -do, N = 1..16 (default 12).
-od -oh -oo | Show offsets in decimal (default), hex, or octal.
-no | Don't show offsets.
-na | Don't show data in ASCII.
-a | Show data in ASCII (default).
-sN | Begin dumping at byte N (0..2147483646) of infile.
-bN | Dump N (0..2147483646) bytes.
-nh | Don't show "dump of ..." header.
-v | Print version banner and usage info to standard error (or logfile, if given), then exit.

ASCII will not be shown if data format is hex and N > 16 for -wN.
ASCII will not be shown if data format is decimal and N > 12 for -wN.
ASCII will not be shown if data format is octal and N > 12 for -wN.

For -w1, ASCII display shows the names of unprintable characters.

For -wN when N > 1, ASCII display shows unprintable characters as '.'

### RETURN CODES

dump returns with one of the following codes ("error levels"):

Code | Meaning
--- | ---
0 | Success
102 | Incorrect command line arguments
104 | Error opening file
105 | I/O error
107 | File name clash
110 | Failed to get system date/time

##### End of document