CVEXPRNT(1)							   CVEXPRNT(1)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     cvperf(1)

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111