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