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