diff options
author | Lucas De Marchi <lucas.demarchi@profusion.mobi> | 2011-12-12 16:41:38 -0200 |
---|---|---|
committer | Lucas De Marchi <lucas.demarchi@profusion.mobi> | 2011-12-12 16:54:18 -0200 |
commit | cb48c9b2e611251c68bd0b8f349312330310f644 (patch) | |
tree | 17759214f529aea6aca6fcabcfcab0ce02bfa0c6 /README | |
parent | 2411c077949800bd56211b9b2b8b0f18a9fcf88a (diff) | |
download | kmod-cb48c9b2e611251c68bd0b8f349312330310f644.tar.gz kmod-cb48c9b2e611251c68bd0b8f349312330310f644.tar.bz2 kmod-cb48c9b2e611251c68bd0b8f349312330310f644.zip |
Rename project from libkmod to kmod
Diffstat (limited to 'README')
-rw-r--r-- | README | 60 |
1 files changed, 7 insertions, 53 deletions
@@ -1,58 +1,12 @@ -libkmod - linux kernel module handling library - -ABSTRACT -======== - -libkmod was created to allow programs to easily insert, remove and -list modules, also checking its properties, dependencies and aliases. - -there is no shared/global context information and it can be used by -multiple sites on a single program, also being able to be used from -threads, although it's not thread safe (you must lock explicitly). - +kmod - Linux kernel module handling OVERVIEW ======== -Every user should create and manage it's own library context with: - - struct kmod_ctx *ctx = kmod_new(kernel_dirname); - kmod_unref(ctx); - - -Modules can be created with 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 */ - } - } +kmod is a set of tools to handle common tasks with Linux kernel modules like +insert, remove, list, check properties, resolve dependencies and aliases. +These tools are designed on top of libkmod, a library that is shipped with +kmod. See libkmod/README for more details on this library and how to use it. +The aim is to be compatible with tools, configurations and indexes from +module-init-tools project. |