1.. SPDX-License-Identifier: GPL-2.0
2
3
4.. The Linux Kernel documentation master file, created by
5   sphinx-quickstart on Fri Feb 12 13:51:46 2016.
6   You can adapt this file completely to your liking, but it should at least
7   contain the root `toctree` directive.
8
9.. _linux_doc:
10
11The Linux Kernel documentation
12==============================
13
14This is the top level of the kernel's documentation tree.  Kernel
15documentation, like the kernel itself, is very much a work in progress;
16that is especially true as we work to integrate our many scattered
17documents into a coherent whole.  Please note that improvements to the
18documentation are welcome; join the linux-doc list at vger.kernel.org if
19you want to help out.
20
21Licensing documentation
22-----------------------
23
24The following describes the license of the Linux kernel source code
25(GPLv2), how to properly mark the license of individual files in the source
26tree, as well as links to the full license text.
27
28* :ref:`kernel_licensing`
29
30User-oriented documentation
31---------------------------
32
33The following manuals are written for *users* of the kernel — those who are
34trying to get it to work optimally on a given system.
35
36.. toctree::
37   :maxdepth: 2
38
39   admin-guide/index
40   kbuild/index
41
42Firmware-related documentation
43------------------------------
44The following holds information on the kernel's expectations regarding the
45platform firmwares.
46
47.. toctree::
48   :maxdepth: 2
49
50   firmware-guide/index
51   devicetree/index
52
53Application-developer documentation
54-----------------------------------
55
56The user-space API manual gathers together documents describing aspects of
57the kernel interface as seen by application developers.
58
59.. toctree::
60   :maxdepth: 2
61
62   userspace-api/index
63
64
65Introduction to kernel development
66----------------------------------
67
68These manuals contain overall information about how to develop the kernel.
69The kernel community is quite large, with thousands of developers
70contributing over the course of a year.  As with any large community,
71knowing how things are done will make the process of getting your changes
72merged much easier.
73
74.. toctree::
75   :maxdepth: 2
76
77   process/index
78   dev-tools/index
79   doc-guide/index
80   kernel-hacking/index
81   trace/index
82   maintainer/index
83   fault-injection/index
84   livepatch/index
85
86
87Kernel API documentation
88------------------------
89
90These books get into the details of how specific kernel subsystems work
91from the point of view of a kernel developer.  Much of the information here
92is taken directly from the kernel source, with supplemental material added
93as needed (or at least as we managed to add it — probably *not* all that is
94needed).
95
96.. toctree::
97   :maxdepth: 2
98
99   driver-api/index
100   core-api/index
101   locking/index
102   accounting/index
103   block/index
104   cdrom/index
105   cpu-freq/index
106   ide/index
107   fb/index
108   fpga/index
109   hid/index
110   i2c/index
111   iio/index
112   isdn/index
113   infiniband/index
114   leds/index
115   netlabel/index
116   networking/index
117   pcmcia/index
118   power/index
119   target/index
120   timers/index
121   spi/index
122   w1/index
123   watchdog/index
124   virt/index
125   input/index
126   hwmon/index
127   gpu/index
128   security/index
129   sound/index
130   crypto/index
131   filesystems/index
132   vm/index
133   bpf/index
134   usb/index
135   PCI/index
136   scsi/index
137   misc-devices/index
138   scheduler/index
139   mhi/index
140
141Architecture-agnostic documentation
142-----------------------------------
143
144.. toctree::
145   :maxdepth: 2
146
147   asm-annotations
148
149Architecture-specific documentation
150-----------------------------------
151
152.. toctree::
153   :maxdepth: 2
154
155   arch
156
157
158Other documentation
159-------------------
160
161There are several unsorted documents that don't seem to fit on other parts
162of the documentation body, or may require some adjustments and/or conversion
163to ReStructured Text format, or are simply too old.
164
165.. toctree::
166   :maxdepth: 2
167
168   staging/index
169   watch_queue
170
171
172Translations
173------------
174
175.. toctree::
176   :maxdepth: 2
177
178   translations/index
179
180Indices and tables
181==================
182
183* :ref:`genindex`
184