gcov960 Coverage Analyzer

gcov960 produces basic-block coverage analysis of a program. When a program is compiled with the fdb compiler driver option, a corresponding database directory is created. Whenever the program is executed, test coverage information is recorded in a profile file called default.pf. Subsequent runs will overwrite this file; use gmpf960 to merge profiles.

gcov960 takes optional source files and module names as arguments. It reads the source file and produces an annotated listing of the source file with the coverage data in file.cov (if the rl option is used). Each statement within a basic block is prefixed with the number of times it has been executed. Lines that have not been executed are prefixed with ########.

The gcov960 coverage invocation command is:

gcov960 [ -control ]... [ file [=module,...]...] [ -option ]...

gcov960 controls and options are described below. Each option must be preceded by a - character. (On DOS, you can also use a / character.)

file identifies a source file, from the profiled program represented in the program database. Specifying file=module,... restricts the operation of gcov960 to the file or module(s).

Controls

• c { p | m | f | s }
  • cp Produces a program-level coverage report.
  • cm Produces module- and program-level coverage report.
  • cf Produces function-, module-, and program-level coverage report.
  • cs Produces a source- and module-level coverage report.
• f n
  Produces the n most and least frequently executed lines. If the n specified is negative, it reports the least frequently executed lines. When used with rl, the report is attached to the source-annotated listing.
• g [h]
  Produces a call-graph listing of the profiled program. h is optional; it attaches an explanation of how to interpret the call-graph listing to the report.
• n new-profile
  Compares two profile files. The files default.pf or the file specified in p or iprof options are compared against the new-profile file and a just-hit or just-missed lines are reported. The r control is required with n.
• r { l | h | m }
  • rl Produces a source-annotated listing.
  • rh Produces the line numbers within basic blocks that were hit.
  • rm Produces the line numbers within basic blocks that were missed.

Options

• C
  Calculates the total number of execution counts in a profile file.
• help
  Prints a help message.
• I search-dir
  Adds the directory to the list of paths gcov960 searches for source files.
• p | iprof file
  Specifies the profile information file. If this option is not specified, default.pf is used.
• Q[n]
  As n goes from 0 to 9, Qn means to ignore hits except from functions are of increasing accuracy (decreasing amounts of interpolation). The default is Q9, which means to ignore hits for all functions except those with perfect profiles. Q0 means to not ignore hits from any functions, even those with completely guessed profiles.
  A profile's quality gradually drops as changes are made to the code it was collected from and interpolation is done to make it useable by gcc960, ic960, and gcdm960.
• q
  Suppresses display of version, copyright notices, profile file and database used.
• t
  Truncates displayed names to keep them within column widths.
• V
  Prints the version number and continues.
• v960
  Prints the version number and exits.
• Z pdb_dir
  Specifies the program database directory.

Return to the top of this page.

Go to the ic960 Interface Index.

Go to the gcc960 Interface Index.