32.5. Test Coverage Examination
The PostgreSQL source code can be compiled with coverage testing instrumentation, so that it becomes possible to examine which parts of the code are covered by the regression tests or any other test suite that is run with the code. This is currently supported when compiling with GCC and requires thegcov andlcov programs.
A typical workflow would look like this:
./configure --enable-coverage ... OTHER OPTIONS ...makemake check # or other test suitemake coverage-html
Then point your HTML browser tocoverage/index.html. Themake commands also work in subdirectories.
If you don't havelcov or prefer text output over an HTML report, you can also run
make coverage
instead ofmake coverage-html, which will produce.gcov output files for each source file relevant to the test. (make coverage andmake coverage-html will overwrite each other's files, so mixing them might be confusing.)
To reset the execution counts between test runs, run:
make coverage-clean