xref: /linux/Documentation/core-api/index.rst (revision 4f05e82003d1c20da29fa593420b8d92e2c8d4e6)
1======================
2Core API Documentation
3======================
4
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==============
10
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
16.. toctree::
17   :maxdepth: 1
18
19   kernel-api
20   workqueue
21   watch_queue
22   printk-basics
23   printk-formats
24   printk-index
25   symbol-namespaces
26   asm-annotations
27
28Data structures and low-level utilities
29=======================================
30
31Library functionality that is used throughout the kernel.
32
33.. toctree::
34   :maxdepth: 1
35
36   kobject
37   kref
38   assoc_array
39   xarray
40   maple_tree
41   idr
42   circular-buffers
43   rbtree
44   generic-radix-tree
45   packing
46   this_cpu_ops
47   timekeeping
48   errseq
49   wrappers/atomic_t
50   wrappers/atomic_bitops
51
52Low level entry and exit
53========================
54
55.. toctree::
56   :maxdepth: 1
57
58   entry
59
60Concurrency primitives
61======================
62
63How Linux keeps everything from happening at the same time.  See
64Documentation/locking/index.rst for more related documentation.
65
66.. toctree::
67   :maxdepth: 1
68
69   refcount-vs-atomic
70   irq/index
71   local_ops
72   padata
73   ../RCU/index
74   wrappers/memory-barriers.rst
75
76Low-level hardware management
77=============================
78
79Cache management, managing CPU hotplug, etc.
80
81.. toctree::
82   :maxdepth: 1
83
84   cachetlb
85   cpu_hotplug
86   memory-hotplug
87   genericirq
88   protection-keys
89
90Memory management
91=================
92
93How to allocate and use memory in the kernel.  Note that there is a lot
94more memory-management documentation in Documentation/mm/index.rst.
95
96.. toctree::
97   :maxdepth: 1
98
99   memory-allocation
100   unaligned-memory-access
101   dma-api
102   dma-api-howto
103   dma-attributes
104   dma-isa-lpc
105   swiotlb
106   mm-api
107   genalloc
108   pin_user_pages
109   boot-time-mm
110   gfp_mask-from-fs-io
111
112Interfaces for kernel debugging
113===============================
114
115.. toctree::
116   :maxdepth: 1
117
118   debug-objects
119   tracepoint
120   debugging-via-ohci1394
121
122Everything else
123===============
124
125Documents that don't fit elsewhere or which have yet to be categorized.
126
127.. toctree::
128   :maxdepth: 1
129
130   librs
131   netlink
132
133.. only:: subproject and html
134
135   Indices
136   =======
137
138   * :ref:`genindex`
139