Struct PreRawMessageChannel

pub struct PreRawMessageChannel(/* private fields */);

A sendable handle for establishing RawMessageChannels with processes you can already communicate with.

PreRawMessageChannels are created in pairs, and then can be freely sent along any IPC method in this crate capable of transmitting OS resources. When they reach their destination they can be converted into RawMessageChannels.

Implementations

impl PreRawMessageChannel

pub fn pair() -> Result<(Self, Self)>

pub fn into_raw_channel( self, remote_process: ProcessHandle, tokio_loop: &TokioHandle, ) -> Result<RawMessageChannel>

Creates a RawMessageChannel from a transmitted pre-channel and a remote process handle.

Security

You should only allow more trusted processes to hold unsealed channels to less trusted processes. On some platforms unsealed channels allow the holder to interfere with the other process.

Using an incorrect remote process handle may cause this function to fail or transmission of OS resources (files, sockets, etc.) accross the channel to fail.

pub fn into_sealed_raw_channel( self, tokio_loop: &TokioHandle, ) -> Result<RawMessageChannel>

Creates a sealed RawMessageChannel from a transmitted pre-channel.

Sealed channels cannot transmit OS resources (files, sockets, etc.) but can still transmit data (they may receive OS resources if the other side is unsealed). It is recommended that you use a sealed channel handle when communicating from the less trusted side of a channel.

Trait Implementations

impl Debug for PreRawMessageChannel

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PreRawMessageChannel

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PreRawMessageChannel

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.