FindLCOV

Finds the coverage analysis tools from LCOV project.

Note

LCOV consists of several Perl scripts. As such, a Perl interpreter must also be available and is searched for using FindPerl module from the official CMake distribution.

Hints

This module reads hints about search locations from variables:

LCOV_ROOT

Preferred installation prefix.

Users may set these hints as normal CMake variables, cache entries or environment variables.

Imported Targets

This module provides the following imported targets, if found:

LCOV::LCOV

The lcov coverage data collector executable.

LCOV::GenHTML

The genhtml coverage report generator executable.

Result Variables

This will define the following variables:

LCOV_FOUND

True if the system has LCOV installed.

LCOV_VERSION

The version of LCOV which was found.

Cache Variables

The following cache variables may also be set:

LCOV_EXECUTABLE

The full path to lcov executable (including Perl interpreter).

GenHTML_EXECUTABLE

The full path to genhtml executable (including Perl interpreter).

Design note

Each script from LCOV project may depend on each other. From one version to another, these dependencies may change, and scripts may be added or removed. Consequenlty, to have a robust and maintanable find module, only the scripts that are actually useful from a user perspective and independant from each others will be searched for. Those scripts are lcov and genhtml. They must be both sucessfully located to consider that LCOV was found. In other words, they are not treated as components.