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