mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-02-23 13:02:21 -05:00
ec03de73b1
Pull locking updates from Ingo Molnar:
"lockdep:
- Fix potential deadlock between lockdep and RCU (Zhiguo Niu)
- Use str_plural() to address Coccinelle warning (Thorsten Blum)
- Add debuggability enhancement (Luis Claudio R. Goncalves)
static keys & calls:
- Fix static_key_slow_dec() yet again (Peter Zijlstra)
- Handle module init failure correctly in static_call_del_module()
(Thomas Gleixner)
- Replace pointless WARN_ON() in static_call_module_notify() (Thomas
Gleixner)
<linux/cleanup.h>:
- Add usage and style documentation (Dan Williams)
rwsems:
- Move is_rwsem_reader_owned() and rwsem_owner() under
CONFIG_DEBUG_RWSEMS (Waiman Long)
atomic ops, x86:
- Redeclare x86_32 arch_atomic64_{add,sub}() as void (Uros Bizjak)
- Introduce the read64_nonatomic macro to x86_32 with cx8 (Uros
Bizjak)"
Signed-off-by: Ingo Molnar <mingo@kernel.org>
* tag 'locking-urgent-2024-09-29' of git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip:
locking/rwsem: Move is_rwsem_reader_owned() and rwsem_owner() under CONFIG_DEBUG_RWSEMS
jump_label: Fix static_key_slow_dec() yet again
static_call: Replace pointless WARN_ON() in static_call_module_notify()
static_call: Handle module init failure correctly in static_call_del_module()
locking/lockdep: Simplify character output in seq_line()
lockdep: fix deadlock issue between lockdep and rcu
lockdep: Use str_plural() to fix Coccinelle warning
cleanup: Add usage and style documentation
lockdep: suggest the fix for "lockdep bfs error:-1" on print_bfs_bug
locking/atomic/x86: Redeclare x86_32 arch_atomic64_{add,sub}() as void
locking/atomic/x86: Introduce the read64_nonatomic macro to x86_32 with cx8
142 lines
2.4 KiB
ReStructuredText
142 lines
2.4 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
|
|
watch_queue
|
|
printk-basics
|
|
printk-formats
|
|
printk-index
|
|
symbol-namespaces
|
|
asm-annotations
|
|
|
|
Data structures and low-level utilities
|
|
=======================================
|
|
|
|
Library functionality that is used throughout the kernel.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
kobject
|
|
kref
|
|
cleanup
|
|
assoc_array
|
|
xarray
|
|
maple_tree
|
|
idr
|
|
circular-buffers
|
|
rbtree
|
|
generic-radix-tree
|
|
packing
|
|
this_cpu_ops
|
|
timekeeping
|
|
errseq
|
|
wrappers/atomic_t
|
|
wrappers/atomic_bitops
|
|
floating-point
|
|
union_find
|
|
|
|
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
|
|
wrappers/memory-barriers.rst
|
|
|
|
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/mm/index.rst.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
memory-allocation
|
|
unaligned-memory-access
|
|
dma-api
|
|
dma-api-howto
|
|
dma-attributes
|
|
dma-isa-lpc
|
|
swiotlb
|
|
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
|
|
netlink
|
|
|
|
.. only:: subproject and html
|
|
|
|
Indices
|
|
=======
|
|
|
|
* :ref:`genindex`
|