Struct LiveHostKernelEnv 

pub struct LiveHostKernelEnv {
    pub release: String,
    pub btf_path: PathBuf,
    pub vmlinux_elf_path: Option<PathBuf>,
    pub kallsyms_path: PathBuf,
}

Resolved live-host kernel environment.

Built once at the start of a live-host introspection run; the dump pipeline holds it alongside the super::bpf_syscall::BpfSyscallAccessor for the duration of the dump.

Fields

release: String

Output of uname -r — the running kernel’s release string (e.g. “6.16.0-1234-generic”). Used to interpolate paths like /lib/modules/<release>/build/vmlinux.

btf_path: PathBuf

Path to the vmlinux ELF (or raw BTF blob) the BTF parser will load. Always set; resolution order is documented on the module-level doc.

vmlinux_elf_path: Option<PathBuf>

Path to a vmlinux ELF when one is reachable on this host. None when only /sys/kernel/btf/vmlinux is available (raw BTF, no ELF) — most common on stripped distro kernels without linux-headers-* / linux-image-*-dbg installed.

kallsyms_path: PathBuf

Path to /proc/kallsyms — fixed but kept here so callers that want to swap in a unit-test fixture (or /proc/PID/maps alternative) have a single override point.

Implementations

impl LiveHostKernelEnv

pub fn discover() -> Result<Self>

Auto-discover every resource needed by the live-host introspection pipeline.

Returns an error only when none of the BTF candidate paths resolve — without BTF the failure-dump renderer can’t decode any field. Missing vmlinux ELF or unreadable /proc/kallsyms are NOT errors at this layer: callers that need ELF or symbols for their specific dump pass surface their own error when they reach for an unavailable resource.

Trait Implementations

impl Clone for LiveHostKernelEnv

fn clone(&self) -> LiveHostKernelEnv

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LiveHostKernelEnv

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

Formats the value using the given formatter.