sysprog21/lkmpg
Lkmpg
The Linux Kernel Module Programming Guide is an educational resource that teaches how to write, compile, and manage loadable kernel modules for modern Linux kernels. It covers the complete lifecycle of kernel modules, from building and loading to unloading and debugging, with a focus on extending kernel functionality without recompiling the entire kernel.
The guide provides comprehensive coverage of core kernel programming concepts including dynamic module loading, file-operation registration, interrupt handling, kernel-user data copying, concurrency control, and deferred task scheduling. It also addresses device driver development patterns for PCI, USB, and character devices, along with memory management, synchronization mechanisms such as mutexes, spinlocks, and read-write locks, and timing operations using timers and workqueues.
The material includes practical techniques for kernel debugging and testing, virtual filesystem exports through procfs, sysfs, and debugfs, and safe memory allocation and data transfer between user and kernel address spaces. The guide is designed for Linux 5.0+ kernels and includes instructions for testing modules in a virtual machine environment.
Features
- Linux Kernel Module Management - The primary subject of the guide: writing and testing loadable kernel modules for Linux 5.0+ kernels.
- Kernel File-Operation Registrations - Teaches how to bind user-space file operations to kernel functions via file_operations structures.
- Kernel Module Loaders - Teaches dynamically inserting code segments into the running kernel using insmod.
- Kernel Module Unloaders - Teaches removing loaded kernel modules using rmmod and cleaning up resources.
- Module Entry and Exit Point Designators - Teaches designating moduleinit and moduleexit functions for kernel module lifecycle.
- Device Driver IOCTL Communication - Teaches how to pass device-specific control operations from user space to kernel drivers using ioctl.
- Bottom-Half Deferred Work Handlers - Teaches how to defer heavy interrupt work to bottom halves using workqueues and threaded handlers.
- Kernel Module Debuggers - Teaches debugging kernel modules using /proc, sysfs, and debugfs interfaces in a virtual machine.
- Interrupt Handling - Teaches registering callback functions that run immediately when hardware interrupts are triggered.
- Dynamic Module Loaders - Teaches how to insert and remove kernel code segments at runtime using insmod and rmmod.
- Device Drivers - Teaches creating device drivers for PCI, USB, and character devices that interact with kernel subsystem interfaces.
- Character Device Registrations - Teaches how to register character devices with major numbers and file operations for user-space interaction.
- Dynamic Memory Allocation - Teaches dynamic kernel memory allocation using kmalloc and related functions with GFP flags.
- Kernel Memory Allocators and Synchronizers - Covers kernel memory allocation and concurrency control using mutexes, spinlocks, and read-write locks.
- Deferred Work Schedulers - Covers scheduling deferred work from interrupt handlers using workqueues and threaded handlers.
- Kernel Module Compilation - Teaches compiling kernel module source code against the running kernel's build tree to produce a .ko file.
- Kernel-User Data Copying Mechanisms - Teaches safe data transfer between kernel and user spaces using copytouser and copyfromuser.
- User-Kernel Data Copying - Teaches safe data transfer between user and kernel address spaces using dedicated copy functions.
- Memory-Mapped I/O - Teaches reading and writing hardware registers via memory-mapped I/O using architecture-specific accessor functions.
- Mutex-Based Resource Synchronizations - Teaches mutex-based synchronization for protecting shared resources in kernel modules.
- Procfs, Sysfs, and Debugfs Exports - Teaches how to export kernel data to user space via procfs, sysfs, and debugfs virtual files.
- Workqueue Deferred Work - Teaches workqueue-based deferred work scheduling for sleeping operations in kernel modules.
- Interrupt and Deferred Work Handlers - Covers registering interrupt handlers and scheduling deferred work via timers, workqueues, and threaded handlers.
- Spinlocks - Teaches spinlock-based synchronization for short critical sections in atomic kernel context.
- Kernel Mutexes and Spinlocks - Teaches kernel concurrency control using mutexes, spinlocks, and read-write locks.
- Kernel Module Lifecycle Hooks - Teaches how to designate moduleinit and moduleexit functions for kernel module lifecycle management.
- Proc File Entry Creations - Teaches how to create /proc file entries with custom read and write handlers for kernel data export.
- Read-Write Lock Shared Data Protection - Teaches read-write locks for optimizing concurrent read access in kernel modules.
- Short - Teaches short execution delays using udelay, mdelay, and msleep in kernel modules.
- Debugfs Interface Creations - Teaches how to create debugfs entries for exporting debugging information from kernel modules.
- Timer-Based Deferred Work Scheduling - Teaches kernel timer-based deferred work scheduling for periodic and delayed tasks.
- GPIO Pin Controllers - Teaches how to configure GPIO pins as inputs or outputs and read or set their voltage levels.
- DMA Setup for Devices - Teaches how to configure DMA masks and allocate buffers for direct memory access in device drivers.
- Asynchronous Device Notifications - Teaches how to deliver SIGIO signals to user space when a device becomes ready for I/O.
- Character Device Unregistrations - Teaches how to release major numbers and clean up device nodes during module removal.
- Device Readiness Polling Interfaces - Teaches how to implement poll, select, and epoll support for device readiness reporting.
- PCI Device Driver Implementations - Teaches how to write PCI device drivers that bind to hardware and manage resources.
- USB Device Driver Implementations - Teaches how to write USB device drivers that communicate via USB Request Blocks.
- Integer Atomic Operations - Covers atomic integer and bit operations for lock-free concurrency in kernel modules.
- Sysfs Attribute Creations - Teaches how to expose kernel variables as sysfs files for user-space read and write access.
- Completion-Based Thread Synchronization - Teaches kernel completion primitives for blocking threads until a task finishes.
- Condition-Based - Teaches condition-based process sleeping using waitevent and wakeup primitives.
- Monotonic Time Measurement - Teaches monotonic clock time measurement for interval timing in kernel modules.
