Struct FleetObserver 

pub struct FleetObserver { /* private fields */ }

Read-only namespace handle for inspecting an existing SHM fleet.

Unlike Fleet, this handle has no node id, creates no rings, and can never publish, reset, or unlink. Opening a ring maps only an object that already exists; dropping the observer or a ring view only unmaps local memory.

Implementations

impl FleetObserver

pub fn attach_existing(name: impl Into<String>) -> Result<Self>

Create an observer for the effective user’s existing fleet namespace.

This constructor itself performs no SHM operation. Each Self::ring call attaches to one exact existing kind and returns NotFound when it is absent.

pub fn attach_existing_for_uid( name: impl Into<String>, uid: u32, ) -> Result<Self>

Address an explicit uid-scoped fleet namespace.

POSIX permissions still decide whether the caller may read another user’s SHM objects.

pub fn name(&self) -> &str

pub fn uid(&self) -> u32

pub fn ring(&self, kind: u8) -> Result<ShmRingView>

Attach read-only to one exact existing ring kind.

pub fn ring_with_policy( &self, kind: u8, policy: ShmAccessPolicy, ) -> Result<ShmRingView>

Attach read-only using an explicit per-ring maximum access policy.

pub fn typed_ring<T: OrbitTyped>(&self) -> Result<ShmRingView>

Attach read-only and verify a linked OrbitTyped contract.

pub fn typed_ring_with_policy<T: OrbitTyped>( &self, policy: ShmAccessPolicy, ) -> Result<ShmRingView>

Attach with a policy and additionally verify the typed ring layout.

Trait Implementations

impl Clone for FleetObserver

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FleetObserver

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

Formats the value using the given formatter.

impl Eq for FleetObserver

impl PartialEq for FleetObserver

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FleetObserver