2016-10-28 16:14:10 +08:00
|
|
|
======================
|
2016-11-19 08:06:13 +08:00
|
|
|
Core API Documentation
|
2016-10-28 16:14:10 +08:00
|
|
|
======================
|
|
|
|
|
|
2016-11-19 08:06:13 +08: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 16:14:10 +08:00
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
2017-03-31 04:11:32 +08:00
|
|
|
kernel-api
|
2016-11-29 01:30:53 +08:00
|
|
|
assoc_array
|
2016-11-29 01:30:55 +08:00
|
|
|
atomic_ops
|
2018-05-07 17:35:41 +08:00
|
|
|
cachetlb
|
2017-12-05 18:46:35 +08:00
|
|
|
refcount-vs-atomic
|
2016-12-23 00:19:34 +08:00
|
|
|
cpu_hotplug
|
2018-02-07 04:05:49 +08:00
|
|
|
idr
|
2016-11-29 01:30:54 +08:00
|
|
|
local_ops
|
2016-10-28 16:14:11 +08:00
|
|
|
workqueue
|
2017-03-31 04:11:30 +08:00
|
|
|
genericirq
|
2017-11-24 11:57:20 +08:00
|
|
|
xarray
|
2017-03-30 04:31:16 +08:00
|
|
|
flexible-arrays
|
2017-05-13 18:07:47 +08:00
|
|
|
librs
|
2017-08-25 04:27:05 +08:00
|
|
|
genalloc
|
2017-12-22 22:32:16 +08:00
|
|
|
errseq
|
2017-12-20 05:17:15 +08:00
|
|
|
printk-formats
|
2018-05-07 17:35:43 +08:00
|
|
|
circular-buffers
|
2018-09-14 17:27:58 +08:00
|
|
|
memory-allocation
|
2018-08-24 08:01:12 +08:00
|
|
|
mm-api
|
2018-05-29 16:26:44 +08: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 22:46:41 +08:00
|
|
|
timekeeping
|
2018-06-30 22:55:06 +08:00
|
|
|
boot-time-mm
|
2018-10-11 12:58:16 +08:00
|
|
|
memory-hotplug
|
2018-10-05 06:11:01 +08:00
|
|
|
|
2016-10-28 16:14:11 +08:00
|
|
|
|
2016-11-19 08:06:13 +08:00
|
|
|
Interfaces for kernel debugging
|
|
|
|
|
===============================
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
2016-11-19 08:21:32 +08:00
|
|
|
debug-objects
|
|
|
|
|
tracepoint
|
2016-11-19 08:06:13 +08:00
|
|
|
|
2016-10-28 16:14:10 +08:00
|
|
|
.. only:: subproject
|
|
|
|
|
|
|
|
|
|
Indices
|
|
|
|
|
=======
|
|
|
|
|
|
|
|
|
|
* :ref:`genindex`
|