# gcov

> Code coverage analysis and profiling tool that discovers untested parts of a program.
> Also displays a copy of source code annotated with execution frequencies of code segments.
> More information: <https://gcc.gnu.org/onlinedocs/gcc/Invoking-Gcov.html>.

- Generate a coverage report named `file.cpp.gcov`:

`gcov {{path/to/file.cpp}}`

- Write individual execution counts for every basic block:

`gcov {{[-a|--all-blocks]}} {{path/to/file.cpp}}`

- Write branch frequencies to the output file and print summary information to `stdout` as a percentage:

`gcov {{[-b|--branch-probabilities]}} {{path/to/file.cpp}}`

- Write branch frequencies as the number of branches taken, rather than the percentage:

`gcov {{[-c|--branch-counts]}} {{path/to/file.cpp}}`

- Do not create a `gcov` output file:

`gcov {{[-n|--no-output]}} {{path/to/file.cpp}}`

- Write file level as well as function level summaries:

`gcov {{[-f|--function-summaries]}} {{path/to/file.cpp}}`