libkmod-loaded: libkmod Reference Manual

## libkmod-loaded libkmod-loaded — currently loaded modules |

## Functions

int | kmod_module_new_from_loaded ()
int | kmod_module_get_initstate ()
const char * | kmod_module_initstate_str ()
long | kmod_module_get_size ()
int | kmod_module_get_refcnt ()
struct kmod_list * | kmod_module_get_holders ()

## Description

Information about currently loaded modules, as reported by Linux kernel. These information are not cached by libkmod and are always read from /sys and /proc/modules.

## Functions

### kmod_module_new_from_loaded ()

    int
    kmod_module_new_from_loaded (struct kmod_ctx *ctx,
                                 struct kmod_list **list);

Create a new list of kmod modules with all modules currently loaded in kernel. It uses /proc/modules to get the names of loaded modules and to create kmod modules by calling `kmod_module_new_from_name()` in each of them. They are put in `list` in no particular order.

The initial refcount is 1, and needs to be decremented to release the resources of the kmod_module. The returned `list` must be released by calling `kmod_module_unref_list()`. Since libkmod keeps track of all kmod_modules created, they are all released upon `ctx` destruction too. Do not unref `ctx` before all the desired operations with the returned list are completed.

#### Parameters

ctx | kmod library context |
list | where to save the list of loaded modules |

#### Returns

0 on success or < 0 on error.

### kmod_module_get_initstate ()

    int
    kmod_module_get_initstate (const struct kmod_module *mod);

Get the initstate of this `mod` , as returned by Linux Kernel, by reading /sys filesystem.

#### Parameters

mod | kmod module |

#### Returns

< 0 on error or module state if module is found in kernel, valid states are KMOD_MODULE_BUILTIN: module is builtin; KMOD_MODULE_LIVE: module is live in kernel; KMOD_MODULE_COMING: module is being loaded; KMOD_MODULE_GOING: module is being unloaded.

### kmod_module_initstate_str ()

    const char *
    kmod_module_initstate_str (enum kmod_module_initstate state);

Translate a initstate to a string.

#### Parameters

state | the state as returned by `kmod_module_get_initstate()` |

#### Returns

the string associated to the `state` . This string is statically allocated, do not free it.

### kmod_module_get_size ()

    long
    kmod_module_get_size (const struct kmod_module *mod);

Get the size of this kmod module as returned by Linux kernel. If supported, the size is read from the coresize attribute in /sys/module. For older kernels, this falls back on /proc/modules and searches for the specified module to get its size.

#### Parameters

mod | kmod module |

#### Returns

the size of this kmod module.

### kmod_module_get_refcnt ()

    int
    kmod_module_get_refcnt (const struct kmod_module *mod);

Get the ref count of this `mod` , as returned by Linux Kernel, by reading /sys filesystem.

#### Parameters

mod | kmod module |

#### Returns

the reference count on success or < 0 on failure.

### kmod_module_get_holders ()

    struct kmod_list *
    kmod_module_get_holders (const struct kmod_module *mod);

Get a list of kmod modules that are holding this `mod` , as returned by Linux Kernel. After use, free the `list` by calling `kmod_module_unref_list()`.

#### Parameters

mod | kmod module |

#### Returns

a new list of kmod modules on success or NULL on failure.

## Types and Values