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