NAME

  bldump - simple decimal, hex dump with Binary, Text, CSV.. 

SYNOPSYS

  bldump [<options>] [<infile> [<outfile>]]

DESCRIPTION

  The options are as follows: 

OPTIONS

  <infile>
    Dump file.

  <outfile>
    Output file name. if not specified, output stdout.

  -f <num>, --fields=<num>
    The number of data fields of displaying at a line(default:16).

  -l <num>, --length=<num>
    The number of data bytes of displaying(default:1).

  -r <order>, --reorder=<order>
    Change byte-order of the input data.
    <order> consists of 0-7.

  -s <num>, --start-address=<num>
    Skip <num> bytes from the beggining of the inputs.

  -S <hex>, --search=<hex>
    Skip data to searching for <hex> pattern.

  -e <num>, --end-address=<num>
    Stop reading data reached to the <num> address.

  -i, --decimal
    Displays decimal.

  -u, --unsigned
    Displays unsigned decimal.

  -A, --ascii
    Displays character.


  -b, --binary
    Outputs binary.

  -a, --show-address
    Display data address preceded each line.
    if not specified, doesn't display.

  -d <str>, --delimitter=<str>
    The field delimitter character(default:' ').

  -v <num>, --verbose=<num>
    Verbose mode(default:3).

  -h -? --help
    Display command line help message, and exit application.

  --version
    Display bldump version, build date.

EXAMPLES

  bldump -a <infile>
    Display hexadecimal dump with address. 

    $ echo -n "0123456789ABCDEFGHIJK" > exp.txt
    $ ./bldump -a exp.txt 
    00000000: 30 31 32 33 34 35 36 37 38 39 41 42 43 44 45 46
    00000010: 47 48 49 4a 4b 0a

  bldump -i -d , <infile>
    Display csv text.

    $ echo -n "0123456789ABCDEFGHIJK" > exp.txt
    $ ./bldump -i -d , exp.txt 
    48,49,50,51,52,53,54,55,56,57,65,66,67,68,69,70
    71,72,73,74,75

  bldump -r3210 <infile>
    Change little endian to big endian.

    $ echo -n '01234567' > t-bldump.tmp 
    $ ./bldump -r 3210 t-bldump.tmp 
    33323130 37363534

  bldump -l 2 -f 1 -S 20 -a <infile>
    Display hexadecimal text contained the space.
    $ echo 'ABC DEF GHI JKL' > t-bldump.tmp
    $ ./bldump -l 2 -f 1 -S 20 -a t-bldump.tmp
    00000003: 2044
    00000007: 2047
    0000000b: 204a

INSTALLATION

  type 'make test' to run unit tests.
  If results of unit test have any failures, you shouldnot
  use bldump in this version.

  type 'make clean all' to build 'bldump'.
  and move 'bldump' to your directory manually.

HISTORY

  v.1.0.1
    * Modified wrong byte order of searched data reordering.

  v.1.0
    * '-A' display character.

  v.0.3
    * '-b' output binary.
    * '-r' change byte-order of the input data.
    * '-S' skip data to searching for <hex> pattern

  v.0.2
    * '-l,-f' set size of data and number of fields
    * '-a' display data address of inputs.
    * '-s' set skip size from the beggining of the inputs.
    * '-d' set the field delimitter character.
    * '-i' display decimal ints.

  v.0.1
    * hexadecimal display
    * '-h,-?,--help' display help message.
    * added test feature - splint, CUnit add gcov.