162306a36Sopenharmony_ci.. _kernel_docs:
262306a36Sopenharmony_ci
362306a36Sopenharmony_ciIndex of Further Kernel Documentation
462306a36Sopenharmony_ci=====================================
562306a36Sopenharmony_ci
662306a36Sopenharmony_ciThe need for a document like this one became apparent in the
762306a36Sopenharmony_cilinux-kernel mailing list as the same questions, asking for pointers
862306a36Sopenharmony_cito information, appeared again and again.
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ciFortunately, as more and more people get to GNU/Linux, more and more
1162306a36Sopenharmony_ciget interested in the Kernel. But reading the sources is not always
1262306a36Sopenharmony_cienough. It is easy to understand the code, but miss the concepts, the
1362306a36Sopenharmony_ciphilosophy and design decisions behind this code.
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ciUnfortunately, not many documents are available for beginners to
1662306a36Sopenharmony_cistart. And, even if they exist, there was no "well-known" place which
1762306a36Sopenharmony_cikept track of them. These lines try to cover this lack.
1862306a36Sopenharmony_ci
1962306a36Sopenharmony_ciPLEASE, if you know any paper not listed here or write a new document,
2062306a36Sopenharmony_ciinclude a reference to it here, following the kernel's patch submission
2162306a36Sopenharmony_ciprocess. Any corrections, ideas or comments are also welcome.
2262306a36Sopenharmony_ci
2362306a36Sopenharmony_ciAll documents are cataloged with the following fields: the document's
2462306a36Sopenharmony_ci"Title", the "Author"/s, the "URL" where they can be found, some
2562306a36Sopenharmony_ci"Keywords" helpful when searching for specific topics, and a brief
2662306a36Sopenharmony_ci"Description" of the Document.
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ci.. note::
2962306a36Sopenharmony_ci
3062306a36Sopenharmony_ci   The documents on each section of this document are ordered by its
3162306a36Sopenharmony_ci   published date, from the newest to the oldest. The maintainer(s) should
3262306a36Sopenharmony_ci   periodically retire resources as they become obsolete or outdated; with
3362306a36Sopenharmony_ci   the exception of foundational books.
3462306a36Sopenharmony_ci
3562306a36Sopenharmony_ciDocs at the Linux Kernel tree
3662306a36Sopenharmony_ci-----------------------------
3762306a36Sopenharmony_ci
3862306a36Sopenharmony_ciThe Sphinx books should be built with ``make {htmldocs | pdfdocs | epubdocs}``.
3962306a36Sopenharmony_ci
4062306a36Sopenharmony_ci    * Name: **linux/Documentation**
4162306a36Sopenharmony_ci
4262306a36Sopenharmony_ci      :Author: Many.
4362306a36Sopenharmony_ci      :Location: Documentation/
4462306a36Sopenharmony_ci      :Keywords: text files, Sphinx.
4562306a36Sopenharmony_ci      :Description: Documentation that comes with the kernel sources,
4662306a36Sopenharmony_ci        inside the Documentation directory. Some pages from this document
4762306a36Sopenharmony_ci        (including this document itself) have been moved there, and might
4862306a36Sopenharmony_ci        be more up to date than the web version.
4962306a36Sopenharmony_ci
5062306a36Sopenharmony_ciOn-line docs
5162306a36Sopenharmony_ci------------
5262306a36Sopenharmony_ci
5362306a36Sopenharmony_ci    * Title: **Linux Kernel Mailing List Glossary**
5462306a36Sopenharmony_ci
5562306a36Sopenharmony_ci      :Author: various
5662306a36Sopenharmony_ci      :URL: https://kernelnewbies.org/KernelGlossary
5762306a36Sopenharmony_ci      :Date: rolling version
5862306a36Sopenharmony_ci      :Keywords: glossary, terms, linux-kernel.
5962306a36Sopenharmony_ci      :Description: From the introduction: "This glossary is intended as
6062306a36Sopenharmony_ci        a brief description of some of the acronyms and terms you may hear
6162306a36Sopenharmony_ci        during discussion of the Linux kernel".
6262306a36Sopenharmony_ci
6362306a36Sopenharmony_ci    * Title: **The Linux Kernel Module Programming Guide**
6462306a36Sopenharmony_ci
6562306a36Sopenharmony_ci      :Author: Peter Jay Salzman, Michael Burian, Ori Pomerantz, Bob Mottram,
6662306a36Sopenharmony_ci        Jim Huang.
6762306a36Sopenharmony_ci      :URL: https://sysprog21.github.io/lkmpg/
6862306a36Sopenharmony_ci      :Date: 2021
6962306a36Sopenharmony_ci      :Keywords: modules, GPL book, /proc, ioctls, system calls,
7062306a36Sopenharmony_ci        interrupt handlers .
7162306a36Sopenharmony_ci      :Description: A very nice GPL book on the topic of modules
7262306a36Sopenharmony_ci        programming. Lots of examples. Currently the new version is being
7362306a36Sopenharmony_ci        actively maintained at https://github.com/sysprog21/lkmpg.
7462306a36Sopenharmony_ci
7562306a36Sopenharmony_ciPublished books
7662306a36Sopenharmony_ci---------------
7762306a36Sopenharmony_ci
7862306a36Sopenharmony_ci    * Title: **Linux Kernel Debugging: Leverage proven tools and advanced techniques to effectively debug Linux kernels and kernel modules**
7962306a36Sopenharmony_ci
8062306a36Sopenharmony_ci      :Author: Kaiwan N Billimoria
8162306a36Sopenharmony_ci      :Publisher: Packt Publishing Ltd
8262306a36Sopenharmony_ci      :Date: August, 2022
8362306a36Sopenharmony_ci      :Pages: 638
8462306a36Sopenharmony_ci      :ISBN: 978-1801075039
8562306a36Sopenharmony_ci      :Notes: Debugging book
8662306a36Sopenharmony_ci
8762306a36Sopenharmony_ci    * Title: **Linux Kernel Programming: A Comprehensive Guide to Kernel Internals, Writing Kernel Modules, and Kernel Synchronization**
8862306a36Sopenharmony_ci
8962306a36Sopenharmony_ci      :Author: Kaiwan N Billimoria
9062306a36Sopenharmony_ci      :Publisher: Packt Publishing Ltd
9162306a36Sopenharmony_ci      :Date: March, 2021
9262306a36Sopenharmony_ci      :Pages: 754
9362306a36Sopenharmony_ci      :ISBN: 978-1789953435
9462306a36Sopenharmony_ci
9562306a36Sopenharmony_ci    * 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**
9662306a36Sopenharmony_ci
9762306a36Sopenharmony_ci      :Author: Kaiwan N Billimoria
9862306a36Sopenharmony_ci      :Publisher: Packt Publishing Ltd
9962306a36Sopenharmony_ci      :Date: March, 2021
10062306a36Sopenharmony_ci      :Pages: 452
10162306a36Sopenharmony_ci      :ISBN: 978-1801079518
10262306a36Sopenharmony_ci
10362306a36Sopenharmony_ci    * Title: **Linux System Programming: Talking Directly to the Kernel and C Library**
10462306a36Sopenharmony_ci
10562306a36Sopenharmony_ci      :Author: Robert Love
10662306a36Sopenharmony_ci      :Publisher: O'Reilly Media
10762306a36Sopenharmony_ci      :Date: June, 2013
10862306a36Sopenharmony_ci      :Pages: 456
10962306a36Sopenharmony_ci      :ISBN: 978-1449339531
11062306a36Sopenharmony_ci      :Notes: Foundational book
11162306a36Sopenharmony_ci
11262306a36Sopenharmony_ci    * Title: **Linux Kernel Development, 3rd Edition**
11362306a36Sopenharmony_ci
11462306a36Sopenharmony_ci      :Author: Robert Love
11562306a36Sopenharmony_ci      :Publisher: Addison-Wesley
11662306a36Sopenharmony_ci      :Date: July, 2010
11762306a36Sopenharmony_ci      :Pages: 440
11862306a36Sopenharmony_ci      :ISBN: 978-0672329463
11962306a36Sopenharmony_ci      :Notes: Foundational book
12062306a36Sopenharmony_ci
12162306a36Sopenharmony_ci    * Title: **Practical Linux System Administration: A Guide to Installation, Configuration, and Management, 1st Edition**
12262306a36Sopenharmony_ci
12362306a36Sopenharmony_ci      :Author: Kenneth Hess
12462306a36Sopenharmony_ci      :Publisher: O'Reilly Media
12562306a36Sopenharmony_ci      :Date: May, 2023
12662306a36Sopenharmony_ci      :Pages: 246
12762306a36Sopenharmony_ci      :ISBN: 978-1098109035
12862306a36Sopenharmony_ci      :Notes: System administration
12962306a36Sopenharmony_ci
13062306a36Sopenharmony_ci.. _ldd3_published:
13162306a36Sopenharmony_ci
13262306a36Sopenharmony_ci    * Title: **Linux Device Drivers, 3rd Edition**
13362306a36Sopenharmony_ci
13462306a36Sopenharmony_ci      :Authors: Jonathan Corbet, Alessandro Rubini, and Greg Kroah-Hartman
13562306a36Sopenharmony_ci      :Publisher: O'Reilly & Associates
13662306a36Sopenharmony_ci      :Date: 2005
13762306a36Sopenharmony_ci      :Pages: 636
13862306a36Sopenharmony_ci      :ISBN: 0-596-00590-3
13962306a36Sopenharmony_ci      :Notes: Foundational book. Further information in
14062306a36Sopenharmony_ci        http://www.oreilly.com/catalog/linuxdrive3/
14162306a36Sopenharmony_ci        PDF format, URL: https://lwn.net/Kernel/LDD3/
14262306a36Sopenharmony_ci
14362306a36Sopenharmony_ci    * Title: **The Design of the UNIX Operating System**
14462306a36Sopenharmony_ci
14562306a36Sopenharmony_ci      :Author: Maurice J. Bach
14662306a36Sopenharmony_ci      :Publisher: Prentice Hall
14762306a36Sopenharmony_ci      :Date: 1986
14862306a36Sopenharmony_ci      :Pages: 471
14962306a36Sopenharmony_ci      :ISBN: 0-13-201757-1
15062306a36Sopenharmony_ci      :Notes: Foundational book
15162306a36Sopenharmony_ci
15262306a36Sopenharmony_ciMiscellaneous
15362306a36Sopenharmony_ci-------------
15462306a36Sopenharmony_ci
15562306a36Sopenharmony_ci    * Name: **Cross-Referencing Linux**
15662306a36Sopenharmony_ci
15762306a36Sopenharmony_ci      :URL: https://elixir.bootlin.com/
15862306a36Sopenharmony_ci      :Keywords: Browsing source code.
15962306a36Sopenharmony_ci      :Description: Another web-based Linux kernel source code browser.
16062306a36Sopenharmony_ci        Lots of cross references to variables and functions. You can see
16162306a36Sopenharmony_ci        where they are defined and where they are used.
16262306a36Sopenharmony_ci
16362306a36Sopenharmony_ci    * Name: **Linux Weekly News**
16462306a36Sopenharmony_ci
16562306a36Sopenharmony_ci      :URL: https://lwn.net
16662306a36Sopenharmony_ci      :Keywords: latest kernel news.
16762306a36Sopenharmony_ci      :Description: The title says it all. There's a fixed kernel section
16862306a36Sopenharmony_ci        summarizing developers' work, bug fixes, new features and versions
16962306a36Sopenharmony_ci        produced during the week.
17062306a36Sopenharmony_ci
17162306a36Sopenharmony_ci    * Name: **The home page of Linux-MM**
17262306a36Sopenharmony_ci
17362306a36Sopenharmony_ci      :Author: The Linux-MM team.
17462306a36Sopenharmony_ci      :URL: https://linux-mm.org/
17562306a36Sopenharmony_ci      :Keywords: memory management, Linux-MM, mm patches, TODO, docs,
17662306a36Sopenharmony_ci        mailing list.
17762306a36Sopenharmony_ci      :Description: Site devoted to Linux Memory Management development.
17862306a36Sopenharmony_ci        Memory related patches, HOWTOs, links, mm developers... Don't miss
17962306a36Sopenharmony_ci        it if you are interested in memory management development!
18062306a36Sopenharmony_ci
18162306a36Sopenharmony_ci    * Name: **Kernel Newbies IRC Channel and Website**
18262306a36Sopenharmony_ci
18362306a36Sopenharmony_ci      :URL: https://www.kernelnewbies.org
18462306a36Sopenharmony_ci      :Keywords: IRC, newbies, channel, asking doubts.
18562306a36Sopenharmony_ci      :Description: #kernelnewbies on irc.oftc.net.
18662306a36Sopenharmony_ci        #kernelnewbies is an IRC network dedicated to the 'newbie'
18762306a36Sopenharmony_ci        kernel hacker. The audience mostly consists of people who are
18862306a36Sopenharmony_ci        learning about the kernel, working on kernel projects or
18962306a36Sopenharmony_ci        professional kernel hackers that want to help less seasoned kernel
19062306a36Sopenharmony_ci        people.
19162306a36Sopenharmony_ci        #kernelnewbies is on the OFTC IRC Network.
19262306a36Sopenharmony_ci        Try irc.oftc.net as your server and then /join #kernelnewbies.
19362306a36Sopenharmony_ci        The kernelnewbies website also hosts articles, documents, FAQs...
19462306a36Sopenharmony_ci
19562306a36Sopenharmony_ci    * Name: **linux-kernel mailing list archives and search engines**
19662306a36Sopenharmony_ci
19762306a36Sopenharmony_ci      :URL: http://vger.kernel.org/vger-lists.html
19862306a36Sopenharmony_ci      :URL: http://www.uwsg.indiana.edu/hypermail/linux/kernel/index.html
19962306a36Sopenharmony_ci      :URL: http://groups.google.com/group/mlist.linux.kernel
20062306a36Sopenharmony_ci      :Keywords: linux-kernel, archives, search.
20162306a36Sopenharmony_ci      :Description: Some of the linux-kernel mailing list archivers. If
20262306a36Sopenharmony_ci        you have a better/another one, please let me know.
20362306a36Sopenharmony_ci
20462306a36Sopenharmony_ci-------
20562306a36Sopenharmony_ci
20662306a36Sopenharmony_ciThis document was originally based on:
20762306a36Sopenharmony_ci
20862306a36Sopenharmony_ci https://www.dit.upm.es/~jmseyas/linux/kernel/hackers-docs.html
20962306a36Sopenharmony_ci
21062306a36Sopenharmony_ciand written by Juan-Mariano de Goyeneche
211