Struct linapi::modules::ModuleFile

pub struct ModuleFile { /* fields omitted */ }

A Linux Kernel Module file on disk.

Methods

impl ModuleFile

pub fn from_name(name: &str) -> Self

Search /lib/modules/(uname -r) for the module name.

Panics

• If the module couldn't be found

pub fn from_path(path: &Path) -> Self

Use the file at path as a module.

Panics

• If the module couldn't be found

pub fn load(&self, param: &str) -> LoadedModule

Load this kernel module, and return the LoadedModule describing it.

Arguments

• parameters for the kernel module. See module documentation for details, and init_module(2) for details on formatting.

Panics

• On failure

Note

Kernel modules may be compressed, and depending on crate features this function may automatically decompress it.

pub unsafe fn force_load(&self, param: &str) -> LoadedModule

Force load this kernel module, and return the LoadedModule describing it.

Arguments

• parameters for the kernel module. See module documentation for details, and init_module(2) for details on formatting.

Safety

Force loading a kernel module is dangerous, it skips important safety checks that help ensure module compatibility with your kernel.

pub fn path(&self) -> &Path

pub fn name(&self) -> &str

pub fn info(&self) -> ModInfo

Get information embedded in the module file.

Note

This uses the .modinfo ELF section, which seems to be entirely undocumented.

pub fn has_signature(&self) -> bool

Whether the module has a signature.

This does not check if it's valid.

Note

This is a temporary API.

Trait Implementations

impl Debug for ModuleFile

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

Formats the value using the given formatter.