LoadPin — The Linux Kernel 6.14.0-gnu-rt3-parabola1-1-rt documentation

# LoadPin

LoadPin is a Linux Security Module that ensures all kernel-loaded files (modules, firmware, etc) all originate from the same filesystem, with the expectation that such a filesystem is backed by a read-only device such as dm-verity or CDROM. This allows systems that have a verified and/or unchangeable filesystem to enforce module and firmware loading restrictions without needing to sign the files individually.

The LSM is selectable at build-time with `CONFIG_SECURITY_LOADPIN`, and can be controlled at boot-time with the kernel command line option “`loadpin.enforce`”. By default, it is enabled, but can be disabled at boot (”`loadpin.enforce=0`”).

LoadPin starts pinning when it sees the first file loaded. If the block device backing the filesystem is not read-only, a sysctl is created to toggle pinning: `/proc/sys/kernel/loadpin/enabled`. (Having a mutable filesystem means pinning is mutable too, but having the sysctl allows for easy testing on systems with a mutable filesystem.)

It’s also possible to exclude specific file types from LoadPin using kernel command line option “`loadpin.exclude`”. By default, all files are included, but they can be excluded using kernel command line option such as “`loadpin.exclude=kernel-module,kexec-image`”. This allows to use different mechanisms such as `CONFIG_MODULE_SIG` and `CONFIG_KEXEC_VERIFY_SIG` to verify kernel module and kernel image while still use LoadPin to protect the integrity of other files kernel loads. The full list of valid file types can be found in `kernel_read_file_str` defined in `include/linux/kernel_read_file.h`.