138 lines
2.4 KiB
ReStructuredText
Raw Normal View History

2026-01-21 18:59:54 +08:00
======================
Core API Documentation
======================
This is the beginning of a manual for core kernel APIs. The conversion
(and writing!) of documents for this manual is much appreciated!
Core utilities
==============
This section has general and "core core" documentation. The first is a
massive grab-bag of kerneldoc info left over from the docbook days; it
should really be broken up someday when somebody finds the energy to do
it.
.. toctree::
:maxdepth: 1
kernel-api
workqueue
2026-01-29 22:25:33 +08:00
watch_queue
2026-01-21 18:59:54 +08:00
printk-basics
printk-formats
2026-01-29 22:25:33 +08:00
printk-index
2026-01-21 18:59:54 +08:00
symbol-namespaces
2026-01-29 22:25:33 +08:00
asm-annotations
2026-01-21 18:59:54 +08:00
Data structures and low-level utilities
=======================================
Library functionality that is used throughout the kernel.
.. toctree::
:maxdepth: 1
kobject
kref
assoc_array
xarray
2026-01-29 22:25:33 +08:00
maple_tree
2026-01-21 18:59:54 +08:00
idr
circular-buffers
rbtree
generic-radix-tree
packing
this_cpu_ops
timekeeping
errseq
2026-01-29 22:25:33 +08:00
wrappers/atomic_t
wrappers/atomic_bitops
Low level entry and exit
========================
.. toctree::
:maxdepth: 1
entry
2026-01-21 18:59:54 +08:00
Concurrency primitives
======================
How Linux keeps everything from happening at the same time. See
2026-01-29 22:25:33 +08:00
Documentation/locking/index.rst for more related documentation.
2026-01-21 18:59:54 +08:00
.. toctree::
:maxdepth: 1
refcount-vs-atomic
irq/index
local_ops
padata
../RCU/index
2026-01-29 22:25:33 +08:00
wrappers/memory-barriers.rst
2026-01-21 18:59:54 +08:00
Low-level hardware management
=============================
Cache management, managing CPU hotplug, etc.
.. toctree::
:maxdepth: 1
cachetlb
cpu_hotplug
memory-hotplug
genericirq
protection-keys
Memory management
=================
How to allocate and use memory in the kernel. Note that there is a lot
2026-01-29 22:25:33 +08:00
more memory-management documentation in Documentation/mm/index.rst.
2026-01-21 18:59:54 +08:00
.. toctree::
:maxdepth: 1
memory-allocation
unaligned-memory-access
dma-api
dma-api-howto
dma-attributes
dma-isa-lpc
mm-api
genalloc
pin_user_pages
boot-time-mm
gfp_mask-from-fs-io
Interfaces for kernel debugging
===============================
.. toctree::
:maxdepth: 1
debug-objects
tracepoint
debugging-via-ohci1394
Everything else
===============
Documents that don't fit elsewhere or which have yet to be categorized.
.. toctree::
:maxdepth: 1
librs
2026-01-29 22:25:33 +08:00
netlink
2026-01-21 18:59:54 +08:00
.. only:: subproject and html
Indices
=======
* :ref:`genindex`