Enum CoverageDataCollectorRequest

pub enum CoverageDataCollectorRequest {
    Initialize {
        eventpair: EventPair,
        process: Process,
        responder: CoverageDataCollectorInitializeResponder,
    },
    AddInline8bitCounters {
        inline_8bit_counters: Vmo,
        responder: CoverageDataCollectorAddInline8bitCountersResponder,
    },
}

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.

Variants

Initialize

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.

Fields

eventpair: EventPair

process: Process

responder: CoverageDataCollectorInitializeResponder

AddInline8bitCounters

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.

See also: https://clang.llvm.org/docs/SanitizerCoverage.html#inline-8bit-counters

Fields

inline_8bit_counters: Vmo

responder: CoverageDataCollectorAddInline8bitCountersResponder

Implementations

impl CoverageDataCollectorRequest

pub fn into_initialize( self, ) -> Option<(EventPair, Process, CoverageDataCollectorInitializeResponder)>

pub fn into_add_inline8bit_counters( self, ) -> Option<(Vmo, CoverageDataCollectorAddInline8bitCountersResponder)>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for CoverageDataCollectorRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.