Skip to content
A simple Linux Kernel Module, written as a learning exercise.
Branch: master
Clone or download
Latest commit cb38530 May 11, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
babel feat: add a mutex to protect io Sep 25, 2018
greeter chore: remove hard coded module name from greeter log messages Sep 24, 2018
.gitignore feat: add the basic babel character device Sep 24, 2018
LICENSE Initial commit Sep 1, 2018
README.md docs(readme): add GuardRails badge Oct 13, 2018

README.md

linux-kernel-module

GuardRails badge

Simple examples of Linux Kernel Modules, written as a learning exercise.

Sample 1: Greeter

This sample simply takes a name as a parameter, and writes a greeting to the kernel log (/var/log/kern.log). cd into greeter/ before running any of the commands before.

Building the Module

make

The module is compiled to greeter.ko.

Installing / Uninstalling

# Install:
sudo insmod greeter.ko

# Install with parameters:
sudo insmod greeter.ko name=Frodo

# Uninstall
sudo rmmod greeter

Sample 2: Babel

babel is a character driver which adds a device called /dev/babel. This is a device you can 'talk' to. It'll babble back in gibberish.

Install with:

cd babel
make
sudo insmod babel.ko

Then run the test client, which'll let you chat with the /dev/babel device:

sudo ./babel-client

Uninstall with:

sudo rmmod babel

Make the /dev/babel device read/write accessible without super user priviledges by adding a rule. First get the Kernal and Subsystem name:

udevadm info -a -p /sys/class/babel/babel

# Will show something like:
#   KERNEL=="babel"
#   SUBSYSTEM=="babel"

Now create a low-priority rule to enable user access:

echo 'KERNEL=="babel", SUBSYSTEM=="babel", MODE="0666"' >> /etc/udev/rules.d/99-babel.rules

Reload the driver and it will be accessible without superuser rights.

Tips

Show loaded modules with:

lsmod

Show menuconfig with:

sudo make menuconfig

Show the kernel log with:

dmesg

Show info about the module:

modinfo greeter.ko

Note: if you get the following error:

insmod: ERROR: could not insert module greeter.ko: Invalid parameters

Then make sure you are not trying to install the module from a shared location (such as a shared folder on a virtual machine). Copy it to the home directory and install from there instead.

Trace module calls with:

sudo apt-get install strace
sudo strace ./babel/babel_client

strace will show low-level system calls in realtime as the program makes them.

Reading

The bulk of this code came from:

With the inspiration from the "Introduction to Linux Kernels" webinar from the Linux Foundation.

You can’t perform that action at this time.