Struct PreMessageChannel

pub struct PreMessageChannel<T, R>
where
    T: Serialize,
    R: for<'des> Deserialize<'des>,
{ /* private fields */ }

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

PreMessageChannels 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 MessageChannels.

Implementations

impl<T, R> PreMessageChannel<T, R>

where T: Serialize, R: for<'de> Deserialize<'de>,

pub fn pair(max_message_size: usize) -> Result<(Self, Self)>

pub fn into_channel( self, remote_process: ProcessHandle, tokio_loop: &TokioHandle, ) -> Result<MessageChannel<T, R>>

Creates a MessageChannel 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_channel( self, tokio_loop: &TokioHandle, ) -> Result<MessageChannel<T, R>>

Creates a sealed MessageChannel 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<T, R> Debug for PreMessageChannel<T, R>

where T: Serialize + Debug, R: for<'des> Deserialize<'des> + Debug,

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

Formats the value using the given formatter.

impl<'de, T, R> Deserialize<'de> for PreMessageChannel<T, R>

where T: Serialize, R: for<'des> Deserialize<'des>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T, R> Serialize for PreMessageChannel<T, R>

where T: Serialize, R: for<'des> Deserialize<'des>,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.