class CoverageDataCollector

Defined at line 8795 of file fidling/gen/src/sys/fuzzing/fidl/fuchsia.fuzzer/hlcpp/fuchsia/fuzzer/cpp/fidl.h

Collects VMOs used to share code coverage from instrumented target processes.

The instrumented target processes act as clients to this protocol, which is implemented by

test_manager's fuzz_coverage component. The protocol coordinates feedback collection and other

diagnostics with target processes under test. The connection should be established very early in

a target process's lifecycle, i.e. before `main` begins.

Public Members

static const char[] Name_

void ~CoverageDataCollector ()

void Initialize (::zx::eventpair eventpair, ::zx::process process, InitializeCallback callback)

Registers the instrumented target process.

This method is called once per connection to set up:

* The eventpair used to synchronize the start and end of code coverage collection.

* The process Handle used to monitor the target process for errors.

This method must be called before the target process can call `AddLlvmModule`.

It returns the currently set options; see `fuchsia.fuzzer.Controller/Configure`.

Certain options determine sanitizer behaviors before `main` is called, and cannot

subsequently be changed while the target process is running. This is the root cause of the

constraint in `Controller` against modifying options during "long-running workflows", i.e

those that spawn target processes.

The channel is closed on FIDL error. Clients should not attempt to reconnect.

void AddInline8bitCounters (::zx::vmo inline_8bit_counters, AddInline8bitCountersCallback callback)

Adds a VMO with the code coverage of an LLVM module.

The VMO used to share inline 8-bit code-coverage edge counters for a single LLVM module in

an instrumented target process.

Its ZX_PROP_NAME property must be set, and client and server implementations must agree on

how to use it to uniquely identify the module. If the same module is added more than once by

different processes, the module identifiers must match so that the code counters can be

combined.

Its ZX_PROP_VMO_CONTENT_SIZE property must be set to the actual number of counters present.

It is an error to call this method without first calling |Initialize|.

The channel is closed on FIDL error. Clients should not attempt to reconnect.