Struct LinkableSynchronousProxy

pub struct LinkableSynchronousProxy { /* private fields */ }

Implementations

impl LinkableSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<LinkableEvent, Error>

Waits until an event arrives and returns it. It is safe for other threads to make concurrent requests while waiting for an event.

pub fn link_into( &self, dst_parent_token: Event, dst: &str, ___deadline: MonotonicInstant, ) -> Result<LinkableLinkIntoResult, Error>

Creates a link to this this object with name dst in the directory represented by dst_parent_token.

dst must be a resolved object name. Including “/” in the string will return ZX_ERR_INVALID_ARGS.

This method requires the maximal set of rights supported by the filesystem for this object. For files this would typically be [Rights.READ_BYTES], [Rights.WRITE_BYTES], [Rights.GET_ATTRIBUTES] and [Rights.UPDATE_ATTRIBUTES]. Some filesystems might also support the [Rights.EXECUTE] right. Insufficient rights will result in ZX_ERR_ACCESS_DENIED.

If this object has no links and is NOT an unnamed temporary object (objects opened with Flags.FLAG_CREATE_AS_UNNAMED_TEMPORARY), it will fail with ZX_ERR_NOT_FOUND.

For unnamed temporary objects, use LinkInto to give it a name. Upon successful completion, the object will be permanently linked to the filesystem. Requires that the unnamed temporary object is linkable, if not, it will fail with ZX_ERR_NOT_FOUND.

This method does not have the same atomicity properties has the Directory::Link method, which means that calling Open then LinkInto is not equivalent to Directory::Link because LinkInto will not prevent the source from being renamed or unlinked.

Trait Implementations

impl Debug for LinkableSynchronousProxy

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

Formats the value using the given formatter.

impl From<Channel> for LinkableSynchronousProxy

fn from(value: Channel) -> Self

Converts to this type from the input type.

impl From<LinkableSynchronousProxy> for Handle

fn from(value: LinkableSynchronousProxy) -> Self

Converts to this type from the input type.

impl SynchronousProxy for LinkableSynchronousProxy

type Proxy = LinkableProxy

The async proxy for the same protocol.

type Protocol = LinkableMarker

The protocol which this Proxy controls.

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Channel

Convert the proxy back into a channel.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

fn is_closed(&self) -> Result<bool, Status>

Returns true if the proxy has received the PEER_CLOSED signal.