Documentation/index.rst

   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
   9 The Linux Kernel documentation
  10 ==============================
  11
  12 This is the top level of the kernel's documentation tree.  Kernel
  13 documentation, like the kernel itself, is very much a work in progress;
  14 that is especially true as we work to integrate our many scattered
  15 documents into a coherent whole.  Please note that improvements to the
  16 documentation are welcome; join the linux-doc list at vger.kernel.org if
  17 you want to help out.
  18
  19 Licensing documentation
  20 -----------------------
  21
  22 The following describes the license of the Linux kernel source code
  23 (GPLv2), how to properly mark the license of individual files in the source
  24 tree, as well as links to the full license text.
  25
  26 * :ref:`kernel_licensing`
  27
  28 User-oriented documentation
  29 ---------------------------
  30
  31 The following manuals are written for *users* of the kernel — those who are
  32 trying to get it to work optimally on a given system.
  33
  34 .. toctree::
  35    :maxdepth: 2
  36
  37    admin-guide/index
  38
  39 Firmware-related documentation
  40 ------------------------------
  41 The following holds information on the kernel's expectations regarding the
  42 platform firmwares.
  43
  44 .. toctree::
  45    :maxdepth: 2
  46
  47    firmware-guide/index
  48
  49 Application-developer documentation
  50 -----------------------------------
  51
  52 The user-space API manual gathers together documents describing aspects of
  53 the kernel interface as seen by application developers.
  54
  55 .. toctree::
  56    :maxdepth: 2
  57
  58    userspace-api/index
  59    ioctl/index
  60
  61
  62 Introduction to kernel development
  63 ----------------------------------
  64
  65 These manuals contain overall information about how to develop the kernel.
  66 The kernel community is quite large, with thousands of developers
  67 contributing over the course of a year.  As with any large community,
  68 knowing how things are done will make the process of getting your changes
  69 merged 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
  81 Kernel API documentation
  82 ------------------------
  83
  84 These books get into the details of how specific kernel subsystems work
  85 from the point of view of a kernel developer.  Much of the information here
  86 is taken directly from the kernel source, with supplemental material added
  87 as needed (or at least as we managed to add it — probably *not* all that is
  88 needed).
  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    phy/samsung-usb2
 115    scheduler/index
 116
 117 Architecture-specific documentation
 118 -----------------------------------
 119
 120 These books provide programming details about architecture-specific
 121 implementation.
 122
 123 .. toctree::
 124    :maxdepth: 2
 125
 126    sh/index
 127    arm/index
 128    arm64/index
 129    ia64/index
 130    m68k/index
 131    riscv/index
 132    s390/index
 133    sh/index
 134    sparc/index
 135    x86/index
 136    xtensa/index
 137
 138 Filesystem Documentation
 139 ------------------------
 140
 141 The documentation in this section are provided by specific filesystem
 142 subprojects.
 143
 144 .. toctree::
 145    :maxdepth: 2
 146
 147    filesystems/ext4/index
 148
 149 Translations
 150 ------------
 151
 152 .. toctree::
 153    :maxdepth: 2
 154
 155    translations/index
 156
 157 Indices and tables
 158 ==================
 159
 160 * :ref:`genindex`