Struct bcc::PerfEventArray

pub struct PerfEventArray { /* fields omitted */ }

Implementations

impl PerfEventArray

A PerfEventArray is used to configure a BPF PERF_EVENT_ARRAY such that a call `table.perf_read(CUR_CPU_IDENTIFIER) returns the hardware counter of the event on the local cpu.

pub fn new() -> Self

Creates a new PerfEventArray with defaults.There are several mandatory fields which must be configured before attaching.

pub fn table(self, name: &str) -> Self

Specify the name of the table within the BPF code. This is a required item.

pub fn event(self, event: Event) -> Self

The Event which will cause a probe to fire, such as a hardware or software event. This is required.

pub fn cpu(self, cpu: Option<usize>) -> Self

Restrict the probe to only the given hardware thread. If this is set to None (the default), a probe will be created for each hardware thread on the system to provide system-wide coverage.

pub fn attach(self, bpf: &mut BPF) -> Result<(), BccError>

Consumes the perf event and opens it. May return an error if there is a incomplete or invalid configuration or other error while loading or opening the event.

Trait Implementations

impl Default for PerfEventArray

fn default() -> PerfEventArray

Returns the “default value” for a type.