Struct PartitionId 

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

Unique identifier for a coherence partition.

Partitions are the primary isolation boundary in RVM. Each partition runs one or more vCPUs and has its own memory map, capability space, and coherence score.

The lower 8 bits serve as the hardware VMID for stage-2 TLB tagging on AArch64 (ADR-133, Section 3). VMID 0 is reserved for the hypervisor.

Implementations

impl PartitionId

pub const HYPERVISOR: Self

The hypervisor’s own partition identifier (not schedulable).

pub const MAX_LOGICAL: u32 = 4096

Maximum logical partition count (DC-12).

Hardware VMID space is bounded (e.g., 256 on ARM). Agent workloads can exceed this, so logical partitions are multiplexed over physical VMID slots.

pub const fn new(id: u32) -> Self

Create a new partition identifier.

Note

This constructor is unchecked – callers that accept untrusted input should use try_new instead to reject reserved and out-of-range identifiers.

pub const fn try_new(id: u32) -> Option<Self>

Create a validated partition identifier, returning None for reserved or out-of-range values.

• Rejects 0 (reserved for the hypervisor – use PartitionId::HYPERVISOR).
• Rejects values greater than MAX_LOGICAL.

pub const fn hypervisor() -> Self

Return the hypervisor’s reserved partition identifier.

pub const fn as_u32(self) -> u32

Return the raw identifier value.

pub const fn vmid(self) -> u16

Extract the hardware VMID (lower 8 bits) for stage-2 TLB tagging.

On AArch64, VTTBR_EL2 encodes the VMID in bits [55:48]. Only 8 bits are used for 256 physical VMID slots; logical partitions exceeding this are multiplexed per DC-12.

pub const fn is_hypervisor(self) -> bool

Whether this is the hypervisor’s own partition.

Trait Implementations

impl Clone for PartitionId

fn clone(&self) -> PartitionId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PartitionId

impl Debug for PartitionId

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

Formats the value using the given formatter.

impl Eq for PartitionId

impl Hash for PartitionId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for PartitionId

fn cmp(&self, other: &PartitionId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for PartitionId

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for PartitionId

fn partial_cmp(&self, other: &PartitionId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for PartitionId