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    kbuild/index
  39
  40 Firmware-related documentation
  41 ------------------------------
  42 The following holds information on the kernel's expectations regarding the
  43 platform firmwares.
  44
  45 .. toctree::
  46    :maxdepth: 2
  47
  48    firmware-guide/index
  49
  50 Application-developer documentation
  51 -----------------------------------
  52
  53 The user-space API manual gathers together documents describing aspects of
  54 the kernel interface as seen by application developers.
  55
  56 .. toctree::
  57    :maxdepth: 2
  58
  59    userspace-api/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    fault-injection/index
  81    livepatch/index
  82
  83
  84 Kernel API documentation
  85 ------------------------
  86
  87 These books get into the details of how specific kernel subsystems work
  88 from the point of view of a kernel developer.  Much of the information here
  89 is taken directly from the kernel source, with supplemental material added
  90 as needed (or at least as we managed to add it — probably *not* all that is
  91 needed).
  92
  93 .. toctree::
  94    :maxdepth: 2
  95
  96    driver-api/index
  97    core-api/index
  98    locking/index
  99    accounting/index
 100    block/index
 101    cdrom/index
 102    ide/index
 103    fb/index
 104    fpga/index
 105    hid/index
 106    i2c/index
 107    iio/index
 108    isdn/index
 109    infiniband/index
 110    leds/index
 111    media/index
 112    netlabel/index
 113    networking/index
 114    pcmcia/index
 115    power/index
 116    target/index
 117    timers/index
 118    spi/index
 119    w1/index
 120    watchdog/index
 121    virt/index
 122    input/index
 123    hwmon/index
 124    gpu/index
 125    security/index
 126    sound/index
 127    crypto/index
 128    filesystems/index
 129    vm/index
 130    bpf/index
 131    usb/index
 132    PCI/index
 133    misc-devices/index
 134    mic/index
 135    scheduler/index
 136
 137 Architecture-agnostic documentation
 138 -----------------------------------
 139
 140 .. toctree::
 141    :maxdepth: 2
 142
 143    asm-annotations
 144
 145 Architecture-specific documentation
 146 -----------------------------------
 147
 148 These books provide programming details about architecture-specific
 149 implementation.
 150
 151 .. toctree::
 152    :maxdepth: 2
 153
 154    arm/index
 155    arm64/index
 156    ia64/index
 157    m68k/index
 158    mips/index
 159    nios2/nios2
 160    openrisc/index
 161    parisc/index
 162    powerpc/index
 163    riscv/index
 164    s390/index
 165    sh/index
 166    sparc/index
 167    x86/index
 168    xtensa/index
 169
 170 Filesystem Documentation
 171 ------------------------
 172
 173 The documentation in this section are provided by specific filesystem
 174 subprojects.
 175
 176 .. toctree::
 177    :maxdepth: 2
 178
 179    filesystems/ext4/index
 180
 181 Translations
 182 ------------
 183
 184 .. toctree::
 185    :maxdepth: 2
 186
 187    translations/index
 188
 189 Indices and tables
 190 ==================
 191
 192 * :ref:`genindex`