Commit 231b6b0c authored Aug 27, 2024 by Ye Bin

Documentation: tracing: add new type '%pd' and '%pD' for kprobe

mainline inclusion
from mainline-v6.10-rc1
commit 5e37460f5f9266bcd037137f1bd9eb24b9940faf
category: feature
bugzilla: https://gitee.com/openeuler/kernel/issues/IAMXDU

Reference: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=5e37460f5f9266bcd037137f1bd9eb24b9940faf

--------------------------------

Similar to printk() '%pd' is for fetch dentry's name from struct dentry's
pointer, and '%pD' is for fetch file's name from struct file's pointer.

Link: https://lore.kernel.org/all/20240322064308.284457-4-yebin10@huawei.com/



Signed-off-by: Ye Bin <yebin10@huawei.com>
Acked-by: Masami Hiramatsu (Google) <mhiramat@kernel.org>
Signed-off-by: Masami Hiramatsu (Google) <mhiramat@kernel.org>
Conflicts:
	Documentation/trace/kprobetrace.rst
[Fix context diff]
Signed-off-by: Ye Bin <yebin10@huawei.com>

parent d9b36549

Documentation/trace/kprobetrace.rst

+5 −1

Original line number	Diff line number	Diff line
		@@ -58,7 +58,8 @@ Synopsis of kprobe_events
		NAME=FETCHARG : Set NAME as the argument name of FETCHARG.
		FETCHARG:TYPE : Set TYPE as the type of FETCHARG. Currently, basic types
		(u8/u16/u32/u64/s8/s16/s32/s64), hexadecimal types
		(x8/x16/x32/x64), "char", "string", "ustring", "symbol", "symstr"
		(x8/x16/x32/x64), VFS layer common type(%pd/%pD), "char",
		"string", "ustring", "symbol", "symstr"
		and bitfield are supported.

		(\*1) only for the probe on function entry (offs == 0).
		@@ -109,6 +110,9 @@ With 'symstr' type, you can filter the event with wildcard pattern of the
		symbols, and you don't need to solve symbol name by yourself.
		For $comm, the default type is "string"; any other type is invalid.

		VFS layer common type(%pd/%pD) is a special type, which fetches dentry's or
		file's name from struct dentry's address or struct file's address.

		.. _user_mem_access:

		User Memory Access