diff mbox series

[RFC,dwarves,6/6] pahole: document --btf_gen_func_addr

Message ID 20230517161648.17582-7-alan.maguire@oracle.com (mailing list archive)
State RFC
Headers show
Series Encoding function addresses using DECL_TAGs | expand

Checks

Context Check Description
netdev/tree_selection success Not a local patch

Commit Message

Alan Maguire May 17, 2023, 4:16 p.m. UTC
Document how we can generate declaration tags specifying
function address.

Signed-off-by: Alan Maguire <alan.maguire@oracle.com>
---
 man-pages/pahole.1 | 8 ++++++++
 1 file changed, 8 insertions(+)
diff mbox series

Patch

diff --git a/man-pages/pahole.1 b/man-pages/pahole.1
index c1b48de..aa0a3a4 100644
--- a/man-pages/pahole.1
+++ b/man-pages/pahole.1
@@ -265,6 +265,14 @@  to "/sys/kernel/btf/vmlinux".
 Allow producing BTF_KIND_FLOAT entries in systems where the vmlinux DWARF
 information has float types.
 
+.TP
+.B \-\-btf_gen_func_addr
+Generate DECL_TAG references that specify "address=0x<address of function>"
+tags for each instance of a function.
+This allows us to map from a function description in BTF to instances of its use
+in code;
+this is helpful if a function has multiple static definitions in different CUs that are incompatible.
+
 .TP
 .B \-\-btf_gen_optimized
 Generate BTF for functions with optimization-related suffixes (.isra, .constprop).