linux/Documentation
Mark Rutland f89f20acff Documentation: livepatch: document reliable stacktrace
Add documentation for reliable stacktrace. This is intended to describe
the semantics and to be an aid for implementing architecture support for
HAVE_RELIABLE_STACKTRACE.

Unwinding is a subtle area, and architectures vary greatly in both
implementation and the set of concerns that affect them, so I've tried
to avoid making this too specific to any given architecture. I've used
examples from both x86_64 and arm64 to explain corner cases in more
detail, but I've tried to keep the descriptions sufficient for those who
are unfamiliar with the particular architecture.

This document aims to give rationale for all the recommendations and
requirements, since that makes it easier to spot nearby issues, or when
a check happens to catch a few things at once.

Signed-off-by: Mark Rutland <mark.rutland@arm.com>
[Updates following review -- broonie]
Acked-by: Josh Poimboeuf <jpoimboe@redhat.com>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>
2021-01-26 11:50:00 +01:00
..
ABI dmaengine updates for v5.10-rc1 2020-10-15 14:33:52 -07:00
accounting
admin-guide dma-mapping updates for 5.10 2020-10-15 14:43:29 -07:00
arm As hoped, things calmed down for docs this cycle; fewer changes and almost 2020-10-12 16:21:29 -07:00
arm64 As hoped, things calmed down for docs this cycle; fewer changes and almost 2020-10-12 16:21:29 -07:00
block
bpf docs/bpf: Remove source code links 2020-09-14 18:46:54 -07:00
cdrom A handful of obvious fixes that wandered in during the merge window. 2020-08-13 13:57:45 -07:00
core-api dma-mapping updates for 5.10 2020-10-15 14:43:29 -07:00
cpu-freq
crypto crypto: af_alg - add extra parameters for DRBG interface 2020-09-25 17:48:52 +10:00
dev-tools KASAN: Testing Documentation 2020-10-13 18:38:32 -07:00
devicetree dmaengine updates for v5.10-rc1 2020-10-15 14:33:52 -07:00
doc-guide docs: Document cross-referencing between documentation pages 2020-09-16 11:09:51 -06:00
driver-api drm next for 5.10-rc1 2020-10-15 10:46:16 -07:00
fault-injection nvme: rename and document nvme_end_request 2020-08-21 17:14:28 -06:00
fb drm next for 5.10-rc1 2020-10-15 10:46:16 -07:00
features powerpc/mm: Remove DEBUG_VM_PGTABLE support on powerpc 2020-09-02 22:14:26 +10:00
filesystems Driver Core patches for 5.10-rc1 2020-10-14 16:09:32 -07:00
firmware_class
firmware-guide docs: add some new files to their respective index.rst files 2020-09-10 10:48:20 -06:00
fpga
gpu drm/amdgpu: Add initial kernel documentation for the amd_ip_block_type structure. v3 2020-09-22 17:37:38 -04:00
hid
hwmon - New Drivers 2020-10-14 15:56:58 -07:00
i2c Merge branch 'i2c/for-5.9' of git://git.kernel.org/pub/scm/linux/kernel/git/wsa/linux 2020-08-13 18:41:00 -07:00
ia64 docs/ia64: Drop obsolete Xen documentation 2020-08-31 16:16:03 -06:00
ide
iio Documentation: iio: fix a typo 2020-09-09 11:41:20 -06:00
infiniband
input
isdn
kbuild kbuild: doc: describe proper script invocation 2020-10-13 18:38:26 -07:00
kernel-hacking
leds leds: we don't want people to use LED subsystem for vibrations 2020-08-17 18:04:15 +02:00
litmus-tests
livepatch Documentation: livepatch: document reliable stacktrace 2021-01-26 11:50:00 +01:00
locking seqlock: Introduce seqcount_latch_t 2020-09-10 11:19:28 +02:00
m68k
maintainer Documentation/maintainer: rehome sign-off process 2020-09-03 15:39:24 -06:00
mhi
mips dt: Remove booting-without-of.rst 2020-10-13 13:33:16 -05:00
misc-devices
netlabel
networking SPDX patches for 5.10-rc1 2020-10-14 16:19:42 -07:00
nios2
nvdimm
openrisc
parisc
PCI Documentation: better locations for sysfs-pci, sysfs-tagging 2020-10-09 09:33:23 -06:00
pcmcia
power
powerpc Devicetree updates for v5.10: 2020-10-14 15:31:58 -07:00
process docs: programming-languages: refresh blurb on clang support 2020-10-05 09:44:11 -06:00
RCU docs: Fix function name trailing double-()s 2020-08-24 17:19:07 -06:00
riscv
s390
scheduler docs: scheduler: fix the directory name on two files 2020-09-10 10:45:45 -06:00
scsi SPDX patches for 5.10-rc1 2020-10-14 16:19:42 -07:00
security Documentation: remove current_security() reference 2020-09-09 11:33:59 -06:00
sh dt: Remove booting-without-of.rst 2020-10-13 13:33:16 -05:00
sound ALSA: hda: use consistent HDAudio spelling in comments/docs 2020-09-02 19:31:32 +02:00
sparc
sphinx docs: Add automatic cross-reference for documentation pages 2020-09-16 11:09:51 -06:00
sphinx-static
spi
staging remoteproc updates for v5.9 2020-08-11 11:17:45 -07:00
target
timers
trace kernel-clone-v5.9 2020-10-14 14:32:52 -07:00
translations Documentation: Chinese translation of Documentation/arm64/amu.rst 2020-09-28 15:24:24 -06:00
usb
userspace-api drm next for 5.10-rc1 2020-10-15 10:46:16 -07:00
virt Char/Misc driver patches for 5.10-rc1 2020-10-15 10:01:51 -07:00
vm docs/vm: fix 'mm_count' vs 'mm_users' counter confusion 2020-10-13 18:38:32 -07:00
w1 docs: w1: w1_therm: Fix broken xref, mistakes, clarify text 2020-10-08 09:47:15 +02:00
watchdog
x86 Devicetree updates for v5.10: 2020-10-14 15:31:58 -07:00
xtensa
.gitignore
asm-annotations.rst
atomic_bitops.txt
atomic_t.txt
Changes
CodingStyle
conf.py Make the docs build "work" with Sphinx 3.x 2020-09-04 10:13:45 -06:00
COPYING-logo
docutils.conf
dontdiff
index.rst
Kconfig
logo.gif
Makefile
memory-barriers.txt docs/memory-barriers.txt: Fix references for DMA*.txt files 2020-08-31 16:14:44 -06:00
SubmittingPatches
watch_queue.rst docs: watch_queue: fix some warnings 2020-09-10 10:48:56 -06:00