Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spytheman/simple_kernel_module_in_v
An example of writing an external, simple Linux kernel module, in V.
https://github.com/spytheman/simple_kernel_module_in_v
kernel-module linux proof-of-concept vlang
Last synced: about 2 months ago
JSON representation
An example of writing an external, simple Linux kernel module, in V.
- Host: GitHub
- URL: https://github.com/spytheman/simple_kernel_module_in_v
- Owner: spytheman
- License: mit
- Created: 2021-10-23T09:43:46.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-08-16T08:36:45.000Z (over 2 years ago)
- Last Synced: 2024-10-10T23:33:48.671Z (2 months ago)
- Topics: kernel-module, linux, proof-of-concept, vlang
- Language: Makefile
- Homepage:
- Size: 16.6 KB
- Stars: 27
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-v - Simple Linux kernel module example - Demonstration & test of writing a very simple Linux kernel module, using V. (Other / Operating Systems & OS Development Examples)
README
# A simple Linux kernel module, written in V
The purpose of this repo, is to show how to write and test
a very simple Linux kernel module,
using [the V programming language](https://vlang.io/) .
NB: this is *very* experimental and may break in the future.
It works as of 2021/10/23, with `gcc 10.3.0` and `V 0.2.4 008d15d` .
Update: it also works as of 2022/08/16, with `gcc 10.3.0` and `V 0.3.0 3bc01d6` too.
The `-no-builtin -no-preludes` options produce C code, that may not
even compile, if it depends on some of V's `builtin` module features, like
dynamic arrays, maps, array/string methods, string interpolation etc.
## Prerequisites:
A C compiler, and a V compiler.
On a Debian system, you can install them with:
```bash
apt-get install gcc
git clone https://github.com/vlang/v && cd v && make && ./v symlink
```
Once you have them installed, you can keep them up to date with:
```bash
apt-get upgrade
v up
```
## Building the kernel module:
`make`
See also https://www.kernel.org/doc/html/latest/kbuild/modules.html .
## Loading the module in your kernel:
`sudo insmod vhellokernel.ko`
## Verifying that the module was loaded in the kernel:
`cat /proc/modules |grep vhellokernel`
If everything is ok, you should see something like this:
```
vhellokernel 16384 0 - Live 0x0000000000000000 (OE)
```
Use `dmesg | tail` to see the messages that the module wrote.
## Removing the module from your kernel:
`sudo rmmod vhellokernel.ko`
## `make clean test`
```
0[12:47:53] /v/misc/2021_10_22__02/simple_kernel_module_in_v LINUX $ make clean test
make -C /lib/modules/`uname -r`/build M=$PWD clean
make[1]: Entering directory '/usr/src/linux-headers-5.11.0-38-generic'
CLEAN /v/misc/2021_10_22__02/simple_kernel_module_in_v/Module.symvers
make[1]: Leaving directory '/usr/src/linux-headers-5.11.0-38-generic'
rm -rf vhellokernel.o vhellokernel.c
v -no-builtin -no-preludes -o vhellokernel.c vhellokernel.v
make -C /lib/modules/`uname -r`/build M=$PWD modules
make[1]: Entering directory '/usr/src/linux-headers-5.11.0-38-generic'
CC [M] /v/misc/2021_10_22__02/simple_kernel_module_in_v/vhellokernel.o
MODPOST /v/misc/2021_10_22__02/simple_kernel_module_in_v/Module.symvers
CC [M] /v/misc/2021_10_22__02/simple_kernel_module_in_v/vhellokernel.mod.o
LD [M] /v/misc/2021_10_22__02/simple_kernel_module_in_v/vhellokernel.ko
make[1]: Leaving directory '/usr/src/linux-headers-5.11.0-38-generic'
make load
make[1]: Entering directory '/v/misc/2021_10_22__02/simple_kernel_module_in_v'
sudo insmod vhellokernel.ko
make[1]: Leaving directory '/v/misc/2021_10_22__02/simple_kernel_module_in_v'
cat /proc/modules |grep vhellokernel
vhellokernel 16384 0 - Live 0x0000000000000000 (OE)
make unload
make[1]: Entering directory '/v/misc/2021_10_22__02/simple_kernel_module_in_v'
sudo rmmod vhellokernel.ko
make[1]: Leaving directory '/v/misc/2021_10_22__02/simple_kernel_module_in_v'
0[12:47:56] /v/misc/2021_10_22__02/simple_kernel_module_in_v LINUX $
```
## Further reading:
1. https://tldp.org/LDP/lkmpg/2.6/lkmpg.pdf
2. https://www.kernel.org/doc/html/latest/kbuild/modules.html
3. https://github.com/vlang/v/blob/master/doc/docs.md