How to compile & run SBC-related programs

*****************************************

Note: All programs are tested on x86 Linux.

1. Compilation
--------------
--------------

din_plus2sbc.c, sbc2din_plus.c, and sbc2din.c are self-contained programs.

The compilation is trivial, e.g., gcc -o3 din_plus2sbc.c -o din_plus2sbc.

dinero4sbc.tgz includes following files:

sbcfmt.c
sbcfmt.h
tracein.h
tracein.c
cmdmain.c
cmdargs.c
cmdargs.h
Makefile.in

The steps to install these modifications:

1) Unpack the original dineroIV tar (d4-7.tar)
2) Unpack dinero4sbc.tgz
3) Run ./configure
make
(as explained in dinero README)

2. Arguments
--------------
--------------

din_plus2sbc.c
--------------

trace_name file_num1 file_num2 FIFO_size

Converts to sbc dinero+ traces trace_name.i.bin.gz, where i = file_num1 to

file_num2.
FIFO_size is the size of the FIFO buffer for data address compression.

Example: din_plus2sbc vortex_f2b 1 100 4000

sbc2din_plus.c
--------------

trace_name file_num1 file_num2 0/1

Converts to dinero+ sbc traces T1.trace_name.I.i.bin.gz, C3.trace_name.I.i.bin.gz,

where i = file_num1 to file_num2.
Last argument must be 0 or 1 - 0 if we want only binary dinero+ trace format,
and 1 if we also want ASCII format.

Example: sbc2din_plus vortex_f2b 1 101 0

sbc2din.c
---------

Same arguments as sbc2din_plus.c

Example: sbc2din vortex_f2b 1 101 0

dineroIV
---------

Additional arguments and argument options:

-informat s : SBC trace format

-maxtrace : max SBC trace file number, reads from 1 to maxtrace
-trname : trace name, as above

Example:
dineroIV -informat s -trname vortex_f2b -maxtrace 101 -l1-isize 16K -l1-dsize 16K
-l1-ibsize 32 -l1-dbsize 32