kmodule

Documentation

Overview

Package kmodule interfaces with Linux kernel modules.

kmodule allows loading and unloading kernel modules with dependencies, as well as locating them through probing.

Index

• Constants
• func CompressionReader(file *os.File) (reader io.Reader, err error)
• func Delete(name string, flags uintptr) error
• func FileInit(f *os.File, opts string, flags uintptr) error
• func Init(image []byte, opts string) error
• func Probe(name string, modParams string) error
• func ProbeOptions(name, modParams string, opts ProbeOpts) error
• type ProbeOpts

Constants

const (
	// Ignore symbol version hashes.
	MODULE_INIT_IGNORE_MODVERSIONS = 0x1

	// Ignore kernel version magic.
	MODULE_INIT_IGNORE_VERMAGIC = 0x2
)

Flags to finit_module(2) / FileInit.

Functions

func CompressionReader

func CompressionReader(file *os.File) (reader io.Reader, err error)

Wrapper for the compression readers

func Delete

func Delete(name string, flags uintptr) error

Delete removes a kernel module.

func FileInit

func FileInit(f *os.File, opts string, flags uintptr) error

FileInit loads the kernel module contained by `f` with the given opts and flags. Uncompresses modules with a .xz and .gz suffix before loading.

FileInit falls back to init_module(2) via Init when the finit_module(2) syscall is not available and when loading compressed modules.

func Init

func Init(image []byte, opts string) error

Init loads the kernel module given by image with the given options.

func Probe

func Probe(name string, modParams string) error

Probe loads the given kernel module and its dependencies. It is calls ProbeOptions with the default ProbeOpts.

func ProbeOptions

func ProbeOptions(name, modParams string, opts ProbeOpts) error

ProbeOptions loads the given kernel module and its dependencies. This functions takes ProbeOpts.

Types

type ProbeOpts

type ProbeOpts struct {
	DryRunCB       func(string)
	RootDir        string
	KVer           string
	IgnoreProcMods bool
}

ProbeOpts contains optional parameters to Probe.

An empty ProbeOpts{} should lead to the default behavior.