Struct PeerMemory 

pub struct PeerMemory { /* private fields */ }

Memory one device lets kernels on the other devices of its runtime bind.

It holds the address the owning device resolved for the allocation, and a binding that keeps the allocation in place there: a bound allocation is never freed, handed out again or relocated, so the address stays valid for as long as any clone lives.

Nothing orders the accesses. A kernel on another device reads whatever the memory holds when it runs, and its writes land whenever they land. Callers order them by synchronizing the devices, or by handing off inside the kernels through system-scope atomics.

Failures cross over through it. The owner marks it when work that should have written the memory failed, so a peer kernel reading it does not run on stale bytes, and a peer kernel that failed to write it marks it and taints the buffer on its owner, so a read there fails on the cause.

Implementations

impl PeerMemory

pub fn address(&self) -> u64

The device address of the allocation’s first byte.

pub fn owner(&self) -> &DeviceHandle<dyn Server>

The device that owns the memory.

pub fn failure(&self) -> Option<ServerError>

The failure of the work that should have written the memory last, if it failed.

pub fn fail(&self, error: ServerError)

The work that should have written the memory failed with error.

pub fn repair(&self) -> bool

Work writing the memory was enqueued. Whether it carried a failure until now.

Trait Implementations

impl Clone for PeerMemory

fn clone(&self) -> PeerMemory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerMemory

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

Formats the value using the given formatter.