Forrest logo
tool overview
On this page you find all important commands for the CLI tool gcov. If the command you are looking for is missing please ask our AI.

gcov

Gcov is a command-line tool used in C and C++ programming for analyzing code coverage. It belongs to the GNU project and is primarily used along with the GNU Compiler Collection (GCC).

Gcov collects the execution count of each line of code during program execution and generates a coverage report. This report provides insights into how extensively different parts of the code have been tested.

By enabling code coverage analysis, developers can identify areas of the code that require more testing and ensure that their test suite provides adequate coverage. This helps in improving the reliability and quality of the software.

In order to use gcov, the code needs to be compiled with the necessary options to enable coverage data collection. Once the executable is run, gcov produces a set of files that contain coverage data for each source file in the program.

The generated coverage information includes the number of times each line of code is executed, along with additional statistics such as branch coverage and function coverage.

Gcov can be used in conjunction with other tools, such as gcovr or lcov, to generate more detailed coverage reports with code highlighting and graphical representation.

One of the advantages of gcov is that it is lightweight and does not introduce significant overhead in terms of runtime performance.

Gcov supports several options for customizing the coverage analysis, including filtering based on file or function names, excluding specific directories, and generating output in different formats.

The coverage reports generated by gcov can be integrated into continuous integration workflows to ensure test coverage remains high and to identify regressions.

Overall, gcov is a powerful tool for developers to analyze code coverage, identify untested areas, and improve the quality and reliability of their software.

List of commands for gcov:

  • gcov:tldr:0765c gcov: Write individual execution counts for every basic block.
    $ gcov --all-blocks ${filename-cpp}
    try on your machine
    explain this command
  • gcov:tldr:20087 gcov: Write branch frequencies to the output file and print summary information to `stdout` as a percentage.
    $ gcov --branch-probabilities ${filename-cpp}
    try on your machine
    explain this command
  • gcov:tldr:3fad2 gcov: Write file level as well as function level summaries.
    $ gcov --function-summaries ${filename-cpp}
    try on your machine
    explain this command
  • gcov:tldr:504ee gcov: Generate a coverage report named `file.cpp.gcov`.
    $ gcov ${filename-cpp}
    try on your machine
    explain this command
  • gcov:tldr:5bf2c gcov: Do not create a `gcov` output file.
    $ gcov --no-output ${filename-cpp}
    try on your machine
    explain this command
  • gcov:tldr:9f849 gcov: Write branch frequencies as the number of branches taken, rather than the percentage.
    $ gcov --branch-counts ${filename-cpp}
    try on your machine
    explain this command
tool overview