Struct SkeletonBuilder

pub struct SkeletonBuilder { /* private fields */ }

SkeletonBuilder builds and generates a single skeleton.

This interface is meant to be used in build scripts.

Examples

use libbpf_cargo::SkeletonBuilder;

SkeletonBuilder::new()
    .source("myobject.bpf.c")
    .debug(true)
    .clang("/opt/clang/clang")
    .build_and_generate("/output/path")
    .unwrap();

Implementations

impl SkeletonBuilder

pub fn new() -> Self

pub fn source<P: AsRef<Path>>(&mut self, source: P) -> &mut SkeletonBuilder

Point the SkeletonBuilder to a source file for compilation

Default is None

pub fn obj<P: AsRef<Path>>(&mut self, obj: P) -> &mut SkeletonBuilder

Point the SkeletonBuilder to an object file for generation

Default is None

pub fn debug(&mut self, debug: bool) -> &mut SkeletonBuilder

Turn debug output on or off

Default is off

pub fn clang<P: AsRef<Path>>(&mut self, clang: P) -> &mut SkeletonBuilder

Specify which clang binary to use

Default searches $PATH for clang

pub fn clang_args<A, S>(&mut self, args: A) -> &mut SkeletonBuilder

where A: IntoIterator<Item = S>, S: AsRef<OsStr>,

Pass additional arguments to clang when building BPF object file

Examples

use libbpf_cargo::SkeletonBuilder;

SkeletonBuilder::new()
    .source("myobject.bpf.c")
    .clang_args([
        "-DMACRO=value",
        "-I/some/include/dir",
    ])
    .build_and_generate("/output/path")
    .unwrap();

pub fn skip_clang_version_check(&mut self, skip: bool) -> &mut SkeletonBuilder

Specify whether or not to skip clang version check

Default is false

pub fn rustfmt<P: AsRef<Path>>(&mut self, rustfmt: P) -> &mut SkeletonBuilder

Specify which rustfmt binary to use

Default searches $PATH for rustfmt

pub fn build_and_generate<P: AsRef<Path>>(&mut self, output: P) -> Result<()>

Build BPF programs and generate the skeleton at path output

pub fn build(&mut self) -> Result<()>

pub fn generate<P: AsRef<Path>>(&mut self, output: P) -> Result<()>

Trait Implementations

impl Default for SkeletonBuilder

fn default() -> Self

Returns the “default value” for a type.