Struct ParentChannel 

pub struct ParentChannel { /* private fields */ }

Parent side of an authenticated bidirectional port-transfer channel.

Implementations

impl ParentChannel

pub const fn peer_pid(&self) -> u32

Kernel-authenticated helper PID.

pub fn wait(self) -> Result<(), BootstrapError>

Waits for normal helper exit and consumes the child cleanup ledger.

impl ParentChannel

pub fn commit_transfers( &mut self, writer: PendingTransferredWriter, reader: PendingTransferredReader, ) -> Result<(WriterRegion<TransferredWriterMapping>, ReaderRegion<TransferredReaderMapping>), MacBindingError>

Consumes a complete two-region transfer, waits for peer validation, then sends COMMIT before exposing either local runtime capability.

Errors

Returns an error if either pending value belongs to another channel or transfer transaction, if READY does not match the exact canonical batch, or if COMMIT cannot be sent unambiguously. The helper is terminated on failure.

use native_ipc_platform::macos::{
    PendingTransferredReader, PendingTransferredWriter, bootstrap::ParentChannel,
};
fn commit_twice(
    channel: &mut ParentChannel,
    writer: PendingTransferredWriter,
    reader: PendingTransferredReader,
) {
    let _ = channel.commit_transfers(writer, reader);
    let _ = channel.commit_transfers(writer, reader);
}

Examples found in repository

examples/ready_commit.rs (line 51)

fn creator(
    channel: &mut native_ipc_platform::macos::bootstrap::ParentChannel,
    writer: native_ipc_platform::macos::PendingTransferredWriter,
    reader: native_ipc_platform::macos::PendingTransferredReader,
) -> Result<
    (
        native_ipc_core::mapping::WriterRegion<
            native_ipc_platform::macos::TransferredWriterMapping,
        >,
        native_ipc_core::mapping::ReaderRegion<
            native_ipc_platform::macos::TransferredReaderMapping,
        >,
    ),
    native_ipc_platform::macos::MacBindingError,
> {
    channel.commit_transfers(writer, reader)
}

Trait Implementations

impl Drop for ParentChannel

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.