mirror of
https://github.com/torvalds/linux.git
synced 2024-12-26 21:02:19 +00:00
bf026e2e31
The entry/exit handling for exceptions, interrupts, syscalls and KVM is not really documented except for some comments. Fill the gaps. Signed-off-by: Thomas Gleixner <tglx@linutronix.de Co-developed-by: Nicolas Saenz Julienne <nsaenzju@redhat.com> Signed-off-by: Nicolas Saenz Julienne <nsaenzju@redhat.com> Reviewed-by: Mark Rutland <mark.rutland@arm.com> Reviewed-by: Paul E. McKenney <paulmck@kernel.org> ---- Changes since v3: - s/nointr/noinstr/ Changes since v2: - No big content changes, just style corrections, so it should be pretty clean at this stage. In the light of this, I kept Mark's Reviewed-by. - Paul's style and paragraph re-writes - Randy's style comments - Add links to transition type sections Documentation/core-api/entry.rst | 261 +++++++++++++++++++++++++++++++ Documentation/core-api/index.rst | 8 + 2 files changed, 269 insertions(+) create mode 100644 Documentation/core-api/entry.rst Reviewed-by: Frederic Weisbecker <frederic@kernel.org> Link: https://lore.kernel.org/r/20220110105044.94423-1-nsaenzju@redhat.com Signed-off-by: Jonathan Corbet <corbet@lwn.net>
131 lines
2.2 KiB
ReStructuredText
131 lines
2.2 KiB
ReStructuredText
======================
|
|
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
|
|
printk-basics
|
|
printk-formats
|
|
symbol-namespaces
|
|
|
|
Data structures and low-level utilities
|
|
=======================================
|
|
|
|
Library functionality that is used throughout the kernel.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
kobject
|
|
kref
|
|
assoc_array
|
|
xarray
|
|
idr
|
|
circular-buffers
|
|
rbtree
|
|
generic-radix-tree
|
|
packing
|
|
bus-virt-phys-mapping
|
|
this_cpu_ops
|
|
timekeeping
|
|
errseq
|
|
|
|
Low level entry and exit
|
|
========================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
entry
|
|
|
|
Concurrency primitives
|
|
======================
|
|
|
|
How Linux keeps everything from happening at the same time. See
|
|
Documentation/locking/index.rst for more related documentation.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
refcount-vs-atomic
|
|
irq/index
|
|
local_ops
|
|
padata
|
|
../RCU/index
|
|
|
|
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
|
|
more memory-management documentation in Documentation/vm/index.rst.
|
|
|
|
.. 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
|
|
|
|
.. only:: subproject and html
|
|
|
|
Indices
|
|
=======
|
|
|
|
* :ref:`genindex`
|