29.4. Test Coverage Examination

Note: At present, this section is just taken from PostgreSQL documentation and is subject to revision for Postgres-XC.

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 the gcov and lcov programs.

A typical workflow would look like this:

./configure --enable-coverage ... OTHER OPTIONS ...
gmake
gmake check # or other test suite
gmake coverage-html

Then point your HTML browser to coverage/index.html. The gmake commands also work in subdirectories.

To reset the execution counts between test runs, run:

gmake coverage-clean