Initial commit of OpenSPARC T2 architecture model.

[OpenSPARC-T2-SAM] / sam-t2 / docs / trconv.txt

Usage: trconv [flags] [input-file]

(Version 1.5) Prints and converts various trace formats.

Format flags:
  -from FX       = assume input data is in format FX
  -to FX         = generate output format FX
  where FX is one of the following: 
    shade5       = Shade5 format
    shade6x32    = Shade6 format, using 32 bit addresses
    shade6x64    = Shade6 format, using 64 bit addresses
    rabin        = Rabin's infamous format
    rst          = (RQ's) really simple trace format (Default -from)
    null         = (only for "-to FX"), do not convert (Default -to)
Selection flags:
  -n N           = stop after processing N records
  -n Ni          = stop after processing N instructions
  -s N           = skip the first N records
  -s Ni          = skip the first N instructions
  -pc=pc1[,pc2]  = only process instructions w/ pc=pc1 (or [pc1,pc2])
  -ea=ea1[,ea2]  = only process instructions w/ ea=ea1 (or [ea1,ea2])
  -cpu=cpu1[,cpu2,...] = only process records from selected cpu's
                   Example: -cpu=m,n-q,p selects records from 
                   cpu's m, p, and all cpu's from n through q
Printing flags:
  -a             = print in trace record field format
  -d             = print in instruction disassembly format (Default)
  -x             = print verbose output format
  -nid           = suppress trace index in output
  -c             = only count records from the trace file
  -pa            = print both VA and PA of effective address
  -sym [file]    = read and use symbols from 'file'
  -vt            = print registers in value trace format
Verification flags:
  -nv            = do not verify pc values in trace file
  -e             = only check for ihash errors
  -fast          = turn off all verification and patching options
RST flags:
  -i             = only process RST instruction records
  -ic            = like -i, but counts only instructions
  -ni            = do not process any RST instruction records
  -nic           = like -ni, but counts only non-instructions
  -rstdump || -r = macro for: -from rst -to null -d (Default)
  -nobranch      = do not verify branch ea's against disassembly
  -nopc_pavadiff = do not verify rstf_pavadiffT.pc_pa_va field
  -noea_pavadiff = do not verify rstf_pavadiffT.ea_pa_va field
  -pstate_am 0|1 = set initial PSTATE.AM bit to 0 or 1 (Default: 0)
Patching flags:
  -patchcleanrst = clean up "dirty" ea value to be RSTF_NOADDR in RST trace
  -patchihash    = forces ihash value generation
Output flags:
  -stdout        = output to standard out (Default)
  -o File        = output to File
Miscellaneous:
  -help || -h    = print this message and exit
  -version || -v = print version and exit

Default flags are: -from rst -to null -d -stdout.
(By default Spix5 ihash values are assumed for all trace formats
*including* Shade6 traces...)

Examples:
   % trconv < rstfile
   (print disassembled RST trace instructions)

   % trconv -from rst [-to null] -s 1000i -patchihash rstfile
   (print trace records, skip first 1000 instructions)

   % trconv -r -pc=0x12345678,0x22222222 rstfile
   (print disassembled RST trace instructions with pc values within 
   [0x12345678 0x22222222])