Struct aya::programs::BtfTracePoint

pub struct BtfTracePoint { /* private fields */ }

Marks a function as a BTF-enabled raw tracepoint eBPF program that can be attached at a pre-defined kernel trace point.

The kernel provides a set of pre-defined trace points that eBPF programs can be attached to. See /sys/kernel/debug/tracing/events for a list of which events can be traced.

Minimum kernel version

The minimum kernel version required to use this feature is 5.5.

Examples

use aya::{Bpf, programs::BtfTracePoint, BtfError, Btf};
use std::convert::TryInto;

let btf = Btf::from_sys_fs()?;
let program: &mut BtfTracePoint = bpf.program_mut("sched_process_fork").unwrap().try_into()?;
program.load("sched_process_fork", &btf)?;
program.attach()?;

Implementations

impl BtfTracePoint

pub fn load(&mut self, tracepoint: &str, btf: &Btf) -> Result<(), ProgramError>

Loads the program inside the kernel.

See also Program::load.

Arguments

• tracepoint - full name of the tracepoint that we should attach to
• btf - btf information for the target system

pub fn attach(&mut self) -> Result<LinkRef, ProgramError>

Attaches the program.

Trait Implementations

impl Debug for BtfTracePoint

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

Formats the value using the given formatter.

impl ProgramFd for BtfTracePoint

fn fd(&self) -> Option<RawFd>

Returns the RawFd of the program if it has been loaded, or None

impl ProgramFd for &mut BtfTracePoint

fn fd(&self) -> Option<RawFd>

Returns the RawFd of the program if it has been loaded, or None

impl<'a> TryFrom<&'a Program> for &'a BtfTracePoint

type Error = ProgramError

The type returned in the event of a conversion error.

fn try_from(program: &'a Program) -> Result<&'a BtfTracePoint, ProgramError>

Performs the conversion.

impl<'a> TryFrom<&'a mut Program> for &'a mut BtfTracePoint

type Error = ProgramError

The type returned in the event of a conversion error.

fn try_from(
    program: &'a mut Program
) -> Result<&'a mut BtfTracePoint, ProgramError>

Performs the conversion.