Struct KallsymsTable 

pub struct KallsymsTable { /* private fields */ }

Parsed kernel symbol table from /proc/kallsyms.

Per-line lazy lookup is too slow for the live-host pipeline, which resolves dozens of symbols (sched_class addresses, lock slowpath entry points, scx_root, etc.) at a single dump time. KallsymsTable parses once and holds an O(1) name→addr map.

Implementations

impl KallsymsTable

pub fn load_from(env: &LiveHostKernelEnv) -> Result<Self>

Read and parse /proc/kallsyms from the configured path on env. Returns an error when the file is unreadable — /proc/kallsyms is root-readable only, and unprivileged callers see a 0-filled file. The parser detects the all- zeros case and returns an empty map without erroring (so non-privileged unit tests still get a usable KallsymsTable even though it can’t resolve anything).

pub fn load_from_path(path: &Path) -> Result<Self>

Read and parse a kallsyms file from an explicit path. Useful for unit tests and for the rare live-host caller that wants to point at a saved snapshot rather than the live /proc/kallsyms.

pub fn parse(raw: &str) -> Self

Parse kallsyms-format text (one HEX TYPE NAME ... line per symbol) into a name→address map.

Skipped lines (silently, without affecting other symbols):

• lines with fewer than 3 whitespace-separated tokens
• lines whose first token is not a hex-parseable u64
• lines whose address is 0 (the kallsyms-redacted view that unprivileged readers see — addresses are zero-filled by the kernel for non-CAP_SYSLOG callers)

A returned table with len() == 0 is valid: the caller can detect “kallsyms unreadable” via is_empty() and surface a permission diagnostic without this layer producing an error.

pub fn resolve(&self, name: &str) -> Option<u64>

Look up a symbol by exact name. Returns the kernel virtual address (u64) or None when the name is not in the table.

pub fn len(&self) -> usize

Total number of resolved symbols. Zero when /proc/kallsyms was readable but every line was redacted (unprivileged caller case).

pub fn is_empty(&self) -> bool

True when the table holds no usable symbols. Live-host callers that hit this should surface a “run as root” diagnostic.

Trait Implementations

impl Clone for KallsymsTable

fn clone(&self) -> KallsymsTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KallsymsTable

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

Formats the value using the given formatter.