Struct KTraceBuffer 

pub struct KTraceBuffer {
    pub drop_stats: &'static mut DroppedRecordStats,
    pub process_koid: u64,
    pub thread_koid: u64,
    /* private fields */
}

A Rust implementation of percpu_writer::Buffer that wraps a static reference to an existing spsc_buffer::Buffer and tracks dropped trace records.

Fields

drop_stats: &'static mut DroppedRecordStats

process_koid: u64

thread_koid: u64

Implementations

impl KTraceBuffer

pub fn new( buffer: &'static mut Buffer<NoOpAllocator>, drop_stats: &'static mut DroppedRecordStats, cpu_ref_header_entry: u16, process_koid: u64, thread_koid: u64, ) -> Self

Constructs a KTraceBuffer from a static reference to an existing spsc_buffer::Buffer, a static reference to DroppedRecordStats, and its metadata.

pub fn size(&self) -> u32

Returns the size of the backing storage.

pub fn drain(&self) -> Result<(), Status>

Drains the underlying Buffer.

pub fn read<F>(&self, copy_fn: F, len: u32) -> Result<u32, Status>

where F: FnMut(u32, &[u8]) -> Result<(), Status>,

Copies len bytes out of the buffer using the provided copy_fn.

pub fn reserve(&mut self, header: u64) -> Result<KTraceReservation<'_>, Status>

Reserves a block of the given size in the buffer, interposing to write dropped record statistics if any were tracked.

pub fn emit_drop_stats(&mut self) -> Result<(), Status>

Emit the dropped record stats to the trace buffer if we’re currently tracking them.

pub fn reset_drop_stats(&mut self)

Resets the dropped records statistics to their initial values.

Trait Implementations

impl Send for KTraceBuffer

impl Sync for KTraceBuffer