Struct CoverageDataCollectorProxy

pub struct CoverageDataCollectorProxy { /* private fields */ }

Implementations

impl CoverageDataCollectorProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.fuzzer/CoverageDataCollector.

pub fn take_event_stream(&self) -> CoverageDataCollectorEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn initialize( &self, eventpair: EventPair, process: Process, ) -> QueryResponseFut<Options, DefaultFuchsiaResourceDialect>

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.

pub fn add_inline8bit_counters( &self, inline_8bit_counters: Vmo, ) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

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

Trait Implementations

impl Clone for CoverageDataCollectorProxy

fn clone(&self) -> CoverageDataCollectorProxy

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CoverageDataCollectorProxyInterface for CoverageDataCollectorProxy

type InitializeResponseFut = QueryResponseFut<Options>

type AddInline8bitCountersResponseFut = QueryResponseFut<()>

fn initialize( &self, eventpair: EventPair, process: Process, ) -> Self::InitializeResponseFut

fn add_inline8bit_counters( &self, inline_8bit_counters: Vmo, ) -> Self::AddInline8bitCountersResponseFut

impl Debug for CoverageDataCollectorProxy

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

Formats the value using the given formatter.

impl Proxy for CoverageDataCollectorProxy

type Protocol = CoverageDataCollectorMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.