kmod/libkmod
Emil Velikov 9cc16ef0ac libkmod: use uint8_t for the child prefix/index
Stop implicitly casting the child prefix/index to int. It can have high
bits set thus get promoted to wildly incorrect value and cause chaos
further on.

In addition, convert the existing `unsigned char` instances to uint8_t,
which better illustrates what we're after - a fixed sized 8 bit unsigned
integer.

Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
Link: https://github.com/kmod-project/kmod/pull/251
Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
2024-11-22 15:31:15 -06:00
..
docs docs: annotate the deprecated API 2024-10-23 23:19:11 -05: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-builtin.c strbuf: Add strbuf_used() 2024-11-17 15:35:13 -06:00
libkmod-config.c libkmod: Introduce kmod_list_release 2024-11-15 12:59:45 -06:00
libkmod-elf.c libkmod, tools: Fix format specifiers 2024-11-20 22:34:33 -06:00
libkmod-file-xz.c libkmod: mass convert with clang-format 2024-09-24 09:59:20 -05:00
libkmod-file-zlib.c libkmod: mass convert with clang-format 2024-09-24 09:59:20 -05:00
libkmod-file-zstd.c libkmod: Fix file error handling regression 2024-11-19 00:24:58 -06:00
libkmod-file.c libkmod: Fix file error handling regression 2024-11-19 00:24:58 -06:00
libkmod-index.c libkmod: use uint8_t for the child prefix/index 2024-11-22 15:31:15 -06:00
libkmod-index.h libkmod: const struct index_mm as applicable 2024-11-07 13:43:49 -06:00
libkmod-internal-file.h libkmod: mass convert with clang-format 2024-09-24 09:59:20 -05:00
libkmod-internal.h libkmod: Propagate hash_add errors 2024-11-20 22:34:33 -06:00
libkmod-list.c libkmod: Release memory on error paths 2024-11-15 12:59:45 -06:00
libkmod-module.c libkmod: Prevent ouf of boundary access 2024-11-20 22:34:33 -06:00
libkmod-signature.c libkmod: mass convert with clang-format 2024-09-24 09:59:20 -05:00
libkmod.c libkmod: Propagate hash_add errors 2024-11-20 22:34:33 -06:00
libkmod.h libkmod: Fix typo in libkmod.h 2024-10-28 21:55:10 -05:00
libkmod.pc.in add Zstandard compression support 2020-09-10 21:55:01 -07:00
libkmod.sym libkmod: document the symbols file 2024-09-14 17:51:01 -05:00
Makefile build-sys: add small redirecting Makefiles 2014-03-06 01:59:58 -03:00
README README: Move items from TODO 2013-07-17 02:31:27 -03: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 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 */
      }
   }