Enum CoherencyDomain

pub enum CoherencyDomain {
    Cpu,
    Ram,
    Inaccessible,
    // some variants omitted
}

INACCESSIBLE is only for cases where there is no CPU access to the buffers.

Device-local memory that isn’t reachable from the CPU is CoherencyDomain INACCESSIBLE, even if it’s possible to cause a device (physical or virtual) to copy the data from the INACCESSIBLE buffers to buffers that are visible to the CPU. In other words, INACCESSIBLE does not imply secure, but secure implies INACCESSIBLE.

CPU means producers must ensure that a consumer can read the produced data with the CPU without the consumer needing to do additional cache ops not already performed (as needed) by the producer.

RAM means producers must ensure that the produced data is entirely present in RAM, without any dirty CPU cache lines, and a consumer must invalidate (or flush and invalidate, typically) the CPU cache before reading data with the CPU. The RAM domain can be faster than the CPU domain when all access is via HW DMA, since in that case no CPU cache ops are required, since no participant is actually reading/writing using the CPU.

Variants

Cpu

Ram

Inaccessible

Implementations

impl CoherencyDomain

pub fn from_primitive(prim: u32) -> Option<CoherencyDomain>

pub fn from_primitive_allow_unknown(prim: u32) -> CoherencyDomain

pub fn unknown() -> CoherencyDomain

pub const fn into_primitive(self) -> u32

pub fn is_unknown(&self) -> bool

Trait Implementations

impl Clone for CoherencyDomain

fn clone(&self) -> CoherencyDomain

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CoherencyDomain

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

Formats the value using the given formatter.

impl<D> Decode<CoherencyDomain, D> for CoherencyDomain

where D: ResourceDialect,

fn new_empty() -> CoherencyDomain

Creates a valid instance of Self. The specific value does not matter, since it will be overwritten by decode.

unsafe fn decode( &mut self, decoder: &mut Decoder<'_, D>, offset: usize, _depth: Depth, ) -> Result<(), Error>

Decodes an object of type T from the decoder’s buffers into self.

impl<D> Encode<CoherencyDomain, D> for CoherencyDomain

where D: ResourceDialect,

unsafe fn encode( self, encoder: &mut Encoder<'_, D>, offset: usize, _depth: Depth, ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID.

impl Hash for CoherencyDomain

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

where __H: Hasher,

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 CoherencyDomain

fn cmp(&self, other: &CoherencyDomain) -> 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 CoherencyDomain

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for CoherencyDomain

fn partial_cmp(&self, other: &CoherencyDomain) -> 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 TypeMarker for CoherencyDomain

type Owned = CoherencyDomain

The owned Rust type which this FIDL type decodes into.

fn inline_align(_context: Context) -> usize

Returns the minimum required alignment of the inline portion of the encoded object. It must be a (nonzero) power of two.

fn inline_size(_context: Context) -> usize

Returns the size of the inline portion of the encoded object, including padding for alignment. Must be a multiple of inline_align.

fn encode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and encoding requires no validation. When true, we can optimize encoding arrays and vectors of Self::Owned to a single memcpy.

fn decode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and decoding requires no validation. When true, we can optimize decoding arrays and vectors of Self::Owned to a single memcpy.

impl ValueTypeMarker for CoherencyDomain

type Borrowed<'a> = CoherencyDomain

The Rust type to use for encoding. This is a particular Encode<Self> type cheaply obtainable from &Self::Owned. There are three cases:

fn borrow( value: &<CoherencyDomain as TypeMarker>::Owned, ) -> <CoherencyDomain as ValueTypeMarker>::Borrowed<'_>

Cheaply converts from &Self::Owned to Self::Borrowed.

impl Copy for CoherencyDomain

impl Eq for CoherencyDomain

impl StructuralPartialEq for CoherencyDomain