Struct ProviderV2Proxy 

pub struct ProviderV2Proxy { /* private fields */ }

Implementations

impl ProviderV2Proxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.tracing.provider/ProviderV2.

pub fn take_event_stream(&self) -> ProviderV2EventStream

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, config: ProviderConfigV2) -> Result<(), Error>

Initialize tracing and prepare for writing trace records for events in the specified categories into buffer. Tracing hasn’t started yet, a Start() call is still required.

At most one trace can be active at a time. Subsequent Initialize() requests received prior to a Terminate() call must be ignored.

pub fn start( &self, options: &StartOptions, ) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

Begin tracing.

If tracing has already started the provider must ignore the request.

pub fn stop(&self) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

Stop tracing.

If tracing has already stopped the provider must ignore the request.

Once the provider has finished writing any final events to the trace buffer, it must send an OnStopped() event. Note that multiple Start,Stop requests can be received between Initialize,Terminate.

pub fn terminate(&self) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

Terminate tracing.

Tracing is stopped first if not already stopped.

pub fn get_known_categories( &self, ) -> QueryResponseFut<Vec<KnownCategory>, DefaultFuchsiaResourceDialect>

Gets the trace categories that might be produced by this provider.

pub fn notify_buffer_saved( &self, wrapped_count: u32, durable_data_end: u64, ) -> Result<(), Error>

A buffer has been saved (streaming mode only).

pub fn flush(&self) -> Result<(), Error>

Requests the provider its buffer to be read out, regardless of it is full or not.

Normally streaming mode only sends data once it has enough data to require a buffer swap and data flush. This produces fewer, but larger and bursty data transfers.

Some clients may want more regular smaller data transfers. These clients may instead manually invoke Flush whenever they are ready for data.

Trait Implementations

impl Clone for ProviderV2Proxy

fn clone(&self) -> ProviderV2Proxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderV2Proxy

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

Formats the value using the given formatter.

impl ProviderV2ProxyInterface for ProviderV2Proxy

type StartResponseFut = QueryResponseFut<()>

type StopResponseFut = QueryResponseFut<()>

type TerminateResponseFut = QueryResponseFut<()>

type GetKnownCategoriesResponseFut = QueryResponseFut<Vec<KnownCategory>>

fn initialize(&self, config: ProviderConfigV2) -> Result<(), Error>

fn start(&self, options: &StartOptions) -> Self::StartResponseFut

fn stop(&self) -> Self::StopResponseFut

fn terminate(&self) -> Self::TerminateResponseFut

fn get_known_categories(&self) -> Self::GetKnownCategoriesResponseFut

fn notify_buffer_saved( &self, wrapped_count: u32, durable_data_end: u64, ) -> Result<(), Error>

fn flush(&self) -> Result<(), Error>

impl Proxy for ProviderV2Proxy

type Protocol = ProviderV2Marker

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<'_, NullableHandle>>

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