kmod/libkmod at 219f9c38bb283f6173ed37d1eb54671e1ca52349 - kmod

mirror of https://github.com/AuxXxilium/kmod.git synced 2024-12-26 21:35:26 +07:00

History

Lucas De Marchi 219f9c38bb kmod_module: use pointer instead of vector for its name We still have name allocated just after the struct kmod_module, but now we use a pointer instead of putting name as a vector in the end of the structure. The previous way has some problems, the worst is: - it's not possible to swap the name with another value: this is the real problem that this patch is solving. Later patches will make name be swappable with alias, which is not possible if name is a vector.		2011-12-13 13:15:49 -02:00
..
.gitignore	Rename libabc to libkmod	2011-11-21 14:35:35 -02:00
COPYING	Change licenses	2011-12-12 18:24:35 -02:00
libkmod-config.c	Fix "Dead assignments" as reported by llvm	2011-12-12 18:36:27 -02:00
libkmod-hash.c	Change licenses	2011-12-12 18:24:35 -02:00
libkmod-index.c	Fix "Dereference of null pointer" as reported by llvm	2011-12-12 18:43:04 -02:00
libkmod-index.h	Change licenses	2011-12-12 18:24:35 -02:00
libkmod-list.c	Change licenses	2011-12-12 18:24:35 -02:00
libkmod-module.c	kmod_module: use pointer instead of vector for its name	2011-12-13 13:15:49 -02:00
libkmod-private.h	Add helper alias_normalize()	2011-12-13 10:41:18 -02:00
libkmod-util.c	Add helper alias_normalize()	2011-12-13 10:41:18 -02:00
libkmod.c	Return early on lookup error	2011-12-13 10:52:00 -02:00
libkmod.h	Change licenses	2011-12-12 18:24:35 -02:00
libkmod.pc.in	Rename libabc to libkmod	2011-11-21 14:35:35 -02:00
libkmod.sym	Rename kmod_loaded_get_list() to kmod_module_new_from_loaded()	2011-12-12 13:50:19 -02:00
macro.h	Change licenses	2011-12-12 18:24:35 -02:00
README	Rename project from libkmod to kmod	2011-12-12 16:54:18 -02:00

README

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).


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 */
      }
   }