Enum miri::borrow_tracker::tree_borrows::perms::PermissionPriv

enum PermissionPriv {
    Reserved {
        ty_is_freeze: bool,
        conflicted: bool,
    },
    Active,
    Frozen,
    Disabled,
}

The activation states of a pointer.

Variants

Reserved

represents: a local reference that has not yet been written to; allows: child reads, foreign reads, foreign writes if type is freeze; affected by: child writes (becomes Active), rejects: foreign writes (Disabled, except if type is not freeze).

special case: behaves differently when protected, which is where conflicted is relevant

• conflicted is set on foreign reads,
• conflicted must not be set on child writes (there is UB otherwise). This is so that the behavior of Reserved adheres to the rules of noalias:
• foreign-read then child-write is UB due to conflicted,
• child-write then foreign-read is UB since child-write will activate and then foreign-read disables a protected Active, which is UB.

Fields

ty_is_freeze: bool

conflicted: bool

Active

represents: a unique pointer; allows: child reads, child writes; rejects: foreign reads (Frozen), foreign writes (Disabled).

Frozen

represents: a shared pointer; allows: all read accesses; rejects child writes (UB), foreign writes (Disabled).

Disabled

represents: a dead pointer; allows: all foreign accesses; rejects: all child accesses (UB).

Implementations

impl PermissionPriv

fn is_initial(&self) -> bool

Check if self can be the initial state of a pointer.

Trait Implementations

impl Clone for PermissionPriv

fn clone(&self) -> PermissionPriv

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PermissionPriv

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

Formats the value using the given formatter.

impl Display for PermissionPriv

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

Formats the value using the given formatter.

impl Hash for PermissionPriv

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 PartialEq for PermissionPriv

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for PermissionPriv

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

PermissionPriv is ordered by the reflexive transitive closure of Reserved(conflicted=false) < Reserved(conflicted=true) < Active < Frozen < Disabled. Reserved that have incompatible ty_is_freeze are incomparable to each other. This ordering matches the reachability by transitions, as asserted by the exhaustive test permissionpriv_partialord_is_reachability.

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Copy for PermissionPriv

impl Eq for PermissionPriv

impl StructuralPartialEq for PermissionPriv

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 2 bytes

Size for each variant:

• Reserved: 2 bytes
• Active: 0 bytes
• Frozen: 0 bytes
• Disabled: 0 bytes