Struct ProviderProxy

pub struct ProviderProxy { /* private fields */ }

Implementations

impl ProviderProxy

pub fn new(channel: AsyncChannel) -> Self

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

pub fn take_event_stream(&self) -> ProviderEventStream

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

Initialize tracing and prepare for writing trace records for events in the specified categories into buffer using fifo for signaling. 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) -> Result<(), Error>

Begin tracing.

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

There is no result. The provider must send a TRACE_PROVIDER_STARTED packet on fifo to indicate success/failure of starting.

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

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 a TRACE_PROVIDER_STOPPED packet on fifo. Note that multiple Start,Stop requests can be received between Initialize,Terminate.

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

Terminate tracing.

Tracing is stopped first if not already stopped. After tracing has fully terminated the provider must close both buffer and fifo to indicate to the trace manager that tracing is finished.

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

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

Trait Implementations

impl Clone for ProviderProxy

fn clone(&self) -> ProviderProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderProxy

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

Formats the value using the given formatter.

impl ProviderProxyInterface for ProviderProxy

type GetKnownCategoriesResponseFut = QueryResponseFut<Vec<KnownCategory>>

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

fn start(&self, options: &StartOptions) -> Result<(), Error>

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

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

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

impl Proxy for ProviderProxy

type Protocol = ProviderMarker

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.