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.

Note

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

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.

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

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.