github-mirror/lkmpg
2
0
Fork 0
mirror of https://github.com/sysprog21/lkmpg.git synced 2024-11-22 14:18:35 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
The Linux Kernel Module Programming Guide (updated for 5.0+ kernels)
133 Commits 2 Branches 1 Tag 7.9 MiB
TeX 94.4%
Shell 4.9%
Makefile 0.7%
b497b6a34e
Go to file
Jim Huang b497b6a34e Remove never implemented MODULE_SUPPORTED_DEVICE 
MODULE_SUPPORTED_DEVICE is remove from upstream since March 17, 2021.
See linux.git commit 6417f03

Reported by Niklas Lantau <niklaslantau@gmail.com>
Close #61
2021-08-16 20:19:35 +08:00
.github/workflows Temporary fix release action failed issue 2021-08-09 13:04:12 +08:00
examples Remove never implemented MODULE_SUPPORTED_DEVICE 2021-08-16 20:19:35 +08:00
lib Introduce \src to generate Linux kernel source hyperlinks 2021-08-09 23:01:34 +08:00
.gitignore Update .gitignore 2021-08-09 20:23:12 +08:00
GPL-2 Initial import 2021-07-22 06:34:19 +08:00
html.cfg Fix alignment problem in code block (#45) 2021-08-08 01:29:50 +08:00
LICENSE Initial import 2021-07-22 06:34:19 +08:00
lkmpg.tex Avoid incorrectly separated words (#55) 2021-08-16 18:45:43 +08:00
Makefile Remove _minted-lkmpg directory after compiled pdf 2021-08-09 02:14:24 +08:00
README.md Fix wording 2021-08-09 23:46:37 +08:00

README.md

The Linux Kernel Module Programming Guide

This project keeps the Linux Kernel Module Programming Guide reasonably up to date, with working examples for recent 5.x kernel versions.
The guide has been around since 2001 and most copies of it on the web only describe old 2.6.x kernels.

The book can be freely accessed via https://sysprog21.github.io/lkmpg/ or latest PDF file.
The original guide may be found at Linux Documentation Project.

Getting Started

Compile on Local Machine

To prepare for build this book on your local machine, we're going to have make, TeXLive (MacTeX), dvipng and latexmk installed. On various Unix/Linux operating systems, this can be done simply by:

# Debian / Ubuntu
$ sudo apt install make texlive-full latexmk dvipng

# Arch / Manjaro
$ sudo pacman -S make texlive-most texlive-bin dvipng

# macOS
$ brew install --cask mactex
$ sudo tlmgr update --self && sudo tlmgr install dvipng latexmk

Now we could build document with following commands:

# download project
$ git clone https://github.com/sysprog21/lkmpg.git && cd lkmpg

# run commands
$ make all              # Generate PDFdocument
$ make html             # Convert TeX to HTML
$ make clean            # Delete generated files

Compile with Docker

The compilation could be completed flawlessly using Docker. **Using Docker is recommended, as it guarantees the same dependencies with our GitHub Actions wokrflow.

After install docker engine on your machine, pulling the docker image twtug/lkmpg and compile with it.

Execute followings

# download project
$ git clone https://github.com/sysprog21/lkmpg.git && cd lkmpg

# pull docker image and run it as container
$ docker pull twtug/lkmpg
$ docker run --rm -it -v $(pwd):/workdir twtug/lkmpg

# run commands
$ make all              # Generate PDF document
$ make html             # Convert TeX to HTML
$ make clean            # Delete generated files

License

The Linux Kernel Module Programming Guide is a free book; you may reproduce and/or modify it under the terms of the Open Software License.
Use of this work is governed by a copyleft license that can be found in the LICENSE file.

The complementary sample code is licensed under GNU GPL version 2, as same as Linux kernel.