32.5. Test Coverage Examination
Prev | Up | Chapter 32. Regression Tests | Home | Next

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

A typical workflow would look like this:

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

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

If you don't have `lcov` or prefer text output over an HTML report, you can also run

    make coverage

instead of `make coverage-html`, which will produce `.gcov` output files for each source file relevant to the test. (`make coverage` and `make 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

Prev | Up | Next
32.4. TAP Tests | Home | Part IV. Client Interfaces