| .. _kernel_docs: |
| |
| Index of Further Kernel Documentation |
| ===================================== |
| |
| The need for a document like this one became apparent in the linux-kernel |
| mailing list as the same questions, asking for pointers to information, |
| appeared again and again. |
| |
| Fortunately, as more and more people get to GNU/Linux, more and more get |
| interested in the Kernel. But reading the sources is not always enough. It |
| is easy to understand the code, but miss the concepts, the philosophy and |
| design decisions behind this code. |
| |
| Unfortunately, not many documents are available for beginners to start. |
| And, even if they exist, there was no "well-known" place which kept track |
| of them. These lines try to cover this lack. |
| |
| PLEASE, if you know any paper not listed here or write a new document, |
| include a reference to it here, following the kernel's patch submission |
| process. Any corrections, ideas or comments are also welcome. |
| |
| All documents are cataloged with the following fields: the document's |
| "Title", the "Author"/s, the "URL" where they can be found, some "Keywords" |
| helpful when searching for specific topics, and a brief "Description" of |
| the Document. |
| |
| .. note:: |
| |
| The documents on each section of this document are ordered by its |
| published date, from the newest to the oldest. The maintainer(s) should |
| periodically retire resources as they become obsolete or outdated; with |
| the exception of foundational books. |
| |
| Docs at the Linux Kernel tree |
| ----------------------------- |
| |
| The Sphinx books should be built with ``make {htmldocs | pdfdocs | epubdocs}``. |
| |
| * Name: **linux/Documentation** |
| |
| :Author: Many. |
| :Location: Documentation/ |
| :Keywords: text files, Sphinx. |
| :Description: Documentation that comes with the kernel sources, |
| inside the Documentation directory. Some pages from this document |
| (including this document itself) have been moved there, and might |
| be more up to date than the web version. |
| |
| On-line docs |
| ------------ |
| |
| * Title: **Linux Kernel Mailing List Glossary** |
| |
| :Author: various |
| :URL: https://kernelnewbies.org/KernelGlossary |
| :Date: rolling version |
| :Keywords: glossary, terms, linux-kernel. |
| :Description: From the introduction: "This glossary is intended as |
| a brief description of some of the acronyms and terms you may hear |
| during discussion of the Linux kernel". |
| |
| * Title: **The Linux Kernel Module Programming Guide** |
| |
| :Author: Peter Jay Salzman, Michael Burian, Ori Pomerantz, Bob Mottram, |
| Jim Huang. |
| :URL: https://sysprog21.github.io/lkmpg/ |
| :Date: 2021 |
| :Keywords: modules, GPL book, /proc, ioctls, system calls, |
| interrupt handlers . |
| :Description: A very nice GPL book on the topic of modules |
| programming. Lots of examples. Currently the new version is being |
| actively maintained at https://github.com/sysprog21/lkmpg. |
| |
| Published books |
| --------------- |
| |
| * Title: **Practical Linux System Administration: A Guide to Installation, Configuration, and Management, 1st Edition** |
| |
| :Author: Kenneth Hess |
| :Publisher: O'Reilly Media |
| :Date: May, 2023 |
| :Pages: 246 |
| :ISBN: 978-1098109035 |
| :Notes: System administration |
| |
| * Title: **Linux Kernel Debugging: Leverage proven tools and advanced techniques to effectively debug Linux kernels and kernel modules** |
| |
| :Author: Kaiwan N Billimoria |
| :Publisher: Packt Publishing Ltd |
| :Date: August, 2022 |
| :Pages: 638 |
| :ISBN: 978-1801075039 |
| :Notes: Debugging book |
| |
| * Title: **Linux Kernel Programming: A Comprehensive Guide to Kernel Internals, Writing Kernel Modules, and Kernel Synchronization** |
| |
| :Author: Kaiwan N Billimoria |
| :Publisher: Packt Publishing Ltd |
| :Date: March, 2021 (Second Edition published in 2024) |
| :Pages: 754 |
| :ISBN: 978-1789953435 (Second Edition ISBN is 978-1803232225) |
| |
| * Title: **Linux Kernel Programming Part 2 - Char Device Drivers and Kernel Synchronization: Create user-kernel interfaces, work with peripheral I/O, and handle hardware interrupts** |
| |
| :Author: Kaiwan N Billimoria |
| :Publisher: Packt Publishing Ltd |
| :Date: March, 2021 |
| :Pages: 452 |
| :ISBN: 978-1801079518 |
| |
| * Title: **Linux System Programming: Talking Directly to the Kernel and C Library** |
| |
| :Author: Robert Love |
| :Publisher: O'Reilly Media |
| :Date: June, 2013 |
| :Pages: 456 |
| :ISBN: 978-1449339531 |
| :Notes: Foundational book |
| |
| * Title: **Linux Kernel Development, 3rd Edition** |
| |
| :Author: Robert Love |
| :Publisher: Addison-Wesley |
| :Date: July, 2010 |
| :Pages: 440 |
| :ISBN: 978-0672329463 |
| :Notes: Foundational book |
| |
| .. _ldd3_published: |
| |
| * Title: **Linux Device Drivers, 3rd Edition** |
| |
| :Authors: Jonathan Corbet, Alessandro Rubini, and Greg Kroah-Hartman |
| :Publisher: O'Reilly & Associates |
| :Date: 2005 |
| :Pages: 636 |
| :ISBN: 0-596-00590-3 |
| :Notes: Foundational book. Further information in |
| http://www.oreilly.com/catalog/linuxdrive3/ |
| PDF format, URL: https://lwn.net/Kernel/LDD3/ |
| |
| * Title: **The Design of the UNIX Operating System** |
| |
| :Author: Maurice J. Bach |
| :Publisher: Prentice Hall |
| :Date: 1986 |
| :Pages: 471 |
| :ISBN: 0-13-201757-1 |
| :Notes: Foundational book |
| |
| Miscellaneous |
| ------------- |
| |
| * Name: **Cross-Referencing Linux** |
| |
| :URL: https://elixir.bootlin.com/ |
| :Keywords: Browsing source code. |
| :Description: Another web-based Linux kernel source code browser. |
| Lots of cross references to variables and functions. You can see |
| where they are defined and where they are used. |
| |
| * Name: **Linux Weekly News** |
| |
| :URL: https://lwn.net |
| :Keywords: latest kernel news. |
| :Description: The title says it all. There's a fixed kernel section |
| summarizing developers' work, bug fixes, new features and versions |
| produced during the week. |
| |
| * Name: **The home page of Linux-MM** |
| |
| :Author: The Linux-MM team. |
| :URL: https://linux-mm.org/ |
| :Keywords: memory management, Linux-MM, mm patches, TODO, docs, |
| mailing list. |
| :Description: Site devoted to Linux Memory Management development. |
| Memory related patches, HOWTOs, links, mm developers... Don't miss |
| it if you are interested in memory management development! |
| |
| * Name: **Kernel Newbies IRC Channel and Website** |
| |
| :URL: https://www.kernelnewbies.org |
| :Keywords: IRC, newbies, channel, asking doubts. |
| :Description: #kernelnewbies on irc.oftc.net. |
| #kernelnewbies is an IRC network dedicated to the 'newbie' |
| kernel hacker. The audience mostly consists of people who are |
| learning about the kernel, working on kernel projects or |
| professional kernel hackers that want to help less seasoned kernel |
| people. |
| #kernelnewbies is on the OFTC IRC Network. |
| Try irc.oftc.net as your server and then /join #kernelnewbies. |
| The kernelnewbies website also hosts articles, documents, FAQs... |
| |
| * Name: **linux-kernel mailing list archives and search engines** |
| |
| :URL: https://subspace.kernel.org |
| :URL: https://lore.kernel.org |
| :Keywords: linux-kernel, archives, search. |
| :Description: Some of the linux-kernel mailing list archivers. If |
| you have a better/another one, please let me know. |
| |
| * Name: **The Linux Foundation YouTube channel** |
| |
| :URL: https://www.youtube.com/user/thelinuxfoundation |
| :Keywords: linux, videos, linux-foundation, youtube. |
| :Description: The Linux Foundation uploads video recordings of their |
| collaborative events, Linux conferences including LinuxCon, and |
| other original research and content related to Linux and software |
| development. |
| |
| Rust |
| ---- |
| |
| * Title: **Rust for Linux** |
| |
| :Author: various |
| :URL: https://rust-for-linux.com/ |
| :Date: rolling version |
| :Keywords: glossary, terms, linux-kernel, rust. |
| :Description: From the website: "Rust for Linux is the project adding |
| support for the Rust language to the Linux kernel. This website is |
| intended as a hub of links, documentation and resources related to |
| the project". |
| |
| * Title: **Learn Rust the Dangerous Way** |
| |
| :Author: Cliff L. Biffle |
| :URL: https://cliffle.com/p/dangerust/ |
| :Date: Accessed Sep 11 2024 |
| :Keywords: rust, blog. |
| :Description: From the website: "LRtDW is a series of articles |
| putting Rust features in context for low-level C programmers who |
| maybe don’t have a formal CS background — the sort of people who |
| work on firmware, game engines, OS kernels, and the like. |
| Basically, people like me.". It illustrates line-by-line |
| conversions from C to Rust. |
| |
| * Title: **The Rust Book** |
| |
| :Author: Steve Klabnik and Carol Nichols, with contributions from the |
| Rust community |
| :URL: https://doc.rust-lang.org/book/ |
| :Date: Accessed Sep 11 2024 |
| :Keywords: rust, book. |
| :Description: From the website: "This book fully embraces the |
| potential of Rust to empower its users. It’s a friendly and |
| approachable text intended to help you level up not just your |
| knowledge of Rust, but also your reach and confidence as a |
| programmer in general. So dive in, get ready to learn—and welcome |
| to the Rust community!". |
| |
| * Title: **Rust for the Polyglot Programmer** |
| |
| :Author: Ian Jackson |
| :URL: https://www.chiark.greenend.org.uk/~ianmdlvl/rust-polyglot/index.html |
| :Date: December 2022 |
| :Keywords: rust, blog, tooling. |
| :Description: From the website: "There are many guides and |
| introductions to Rust. This one is something different: it is |
| intended for the experienced programmer who already knows many |
| other programming languages. I try to be comprehensive enough to be |
| a starting point for any area of Rust, but to avoid going into too |
| much detail except where things are not as you might expect. Also |
| this guide is not entirely free of opinion, including |
| recommendations of libraries (crates), tooling, etc.". |
| |
| * Title: **Fasterthanli.me** |
| |
| :Author: Amos Wenger |
| :URL: https://fasterthanli.me/ |
| :Date: Accessed Sep 11 2024 |
| :Keywords: rust, blog, news. |
| :Description: From the website: "I make articles and videos about how |
| computers work. My content is long-form, didactic and exploratory |
| — and often an excuse to teach Rust!". |
| |
| * Title: **Comprehensive Rust** |
| |
| :Author: Android team at Google |
| :URL: https://google.github.io/comprehensive-rust/ |
| :Date: Accessed Sep 13 2024 |
| :Keywords: rust, blog. |
| :Description: From the website: "The course covers the full spectrum |
| of Rust, from basic syntax to advanced topics like generics and |
| error handling". |
| |
| * Title: **The Embedded Rust Book** |
| |
| :Author: Multiple contributors, mostly Jorge Aparicio |
| :URL: https://docs.rust-embedded.org/book/ |
| :Date: Accessed Sep 13 2024 |
| :Keywords: rust, blog. |
| :Description: From the website: "An introductory book about using |
| the Rust Programming Language on "Bare Metal" embedded systems, |
| such as Microcontrollers". |
| |
| * Title: **Experiment: Improving the Rust Book** |
| |
| :Author: Cognitive Engineering Lab at Brown University |
| :URL: https://rust-book.cs.brown.edu/ |
| :Date: Accessed Sep 22 2024 |
| :Keywords: rust, blog. |
| :Description: From the website: "The goal of this experiment is to |
| evaluate and improve the content of the Rust Book to help people |
| learn Rust more effectively.". |
| |
| * Title: **New Rustacean** (podcast) |
| |
| :Author: Chris Krycho |
| :URL: https://newrustacean.com/ |
| :Date: Accessed Sep 22 2024 |
| :Keywords: rust, podcast. |
| :Description: From the website: "This is a podcast about learning |
| the programming language Rust—from scratch! Apart from this spiffy |
| landing page, all the site content is built with Rust's own |
| documentation tools.". |
| |
| * Title: **Opsem-team** (repository) |
| |
| :Author: Operational semantics team |
| :URL: https://github.com/rust-lang/opsem-team/tree/main |
| :Date: Accessed Sep 22 2024 |
| :Keywords: rust, repository. |
| :Description: From the README: "The opsem team is the successor of |
| the unsafe-code-guidelines working group and responsible for |
| answering many of the difficult questions about the semantics of |
| unsafe Rust". |
| |
| * Title: **You Can't Spell Trust Without Rust** |
| |
| :Author: Alexis Beingessner |
| :URL: https://repository.library.carleton.ca/downloads/1j92g820w?locale=en |
| :Date: 2015 |
| :Keywords: rust, master, thesis. |
| :Description: This thesis focuses on Rust's ownership system, which |
| ensures memory safety by controlling data manipulation and |
| lifetime, while also highlighting its limitations and comparing it |
| to similar systems in Cyclone and C++. |
| |
| * Name: **Linux Plumbers (LPC) 2024 Rust presentations** |
| |
| :Title: Rust microconference |
| :URL: https://lpc.events/event/18/sessions/186/#20240918 |
| :Title: Rust for Linux |
| :URL: https://lpc.events/event/18/contributions/1912/ |
| :Title: Journey of a C kernel engineer starting a Rust driver project |
| :URL: https://lpc.events/event/18/contributions/1911/ |
| :Title: Crafting a Linux kernel scheduler that runs in user-space |
| using Rust |
| :URL: https://lpc.events/event/18/contributions/1723/ |
| :Title: openHCL: A Linux and Rust based paravisor |
| :URL: https://lpc.events/event/18/contributions/1956/ |
| :Keywords: rust, lpc, presentations. |
| :Description: A number of LPC talks related to Rust. |
| |
| * Name: **The Rustacean Station Podcast** |
| |
| :URL: https://rustacean-station.org/ |
| :Keywords: rust, podcasts. |
| :Description: A community project for creating podcast content for |
| the Rust programming language. |
| |
| ------- |
| |
| This document was originally based on: |
| |
| https://www.dit.upm.es/~jmseyas/linux/kernel/hackers-docs.html |
| |
| and written by Juan-Mariano de Goyeneche |