CVEXPRNT(1)                                                        CVEXPRNT(1)



NAME
     cvexprnt - print out the contents of WorkShop performance experiment
     records or data files

SYNOPSIS
     cvexprnt [ options ] {name1 ... nameN } ...

DESCRIPTION
     cvexprnt prints out the formatted contents of one or more WorkShop
     performance experiment directories or experiment data files.  Each of the
     files consists of a string of beads, as described in ../include/bead.h

     If the name is that of a directory, the file named DESC in that
     directory, and any other files named within it will be dumped.  If the
     name is that of a file, just the file will be dumped.

     Options are used to control the printing of the files.

     -d   Print detailed information for each bead.

     -h   Print out the hex contents of the body of each bead.

     -q   Suppress printing of those fields, such as process pid's, time
          stamps, and so forth, that will normally change from run to run.
          Used for QA work, to better enable comparisons of recorded
          experiments.

     -s <offset>
          Print only one bead at the location of the offset.

     -i <index>
          Print only one bead with the given index value.

SEE ALSO
     cvperf(1)

NOTES
     cvexprnt relies on the fact that experiment descriptor files are written
     such that the file containing the list of traps precedes any data files
     that have references to samples taken at a trap.  It thus can print the
     string describing the trap with each sample bead; if a trap list does not
     precede a data file, the traps are referred to by trap number only.
     Whenever cvexprnt reads a DESC or TRAP file, it reset its list.  If data
     files from one experiment are printed after a trap file from a different
     experiment, without the correct intervening DESC or TRAP file, the trap
     description lines will be incorrect.









                                                                        Page 1