JustForFun/kernel_module_learn
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

README.md: Add more informations

Browse source
This commit is contained in:
Florian RICHER 2025-02-10 13:44:44 +01:00
parent 41839adab9
commit d9ba290238
1 changed files with 9 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
README.md
View file

@ -9,13 +9,15 @@ Otherwise, change linux_dev variable with you kernel variant and change flake.lo
On other distros: On other distros:
1. With Nix env, .envrc, change line by `use flake .#other` 1. With direnv, in .envrc, change line by `use flake .#other`
2. Without Nix env, you need to setup LINUX_MODULES_FOLDER to linux modules folder of your distro (ex: `/lib/modules/$(uname -r)`) in your shell (bashrc) 2. With nix only, use `nix develop .#other`
3. Otherwise, you need to setup LINUX_MODULES_FOLDER to linux modules folder of your distro (ex: `/lib/modules/$(uname -r)`) in your shell (ex: .bashrc)
## make : targets list ## make : targets list
- all : Compiling kernel - all : Compiling kernel (by default)
- clean : Cleaning build folder - clean : Cleaning build folder
All subfolder is configured to use LINUX_MODULES_FOLDER env variable set by flake develop All subfolder is configured to use LINUX_MODULES_FOLDER env variable set by flake develop
@ -28,7 +30,7 @@ Step 1: Load module
sudo insmod [module_name].ko sudo insmod [module_name].ko
``` ```
**Warning**: Can fail if secure boot is enabled **Warning**: Can fail if secure boot is enabled (see notes about secure boot in below)
Step 2: Check logs Step 2: Check logs
@ -61,18 +63,18 @@ Search -I args and -D args
### Sign kernel module for testing with secure boot enabled ### Sign kernel module for testing with secure boot enabled
Prerequisites: Own secure boot keys Prerequisites: Own secure boot keys configured.
Secure boot keys can be found in : Secure boot keys can be found in :
- Fedora : `/etc/pki/akmods/certs/` - Fedora : `/etc/pki/akmods`
- With sbctl : `/var/lib/sbctl` - With sbctl : `/var/lib/sbctl`
``` ```
sign-file sha256 $SECUREBOOT_KEYS_PATH/private_key.priv $SECUREBOOT_KEYS_PATH/public_key.der <module_file>.ko sign-file sha256 $SECUREBOOT_KEYS_PATH/private_key.priv $SECUREBOOT_KEYS_PATH/public_key.der <module_file>.ko
``` ```
sign-file is in `/usr/src/kernels/$(uname -r)/scripts` sign-file executable is in `/usr/src/kernels/$(uname -r)/scripts`
Full example (run as root): Full example (run as root):