mirror of
https://github.com/kmod-project/kmod.git
synced 2026-01-26 15:39:08 +00:00
049c55df47
Co-authored-by: Emil Velikov <emil.l.velikov@gmail.com> Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org> Link: https://github.com/kmod-project/kmod/pull/378 Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
60 lines
1.3 KiB
Plaintext
60 lines
1.3 KiB
Plaintext
libkmod - linux kernel module handling library
|
|
|
|
ABSTRACT
|
|
========
|
|
|
|
libkmod was created to allow programs to easily insert, remove and list modules,
|
|
also checking their properties, dependencies and aliases.
|
|
|
|
The library does not keep a shared/global context information, thus it can be
|
|
used by multiple sites on a single program. One is able to use libkmod from
|
|
threads, although the user must lock explicitly, since the library is not thread
|
|
safe.
|
|
|
|
|
|
OVERVIEW
|
|
========
|
|
|
|
All users should create and manage their own library context with:
|
|
|
|
struct kmod_ctx *ctx = kmod_new(kernel_dirname);
|
|
kmod_unref(ctx);
|
|
|
|
|
|
Modules can be created by various means:
|
|
|
|
struct kmod_module *mod;
|
|
int err;
|
|
|
|
err = kmod_module_new_from_path(ctx, path, &mod);
|
|
if (err < 0) {
|
|
/* code */
|
|
} else {
|
|
/* code */
|
|
kmod_module_unref(mod);
|
|
}
|
|
|
|
err = kmod_module_new_from_name(ctx, name, &mod);
|
|
if (err < 0) {
|
|
/* code */
|
|
} else {
|
|
/* code */
|
|
kmod_module_unref(mod);
|
|
}
|
|
|
|
|
|
Or could be resolved from a known alias to a list of alternatives:
|
|
|
|
struct kmod_list *list, *itr;
|
|
int err;
|
|
err = kmod_module_new_from_lookup(ctx, alias, &list);
|
|
if (err < 0) {
|
|
/* code */
|
|
} else {
|
|
kmod_list_foreach(itr, list) {
|
|
struct kmod_module *mod = kmod_module_get_module(itr);
|
|
/* code */
|
|
}
|
|
}
|
|
|