Examples of Linux device drivers, currently targeting Linux 7.2.x.
docs/: tutorial chapters, in reading order.examples/: kernel module examples and userspace test programs.tools/: workspace scripts, QEMU patch, and tool tests.
The tutorial checkout is separate from the runtime workspace (LDD_ROOT).
Start with the workspace setup to create the
workspace and install the helper scripts.
Current test baseline:
- Kernel: Linux 7.2.x.
- Host system: Fedora release 44 (Forty Four).
Other kernel versions and host distributions are not tested.
Set KERNELDIR environment variable to the Linux kernel source dir, and export
it to your local shell.
export KERNELDIR=/path/to/kernel/source/This environment variable is mainly used in Makefile to determine which kernel source tree the drivers are built against.
Driver examples are in examples/. Numbered directories preserve
the learning sequence; rbtree is a supplemental example.
To build an example after setting KERNELDIR, enter its directory:
cd examples/01_hello_world
makeThis repo demonstrates basic examples of Linux Device Driver(LDD) for the purpose of studying and sharing.
Some of the examples in this repo are excerpted from the book of LDD3(Linux Device Drivers, Third Edition), and the other examples are written by myself in necessary to illustrate some important data structures or details.
LDD3 is a great book, which is authored by Jonathan Corbet, Alessandro Rubini, and Greg Kroah-Hartman, I give my sincere appreciation to all these authors for their great work.
LDD3 is available online, and you may request a copy of the PDF from https://lwn.net/Kernel/LDD3/. It is still an excellent book to reference for the development of Linux device module. However, due to its old age, first published in 2005, some of the APIs and data structures have drastically changed after its first publication.
Compare to the Kernel 2.6.10, which is the base of the LDD3 book, I rewrite all the examples for a brand new Kernel version 5.10, released in December 2020. Besides the kernel version, the hardware also has evolved a lot in recent years. The parallel port, which is used as an example in I/O operations in LDD3, can be barely found in any computer now. I moved these examples to a QEMU(A generic and open source machine emulator and virtualizer) virtual machine, in which a virtual parallel port device is implemented for convenient debugging.
This is the opening of my whole project, I hope you will enjoy in the tour of reading my book.
Thanks a lot.
Sincerely, Douglas.
Linux-Device-Driver by d0u9 is licensed under a GNU General Public License, version 2.