Struct EventDataDescriptor 

pub struct EventDataDescriptor<'a> { /* private fields */ }

Low-level API: Describes a block of data to be sent to user_events via TracepointState::write.

Note: This must have the same underlying representation as struct iovec.

Implementations

impl<'a> EventDataDescriptor<'a>

pub const fn zero() -> Self

Returns an EventDataDescriptor initialized with { null, 0 }.

pub const fn is_empty(&self) -> bool

Returns true if this descriptor’s size is 0.

pub const unsafe fn from_raw_ptr(ptr: usize, size: usize) -> Self

Returns an EventDataDescriptor initialized with the specified ptr and size.

Safety

This bypasses lifetime tracking. Caller must ensure that this EventDataDescriptor is not used after the referenced data’s lifetime. Typically, this is done by overwriting the descriptor with EventDataDescriptor::zero after it has been used.

pub fn from_bytes(value: &'a [u8]) -> Self

Returns an EventDataDescriptor initialized with the specified slice’s bytes.

pub fn from_value<T: Copy>(value: &'a T) -> Self

Returns an EventDataDescriptor initialized with the specified value’s bytes.

pub fn from_cstr<T: Copy + Default + Eq>(value: &'a [T]) -> Self

Returns an EventDataDescriptor for a nul-terminated string. Returned descriptor does NOT include the nul-termination.

Resulting descriptor’s size is the minimum of:

• size_of::<T>() * 65535
• size_of::<T>() * value.len()
• size_of::<T>() * (index of first element equal to T::default())

pub fn from_slice<T: Copy>(value: &'a [T]) -> Self

Returns an EventDataDescriptor for a variable-length array field.

Resulting descriptor’s size is the minimum of:

• size_of::<T>() * 65535
• size_of::<T>() * value.len()

Trait Implementations

impl<'a> Debug for EventDataDescriptor<'a>

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

Formats the value using the given formatter.

impl<'a> Default for EventDataDescriptor<'a>

fn default() -> EventDataDescriptor<'a>

Returns the “default value” for a type.