Changeset add6b31 in mod_gnutls


Ignore:
Timestamp:
Jun 27, 2020, 5:19:51 AM (4 months ago)
Author:
Fiona Klute <fiona.klute@…>
Branches:
master
Children:
e63515a
Parents:
30b23d6
Message:

Documentation for building coverage reports

Files:
2 edited

Legend:

Unmodified
Added
Removed
  • CHANGELOG

    r30b23d6 radd6b31  
    1414
    1515- Support session resumption using session tickets for proxy
    16   connections (TLS 1.3 connections only).
     16  connections (TLS 1.3 connections only). Requires a suitable
     17  GnuTLSCache configuration.
    1718
    1819- Disable session tickets by default. The GnuTLS built-in key rotation
     
    2728
    2829- Deprecate SRP and disable it by default.
     30
     31- Add support for building coverage reports using clang's source-based
     32  code coverage.
    2933
    3034- Make ./configure check if both [::1] and 127.0.0.1 are available,
  • test/README.md

    r30b23d6 radd6b31  
    168168
    169169
     170## Coverage reports
     171
     172You can create test coverage reports using [clang's source-based code
     173coverage](https://clang.llvm.org/docs/SourceBasedCodeCoverage.html). This
     174requires two things:
     175
     1761. Use the clang compiler to build the module (e.g. `CC=clang`).
     1772. Pass `--enable-clang-coverage` to `./configure`, which adds the
     178   required `CFLAGS` to the build.
     179
     180This will build mod\_gnutls with clang profiling instrumentation, and
     181generate profiling data during tests. **Do not use a profiling build
     182for production!**
     183
     184The gathered profiling data can then be compiled into a coverage
     185report using `make coverage` (in this directory). The coverage report
     186will be in [`coverage/index.html`](coverage/index.html). So the full
     187process to build a coverage report might be, including opening the
     188report (in this example using Firefox):
     189
     190```bash
     191CC=clang ./configure --enable-clang-coverage
     192make check
     193cd test
     194make coverage
     195firefox coverage/index.html
     196```
     197
     198If you'd like to work with the profiling data yourself, you can find
     199the raw data in `outputs/coverage/`, the indexed and merged data in
     200`outputs/coverage.profdata`.
     201
     202
    170203## Adding a Test
    171204
Note: See TracChangeset for help on using the changeset viewer.