Struct RollingPacketCaptureProxy 

pub struct RollingPacketCaptureProxy { /* private fields */ }

Implementations

impl RollingPacketCaptureProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.net.debug/RollingPacketCapture.

pub fn take_event_stream(&self) -> RollingPacketCaptureEventStream

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

Panics

Panics if the event stream was already taken.

pub fn detach(&self, name: &str) -> Result<(), Error>

Detaches the lifetime of this protocol from the underlying packet capture.

After calling Detach, closing the client end no longer results in the packet capture from being terminated. The passed string names this packet capture and can be used once to reconnect via [PacketCaptureProvider.ReconnectRolling]. This gives the client the option of ensuring the packet capture is resilient against disconnections.

Detach can be called multiple times, but only the name passed in the most recent call is valid and previously passed names are invalidated.

pub fn stop_and_download( &self, channel: ServerEnd<FileMarker>, ) -> Result<(), Error>

Stop and make this rolling packet capture downloadable.

It is implicit by calling this method that the packet capture is stopped due to user request, so the [RollingPacketCapture.OnEnded] event is not emitted.

This method can be called multiple times, including across disconnects: a client can call this method, disconnect, reconnect, and call this method again.

The server discards the contents of the packet capture once this method has been called and there is no client connected to this protocol for some time.

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

Discard this rolling packet capture.

Clients should call this method when they have successfully downloaded the packet capture, or if they no longer need it for any reason.

When this method is called, the server closes all readers initialized via [StopAndDownload] and all future interactions on this protocol are invalid.

Trait Implementations

impl Clone for RollingPacketCaptureProxy

fn clone(&self) -> RollingPacketCaptureProxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RollingPacketCaptureProxy

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

Formats the value using the given formatter.

impl Proxy for RollingPacketCaptureProxy

type Protocol = RollingPacketCaptureMarker

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.

impl RollingPacketCaptureProxyInterface for RollingPacketCaptureProxy

fn detach(&self, name: &str) -> Result<(), Error>

fn stop_and_download(&self, channel: ServerEnd<FileMarker>) -> Result<(), Error>

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