kmod/libkmod
Lucas De Marchi 8bdeca11b1 Fix changing hash key after module is inserted in hash
The hash key is not copied so we can't change the string from:
	modname/modalias

	to:

	modname'\0'modalias

in order to setup mod->name and mod->alias.

Now what we do is:

1) if name is in the form 'modname/modalias', the final struct
   kmod_module will be:

   struct kmod_module {
           char *alias;------,
           char *name;-----, |
           char *hashkey;--|-|-,
   }                       | | |
   name <------------------' | |
   alias <-------------------' |
   hashkey <-------------------'

2) if name is in the simple form 'modname', then the final struct
   kmod_module will be:

   struct kmod_module {
           char *alias;------> NULL
           char *name;-----,
           char *hashkey;--|---,
   }                       |   |
   name <------------------*---'
2011-12-15 13:48:19 -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 format of log message 2011-12-14 17:21:46 -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 Fix changing hash key after module is inserted in hash 2011-12-15 13:48:19 -02:00
libkmod-private.h Fix changing hash key after module is inserted in hash 2011-12-15 13:48:19 -02:00
libkmod-util.c Add helper alias_normalize() 2011-12-13 10:41:18 -02:00
libkmod.c Fix changing hash key after module is inserted in hash 2011-12-15 13:48:19 -02:00
libkmod.h Add comment in public header about flags not implemented 2011-12-15 12:27:45 -02:00
libkmod.pc.in Rename libabc to libkmod 2011-11-21 14:35:35 -02:00
libkmod.sym Rename symbol group 2011-12-15 12:26:15 -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

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