2016-10-28 17:14:10 +09:00
|
|
|
======================
|
2016-11-19 09:06:13 +09:00
|
|
|
Core API Documentation
|
2016-10-28 17:14:10 +09:00
|
|
|
======================
|
|
|
|
|
2016-11-19 09:06:13 +09:00
|
|
|
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
|
|
|
|
==============
|
2016-10-28 17:14:10 +09:00
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
:maxdepth: 1
|
|
|
|
|
2017-03-31 05:11:32 +09:00
|
|
|
kernel-api
|
2016-11-29 02:30:53 +09:00
|
|
|
assoc_array
|
2016-11-29 02:30:55 +09:00
|
|
|
atomic_ops
|
2018-05-07 18:35:41 +09:00
|
|
|
cachetlb
|
2017-12-05 19:46:35 +09:00
|
|
|
refcount-vs-atomic
|
2016-12-23 01:19:34 +09:00
|
|
|
cpu_hotplug
|
2018-02-07 05:05:49 +09:00
|
|
|
idr
|
2016-11-29 02:30:54 +09:00
|
|
|
local_ops
|
2016-10-28 17:14:11 +09:00
|
|
|
workqueue
|
2017-03-31 05:11:30 +09:00
|
|
|
genericirq
|
2017-11-24 12:57:20 +09:00
|
|
|
xarray
|
2017-05-13 19:07:47 +09:00
|
|
|
librs
|
2017-08-25 05:27:05 +09:00
|
|
|
genalloc
|
2017-12-22 23:32:16 +09:00
|
|
|
errseq
|
2019-07-26 21:51:20 +09:00
|
|
|
packing
|
2017-12-20 06:17:15 +09:00
|
|
|
printk-formats
|
2018-05-07 18:35:43 +09:00
|
|
|
circular-buffers
|
2019-03-12 15:31:14 +09:00
|
|
|
generic-radix-tree
|
2018-09-14 18:27:58 +09:00
|
|
|
memory-allocation
|
2018-08-24 09:01:12 +09:00
|
|
|
mm-api
|
2018-05-29 17:26:44 +09:00
|
|
|
gfp_mask-from-fs-io
|
Documentation: document ktime_get_*() APIs
As Dave Chinner points out, we don't have a proper documentation for the
ktime_get() family of interfaces, making it rather unclear which of the
over 30 (!) interfaces one should actually use in a driver or elsewhere
in the kernel.
I wrote up an explanation from how I personally see the interfaces,
documenting what each of the functions do and hopefully making it a bit
clearer which should be used where.
This is the first time I tried writing .rst format documentation, so
in addition to any mistakes in the content, I probably also introduce
nonstandard formatting ;-)
I first tried to add an extra section to
Documentation/timers/timekeeping.txt, but this is currently not included
in the generated API, and it seems useful to have the API docs as part
of what gets generated in
https://www.kernel.org/doc/html/latest/core-api/index.html#core-utilities
instead, so I started a new file there.
I also considered adding the documentation inline in the
include/linux/timekeeping.h header, but couldn't figure out how to do
that in a way that would result both in helpful inline comments as
well as readable html output, so I settled for the latter, with
a small note pointing to it from the header.
Cc: Dave Chinner <david@fromorbit.com>
Cc: John Stultz <john.stultz@linaro.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Stephen Boyd <sboyd@kernel.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Signed-off-by: Arnd Bergmann <arnd@arndb.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2018-07-10 23:46:41 +09:00
|
|
|
timekeeping
|
2018-06-30 23:55:06 +09:00
|
|
|
boot-time-mm
|
2018-10-11 13:58:16 +09:00
|
|
|
memory-hotplug
|
2019-06-08 03:54:31 +09:00
|
|
|
protection-keys
|
2019-06-27 23:35:26 +09:00
|
|
|
../RCU/index
|
2019-04-20 07:01:18 +09:00
|
|
|
gcc-plugins
|
2019-10-08 12:10:09 +09:00
|
|
|
symbol-namespaces
|
2018-10-05 07:11:01 +09:00
|
|
|
|
2016-10-28 17:14:11 +09:00
|
|
|
|
2016-11-19 09:06:13 +09:00
|
|
|
Interfaces for kernel debugging
|
|
|
|
===============================
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
:maxdepth: 1
|
|
|
|
|
2016-11-19 09:21:32 +09:00
|
|
|
debug-objects
|
|
|
|
tracepoint
|
2016-11-19 09:06:13 +09:00
|
|
|
|
2019-07-26 21:51:29 +09:00
|
|
|
.. only:: subproject and html
|
2016-10-28 17:14:10 +09:00
|
|
|
|
|
|
|
Indices
|
|
|
|
=======
|
|
|
|
|
|
|
|
* :ref:`genindex`
|