mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2024-12-28 16:53:49 +00:00
d0b343605f
Include a new section in the Index of Further Kernel Documentation with resources to learn Rust. Reference it in the Rust index. The resources are a product of a survey among assistants to the conference Kangrejos'24. Signed-off-by: Carlos Bilbao <carlos.bilbao.osdev@gmail.com> Reviewed-by: Dirk Behme <dirk.behme@de.bosch.com> Acked-by: Miguel Ojeda <ojeda@kernel.org> Signed-off-by: Jonathan Corbet <corbet@lwn.net> Link: https://lore.kernel.org/r/20240922160411.274949-1-carlos.bilbao.osdev@gmail.com
371 lines
14 KiB
ReStructuredText
371 lines
14 KiB
ReStructuredText
.. _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
|