bcc 0.0.34

Idiomatic Rust bindings for BPF Compiler Collection (BCC)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

use std::path::Path;

use bcc_sys::bccapi::pid_t;

use crate::error::BccError;
use crate::BPF;

pub fn usdt_generate_args(
    mut _contexts: Vec<USDTContext>,
) -> Result<(String, Vec<USDTContext>), BccError> {
    Err(BccError::BccVersionTooLow {
        cause: "USDT support is not enabled".to_owned(),
        min_version: "0.6.1".to_owned(),
    })
}

/// A USDT context.
///
/// A context represents a collection of probes -- tracepoint to function mappings -- for either a
/// given PID and/or a given binary path.
///
/// Tracepoints which are already statically defined are mapped to a specific function, such that
/// when the tracepoint is hit, the given function -- a function that must be defined in the BPF
/// program -- is called, with all of the arguments passed to the tracepoint itself.
pub struct USDTContext;

impl USDTContext {
    /// Create a new USDT context from a PID.
    pub fn from_pid(pid: pid_t) -> Result<Self, BccError> {
        Self::new(Some(pid), None)
    }

    /// Create a new USDT context from a path to the binary.
    pub fn from_binary_path<T: AsRef<Path>>(path: T) -> Result<Self, BccError> {
        Self::new(None, path.as_ref().to_str())
    }

    /// Create a new USDT context from a path to the binary and a specific PID.
    pub fn from_binary_path_and_pid<P: AsRef<Path>>(path: P, pid: pid_t) -> Result<Self, BccError> {
        Self::new(Some(pid), path.as_ref().to_str())
    }

    fn new(_pid: Option<pid_t>, _path: Option<&str>) -> Result<Self, BccError> {
        Err(BccError::BccVersionTooLow {
            cause: "USDT support is not enabled".to_owned(),
            min_version: "0.6.1".to_owned(),
        })
    }

    /// Attaches this context to a given BPF program.
    ///
    /// If `attach_usdt_ignore_pid` is true, it will attach this context to all matching processes.
    /// Otherwise, it will attach this context to the specified PID only.
    pub(crate) fn attach(
        self,
        _bpf: &mut BPF,
        _attach_usdt_ignore_pid: bool,
    ) -> Result<(), BccError> {
        Err(BccError::BccVersionTooLow {
            cause: "USDT support is not enabled".to_owned(),
            min_version: "0.6.1".to_owned(),
        })
    }
}