async-ebpf 0.3.2

Async-friendly, fully preemptive userspace eBPF runtime
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

use std::sync::Arc;

use elf::{relocation::Rel, ParseError};
use thiserror::Error as ThisError;

#[derive(ThisError, Debug, Clone)]
#[error("ebpf runtime error: {0}")]
/// Public error wrapper for runtime failures.
pub struct Error(pub(crate) RuntimeError);

#[derive(ThisError, Debug, Clone)]
pub(crate) enum RuntimeError {
  #[error("invalid argument: {0}")]
  InvalidArgument(&'static str),

  #[error("platform error: {0}")]
  PlatformError(&'static str),

  #[error("helper returned error: {0}")]
  HelperError(&'static str),

  #[error("helper returned error during async invocation: {0}")]
  AsyncHelperError(&'static str),

  #[error("linker returned error: {0}")]
  Linker(LinkerError),

  #[error("memory fault at virtual address {0:#x}")]
  MemoryFault(usize),
}

#[derive(ThisError, Debug, Clone)]
pub(crate) enum LinkerError {
  #[error("invalid elf image: {0}")]
  InvalidElf(&'static str),

  #[error("bad relocation: {0} ({1:?})")]
  Reloc(String, Rel),

  #[error("program rejected: {0}")]
  Rejected(String),

  #[error("elf parse failed: {0}")]
  Parse(Arc<ParseError>),
}

impl From<ParseError> for LinkerError {
  fn from(e: ParseError) -> Self {
    Self::Parse(Arc::new(e))
  }
}