Enum ProtocolAbiVersion 

#[repr(i32)]
pub enum ProtocolAbiVersion {
    Unspecified = 0,
    V1 = 1,
    V2 = 2,
}

A shared memory layout and the operations that send its data to the service. The versions are independent: v2 does not imply v1. The producer sends a bitmask of its versions in InitializeConnectionRequest. The service returns the bitmask of common versions. This exchange does not select a writer for an instance.

Each value is a single bit, so a uint32 mask holds a set of versions. A new version must take the next unused bit: 4, then 8.

Keep in sync with ProtocolAbiVersion in include/perfetto/ext/tracing/core/tracing_service.h, which describes each version in detail.

Variants

Unspecified = 0

Reserved. Do not advertise this value.

V1 = 1

The original protocol: a shared memory buffer (SMB) of pages and chunks, with CommitData IPCs and patches. Docs: https://perfetto.dev/docs/design-docs/api-and-abi#shmem-abi.

V2 = 2

Tracing v2: a ring buffer that the producer allocates, shared with AttachV2RingBuffer and read on DrainV2RingBuffer. It is experimental and its ABI is not stable yet. Design: RFC-0014, https://github.com/google/perfetto/discussions/4508.

Implementations

impl ProtocolAbiVersion

pub const fn is_valid(value: i32) -> bool

Returns true if value is a variant of ProtocolAbiVersion.

pub fn from_i32(value: i32) -> Option<ProtocolAbiVersion>

👎Deprecated:

Use the TryFrom<i32> implementation instead

Converts an i32 to a ProtocolAbiVersion, or None if value is not a valid variant.

impl ProtocolAbiVersion

pub fn as_str_name(&self) -> &'static str

String value of the enum field names used in the ProtoBuf definition.

The values are not transformed in any way and thus are considered stable (if the ProtoBuf definition does not change) and safe for programmatic use.

pub fn from_str_name(value: &str) -> Option<Self>

Creates an enum from field names used in the ProtoBuf definition.

Trait Implementations

impl Clone for ProtocolAbiVersion

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ProtocolAbiVersion

impl Debug for ProtocolAbiVersion

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

Formats the value using the given formatter.

impl Default for ProtocolAbiVersion

fn default() -> ProtocolAbiVersion

Returns the “default value” for a type.

impl Eq for ProtocolAbiVersion

impl From<ProtocolAbiVersion> for i32

fn from(value: ProtocolAbiVersion) -> i32

Converts to this type from the input type.

impl Hash for ProtocolAbiVersion

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 ProtocolAbiVersion

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

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for ProtocolAbiVersion

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ProtocolAbiVersion

fn partial_cmp(&self, other: &Self) -> 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 ProtocolAbiVersion

impl TryFrom<i32> for ProtocolAbiVersion

type Error = UnknownEnumValue

The type returned in the event of a conversion error.

fn try_from(value: i32) -> Result<ProtocolAbiVersion, UnknownEnumValue>

Performs the conversion.