Gitiles
Code Review Sign In
review.shift-gmbh.com / SHIFTPHONES / mainline / linux / a8f808839abe3a10011e28b46af1848dfd8c4f21 / . / Documentation / core-api / index.rst
blob: 69171b1799f21464322ff150a41e3b39e4978b2b [file] [log] [blame]
Silvio Fricke24755a52016-10-28 10:14:10 +0200[diff] [blame]1======================
Jonathan Corbet93dc3a12016-11-18 17:06:13 -0700[diff] [blame]2Core API Documentation
Silvio Fricke24755a52016-10-28 10:14:10 +0200[diff] [blame]3======================
4
Jonathan Corbet93dc3a12016-11-18 17:06:13 -0700[diff] [blame]5This is the beginning of a manual for core kernel APIs. The conversion
6(and writing!) of documents for this manual is much appreciated!
7
8Core utilities
9==============
Silvio Fricke24755a52016-10-28 10:14:10 +0200[diff] [blame]10
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]11This section has general and "core core" documentation. The first is a
12massive grab-bag of kerneldoc info left over from the docbook days; it
13should really be broken up someday when somebody finds the energy to do
14it.
15
Silvio Fricke24755a52016-10-28 10:14:10 +0200[diff] [blame]16.. toctree::
17 :maxdepth: 1
18
Mauro Carvalho Chehabbaca8a02017-03-30 17:11:32 -0300[diff] [blame]19 kernel-api
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]20 workqueue
Ricardo Cañuelo90c165f2020-04-03 11:36:17 +0200[diff] [blame]21 printk-basics
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]22 printk-formats
23 symbol-namespaces
24
25Data structures and low-level utilities
26=======================================
27
28Library functionality that is used throughout the kernel.
29
30.. toctree::
31 :maxdepth: 1
32
Sameer Rahmani5fed00d2020-02-25 22:21:25 +0000[diff] [blame]33 kobject
Mauro Carvalho Chehab1ac00662020-05-01 17:37:52 +0200[diff] [blame]34 kref
Silvio Frickec3cbf1a2016-11-28 18:30:53 +0100[diff] [blame]35 assoc_array
Matthew Wilcox992a8e62017-11-23 22:57:20 -0500[diff] [blame]36 xarray
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]37 idr
Mauro Carvalho Chehabd8a121e2018-05-07 06:35:43 -0300[diff] [blame]38 circular-buffers
Matthew Wilcox (Oracle)14bbe3e2020-04-01 10:33:43 -0700[diff] [blame]39 rbtree
Kent Overstreetba20ba22019-03-11 23:31:14 -0700[diff] [blame]40 generic-radix-tree
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]41 packing
Mauro Carvalho Chehabc9b54d62020-06-23 15:31:38 +0200[diff] [blame]42 bus-virt-phys-mapping
43 this_cpu_ops
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]44 timekeeping
45 errseq
46
47Concurrency primitives
48======================
49
50How Linux keeps everything from happening at the same time. See
51:doc:`/locking/index` for more related documentation.
52
53.. toctree::
54 :maxdepth: 1
55
56 atomic_ops
57 refcount-vs-atomic
Mauro Carvalho Chehabe00b0ab2020-05-01 17:37:51 +0200[diff] [blame]58 irq/index
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]59 local_ops
60 padata
61 ../RCU/index
62
63Low-level hardware management
64=============================
65
66Cache management, managing CPU hotplug, etc.
67
68.. toctree::
69 :maxdepth: 1
70
71 cachetlb
72 cpu_hotplug
73 memory-hotplug
74 genericirq
75 protection-keys
76
77Memory management
78=================
79
80How to allocate and use memory in the kernel. Note that there is a lot
81more memory-management documentation in :doc:`/vm/index`.
82
83.. toctree::
84 :maxdepth: 1
85
Mike Rapoport52272c92018-09-14 12:27:58 +0300[diff] [blame]86 memory-allocation
Mauro Carvalho Chehabc9b54d62020-06-23 15:31:38 +0200[diff] [blame]87 unaligned-memory-access
Mauro Carvalho Chehab728c1472020-05-01 17:37:45 +0200[diff] [blame]88 dma-api
89 dma-api-howto
90 dma-attributes
91 dma-isa-lpc
Mike Rapoport41f35b32018-08-23 17:01:12 -0700[diff] [blame]92 mm-api
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]93 genalloc
John Hubbardeddb1c22020-01-30 22:12:54 -0800[diff] [blame]94 pin_user_pages
Mike Rapoportae9d8842018-06-30 17:55:06 +0300[diff] [blame]95 boot-time-mm
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]96 gfp_mask-from-fs-io
Silvio Frickee7f08ff2016-10-28 10:14:11 +0200[diff] [blame]97
Jonathan Corbet93dc3a12016-11-18 17:06:13 -0700[diff] [blame]98Interfaces for kernel debugging
99===============================
100
101.. toctree::
102 :maxdepth: 1
103
Jonathan Corbetd6ba7a92016-11-18 17:21:32 -0700[diff] [blame]104 debug-objects
105 tracepoint
Mauro Carvalho Chehaba74e2a22020-05-01 17:37:50 +0200[diff] [blame]106 debugging-via-ohci1394
Jonathan Corbet93dc3a12016-11-18 17:06:13 -0700[diff] [blame]107
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]108Everything else
109===============
110
111Documents that don't fit elsewhere or which have yet to be categorized.
112
113.. toctree::
114 :maxdepth: 1
115
116 librs
Jonathan Corbet5e720172020-03-02 15:17:17 -0700[diff] [blame]117
Mauro Carvalho Chehab9c970ab2019-07-26 09:51:29 -0300[diff] [blame]118.. only:: subproject and html
Silvio Fricke24755a52016-10-28 10:14:10 +0200[diff] [blame]119
120 Indices
121 =======
122
123 * :ref:`genindex`