Troubleshooting

Troubleshooting

Unsupported kernel

The build intentionally rejects kernels other than 6.8.12-1021-tegra. Never force-load a module built for another ABI. Obtain source matching the new release and update the source and checksum pins before rebuilding.

Missing headers

If /lib/modules/$(uname -r)/build is absent, install the matching NVIDIA kernel headers:

sudo apt install nvidia-l4t-kernel-headers

Module signature warning

The local module is unsigned. The supported kernel permits unsigned modules but records a warning similar to:

uinput: module verification failed: signature and/or required key missing

This is expected and taints the kernel. Do not proceed if CONFIG_MODULE_SIG_FORCE=y or your security policy requires signed modules.

Permission denied

Inspect the node and account groups:

ls -l /dev/uinput
id
getfacl /dev/uinput

The expected owner and mode are root:input and 0660. Log out and back in after installation so input group membership takes effect.

Module is in use

Sunshine keeps uinput file descriptors open. Stop it before unloading:

systemctl --user stop app-dev.lizardbyte.app.Sunshine.service
sudo modprobe --remove uinput

Kernel updates

An update changes the module ABI and module directory. The old module will not be used by the new kernel. Do not copy it into the new kernel's directory. Wait for this project to explicitly support the new NVIDIA release or rebuild from that release's matching source.