linux/include
Dave Marchevsky ca34ce29fc bpf: Improve docstring for BPF_F_USER_BUILD_ID flag
Most tools which use bpf_get_stack or bpf_get_stackid symbolicate the
stack - meaning the stack of addresses in the target process' address
space is transformed into meaningful symbol names. The
BPF_F_USER_BUILD_ID flag eases this process by finding the build_id of
the file-backed vma which the address falls in and translating the
address to an offset within the backing file.

To be more specific, the offset is a "file offset" from the beginning of
the backing file. The symbols in ET_DYN ELF objects have a st_value
which is also described as an "offset" - but an offset in the process
address space, relative to the base address of the object.

It's necessary to translate between the "file offset" and "virtual
address offset" during symbolication before they can be directly
compared. Failure to do so can lead to confusing bugs, so this patch
clarifies language in the documentation in an attempt to keep this from
happening.

Signed-off-by: Dave Marchevsky <davemarchevsky@fb.com>
Signed-off-by: Andrii Nakryiko <andrii@kernel.org>
Link: https://lore.kernel.org/bpf/20220808164723.3107500-1-davemarchevsky@fb.com
2022-08-08 15:15:05 -07:00
..
acpi Merge branches 'acpi-processor', 'acpi-apei' and 'acpi-ec' 2022-07-29 20:08:25 +02:00
asm-generic Random number generator updates for Linux 6.0-rc1. 2022-08-02 17:31:35 -07:00
clocksource - Add the missing DT bindings for the MTU nomadik timer (Linus 2022-07-28 12:33:34 +02:00
crypto crypto: aria - Implement ARIA symmetric cipher algorithm 2022-07-15 16:38:19 +08:00
drm drm/scheduler: Don't kill jobs in interrupt context 2022-07-15 10:09:15 -04:00
dt-bindings ARM: new SoC support for 6.0 2022-08-02 08:29:18 -07:00
keys certs: Move load_certificate_list() to be with the asymmetric keys code 2022-06-21 16:05:06 +01:00
kunit kunit: flatten kunit_suite*** to kunit_suite** in .kunit_test_suites 2022-07-11 17:13:15 -06:00
kvm
linux Networking changes for 6.0. 2022-08-03 16:29:08 -07:00
math-emu
media
memory
misc
net Networking changes for 6.0. 2022-08-03 16:29:08 -07:00
pcmcia
ras
rdma
scsi scsi/core: Use the new blk_opf_t type 2022-07-14 12:14:32 -06:00
soc net: dsa: felix: keep reference on entire tc-taprio config 2022-06-30 21:18:15 -07:00
sound ASoC: Remove unused hw_write_t type 2022-06-24 16:21:41 +01:00
target
trace Networking changes for 6.0. 2022-08-03 16:29:08 -07:00
uapi bpf: Improve docstring for BPF_F_USER_BUILD_ID flag 2022-08-08 15:15:05 -07:00
ufs
vdso
video video: of_display_timing.h: include errno.h 2022-07-06 17:16:20 +02:00
xen