1 2.. The Linux Kernel documentation master file, created by 3 sphinx-quickstart on Fri Feb 12 13:51:46 2016. 4 You can adapt this file completely to your liking, but it should at least 5 contain the root `toctree` directive. 6 7.. _linux_doc: 8 9The Linux Kernel documentation 10============================== 11 12This is the top level of the kernel's documentation tree. Kernel 13documentation, like the kernel itself, is very much a work in progress; 14that is especially true as we work to integrate our many scattered 15documents into a coherent whole. Please note that improvements to the 16documentation are welcome; join the linux-doc list at vger.kernel.org if 17you want to help out. 18 19Licensing documentation 20----------------------- 21 22The following describes the license of the Linux kernel source code 23(GPLv2), how to properly mark the license of individual files in the source 24tree, as well as links to the full license text. 25 26* :ref:`kernel_licensing` 27 28User-oriented documentation 29--------------------------- 30 31The following manuals are written for *users* of the kernel — those who are 32trying to get it to work optimally on a given system. 33 34.. toctree:: 35 :maxdepth: 2 36 37 admin-guide/index 38 39Firmware-related documentation 40------------------------------ 41The following holds information on the kernel's expectations regarding the 42platform firmwares. 43 44.. toctree:: 45 :maxdepth: 2 46 47 firmware-guide/index 48 49Application-developer documentation 50----------------------------------- 51 52The user-space API manual gathers together documents describing aspects of 53the kernel interface as seen by application developers. 54 55.. toctree:: 56 :maxdepth: 2 57 58 userspace-api/index 59 ioctl/index 60 61 62Introduction to kernel development 63---------------------------------- 64 65These manuals contain overall information about how to develop the kernel. 66The kernel community is quite large, with thousands of developers 67contributing over the course of a year. As with any large community, 68knowing how things are done will make the process of getting your changes 69merged much easier. 70 71.. toctree:: 72 :maxdepth: 2 73 74 process/index 75 dev-tools/index 76 doc-guide/index 77 kernel-hacking/index 78 trace/index 79 maintainer/index 80 81Kernel API documentation 82------------------------ 83 84These books get into the details of how specific kernel subsystems work 85from the point of view of a kernel developer. Much of the information here 86is taken directly from the kernel source, with supplemental material added 87as needed (or at least as we managed to add it — probably *not* all that is 88needed). 89 90.. toctree:: 91 :maxdepth: 2 92 93 driver-api/index 94 core-api/index 95 accounting/index 96 block/index 97 hid/index 98 iio/index 99 leds/index 100 media/index 101 networking/index 102 input/index 103 hwmon/index 104 gpu/index 105 security/index 106 sound/index 107 crypto/index 108 filesystems/index 109 vm/index 110 bpf/index 111 usb/index 112 misc-devices/index 113 mic/index 114 scheduler/index 115 116Architecture-specific documentation 117----------------------------------- 118 119These books provide programming details about architecture-specific 120implementation. 121 122.. toctree:: 123 :maxdepth: 2 124 125 sh/index 126 arm/index 127 arm64/index 128 ia64/index 129 m68k/index 130 riscv/index 131 s390/index 132 sh/index 133 sparc/index 134 x86/index 135 xtensa/index 136 137Filesystem Documentation 138------------------------ 139 140The documentation in this section are provided by specific filesystem 141subprojects. 142 143.. toctree:: 144 :maxdepth: 2 145 146 filesystems/ext4/index 147 148Translations 149------------ 150 151.. toctree:: 152 :maxdepth: 2 153 154 translations/index 155 156Indices and tables 157================== 158 159* :ref:`genindex` 160