README.adoc

Alpine Kernel Module Support (AKMS)

AKMS is a tool that enables building out-of-tree (external) Linux kernel modules from source for each installed kernel on the user’s system in an automated and organized fashion. The concept is to have kernel modules automatically rebuilt when a new kernel version is installed.

AKMS is inspired by DKMS (Dynamic Kernel Module Support) used on many Linux distributions. It has been designed specifically for Alpine Linux and APK; implemented with simplicity, reliability, and security in mind.

See the following manual pages for more information.

Manual Pages

• akms(8)

• akms.conf(5)

• AKMBUILD(5)

Requirements

Runtime:

• POSIX-sh compatible shell with pipefail (e.g. Busybox ash, ZSH, bash, …)

• env, grep, install, mount, umount, sed, su, tr (Busybox or GNU)

• depmod from kmod

• apk-tools

• bubblewrap

• Linux kernel with OverlayFS and namespaces

Build:

• GNU Make

• Asciidoctor (for building man pages)

Installation

Install package akms on Alpine Linux v3.15 or later:

apk add akms

License

This project is licensed under MIT License. For the full text of the license, see the LICENSE file.