CVCOV(1)CVCOV(1)


NAME
     cvcov - The WorkShop Test Coverage Tool

SYNOPSIS
     cvcov -ver subcommands

IMPLEMENTATION
     IRIX systems

DESCRIPTION
     cvcov invokes the command line version of the WorkShop Tester dynamic
     test coverage tool.  cvxcov invokes the GUI version of the same tool.
     All functionality is available from either program.  Some of the
     graphical representations of the data will be available only from
     cvxcov.

     For more information on using cvcov, see the ProDev WorkShop: Tester
     User's Guide.  For installation of cvcov refer to the WorkShop Release
     Notes.

     This man page provides only a brief overview of the subcommands to
     cvcov. For details about each subcommand and the options for those
     subcommands, see the ProDev WorkShop: Tester User's Guide.

   General Test Commands
     * cattest: Describes the test details for test_name.

     * lsinstr: Displays the instrumentation information for a particular
       test.

     * lstest: Lists the coverage tests.

     * mktest: Creates a test directory which contains a Test Description
       File.

     * rmtest: Removes the test with the test_name specified.

     * runinstr: Instruments the user executable based on the user
       selectable criteria.

     * runtest: Runs a test or a test set.

   Coverage Analysis Commands
     * lssum: Lists the summary of overall coverage for this run. Also
       lists the function, line, arc, branch, and block coverage.

     * lsfun: Lists function coverage.

     * lsblock: Lists basic block count information in the function.
       Blocks are shown as line number sequences.

     * lsbranch: Lists count information for assembly language branch
       instructions.

     * lsarc: Lists function arcs coverage. Arcs are calls from one
       function to another.

     * lscall: Lists function call graph.

     * lsline: Lists the coverage for native source lines.

     * lssource: Displays source for function with line count (block count)
       information.  0 counted lines are highlighted.

     * diff : Lists the differences in two test experiments.

   Test Set and Test Group Commands
     * addtest: Adds the test or test set to the specified test set.

     * deltest: Deletes the test or test set from the specified test set.

     * mktgroup : Creates a test group which can contain other tests or
       test groups.  A test group is a collection of programs which share
       some libraries or dynamically shared objects in common.  The
       coverage is targeted for the shared libraries.

     * mktset: Creates a test set which can contain other tests or test
       sets as subtests.  Specify the test set name, otherwise the command
       automatically assigns a test name for the test set.

     * optimize: Choose the minimum set of tests that give the same
       coverage or meet the given coverage criteria.

   Other Commands
     * help: Prints help on the specified command. If the optional command
       name is not specified, it prints help for all the commands.

     * -ver: Prints the program version to stdout.

EXAMPLES
     The following command lines illustrate a typical use example of the
     cvcov command:

          $ cc -g test.c

          Instrument the user executable.

          $ cvcov runinstr a.out

          Create a test set.

          $ cvcov mktest -cmd a.out

          Run a test or a test set.

          $ cvcov runtest test0000

          Display the output.

          $ cvcov lssource main test0000

FILES
     /usr/lib/X11/app-defaults/Cvxcov

     Application defaults for GUI program, cvxcov.

     /usr/WorkShop/usr/lib/WorkShop/Tester/default_instr_file

     Default instrument file.

SEE ALSO
     cvxcov(1), cvd(1), cvinstr(1), cvperf(1), cvxhang(1)

     ProDev WorkShop: Tester User's Guide