[PATCH bpf-next v3 4/9] kallsyms: Add KALLSYMS_QUERY_BY_ADDR ioctl to /proc/kallsyms

From: Samuel Wu

Date: Fri Nov 13 2026 - 17:14:58 EST


Symbolizers such as Perfetto read all of /proc/kallsyms and keep a
sorted copy in memory to resolve addresses.

Add the KALLSYMS_QUERY_BY_ADDR ioctl. It returns the symbol that covers
an address, from the same sources and in the same order as %pS. BPF JIT
symbols are hidden when /proc/kallsyms hides them. query_flags must be
0; it is reserved for other modes.

The command uses 'f' 0x31; register 0x31 in ioctl-number.rst.

Suggested-by: Andrii Nakryiko <andrii@xxxxxxxxxx>
Signed-off-by: Samuel Wu <wusamuel@xxxxxxxxxx>
---
.../userspace-api/ioctl/ioctl-number.rst | 2 +-
include/uapi/linux/fs.h | 13 ++++
kernel/kallsyms.c | 60 +++++++++++++++++++
3 files changed, 74 insertions(+), 1 deletion(-)

diff --git a/Documentation/userspace-api/ioctl/ioctl-number.rst b/Documentation/userspace-api/ioctl/ioctl-number.rst
index f5dbb597257a..d9b66e7a29b7 100644
--- a/Documentation/userspace-api/ioctl/ioctl-number.rst
+++ b/Documentation/userspace-api/ioctl/ioctl-number.rst
@@ -250,7 +250,7 @@ Code Seq# Include File Comments
'f' 00-0F fs/ocfs2/ocfs2_fs.h conflict!
'f' 10-11 linux/fs.h conflict! procfs ioctls (PROCFS_IOCTL_MAGIC)
'f' 13-27 linux/fscrypt.h
-'f' 30 linux/fs.h procfs kallsyms ioctls (PROCFS_IOCTL_MAGIC)
+'f' 30-31 linux/fs.h procfs kallsyms ioctls (PROCFS_IOCTL_MAGIC)
'f' 81-8F linux/fsverity.h
'g' 00-0F linux/usb/gadgetfs.h
'g' 20-2F linux/usb/g_printer.h
diff --git a/include/uapi/linux/fs.h b/include/uapi/linux/fs.h
index 987569dcdbea..c1a63c8560e2 100644
--- a/include/uapi/linux/fs.h
+++ b/include/uapi/linux/fs.h
@@ -676,6 +676,7 @@ struct procmap_query {

/* /proc/kallsyms ioctls. -EPERM if the opener cannot see kernel addresses. */
#define KALLSYMS_QUERY_BY_NAME _IOC(_IOC_READ | _IOC_WRITE, PROCFS_IOCTL_MAGIC, 48, 0)
+#define KALLSYMS_QUERY_BY_ADDR _IOC(_IOC_READ | _IOC_WRITE, PROCFS_IOCTL_MAGIC, 49, 0)

enum kallsyms_query_flags {
/* Match query_name as a prefix. */
@@ -717,6 +718,18 @@ struct kallsyms_query_by_name {
__u64 sym_struct_size; /* in - sizeof(struct kallsyms_query_sym) */
};

+/*
+ * Find the /proc/kallsyms entry that covers query_addr, or return -ENOENT.
+ * ftrace trampolines and kprobe pages are not resolved yet.
+ */
+struct kallsyms_query_by_addr {
+ __u64 size; /* in - sizeof(struct kallsyms_query_by_addr) */
+ __u64 query_flags; /* in - must be 0 */
+ __u64 query_addr; /* in - kernel address */
+ __u64 sym; /* in - user ptr to struct kallsyms_query_sym */
+ __u64 sym_struct_size; /* in - sizeof(struct kallsyms_query_sym) */
+};
+
/*
* Shutdown the filesystem.
*/
diff --git a/kernel/kallsyms.c b/kernel/kallsyms.c
index 29a9da04d8a3..6d7032cd3fd6 100644
--- a/kernel/kallsyms.c
+++ b/kernel/kallsyms.c
@@ -1223,6 +1223,64 @@ static int do_kallsyms_query_by_name(struct kallsyms_query_by_name __user *uarg)
&bufs->m);
}

+/*
+ * Look up symbol from addr. Copy the module name under RCU, and hide BPF JIT
+ * symbols as /proc/kallsyms hides them.
+ */
+static int kallsyms_find_addr(unsigned long addr, struct kallsyms_sym_match *m)
+{
+ unsigned long offset;
+ char *modname;
+
+ guard(rcu)();
+ if (!kallsyms_lookup_buildid(addr, &m->size, &offset, &modname, NULL,
+ m->name))
+ return -ENOENT;
+
+ /* Outside vmlinux, only BPF JIT symbols have no module name. */
+ if (!modname && !is_ksym_addr(addr)) {
+ if (!bpf_jit_kallsyms_enabled())
+ return -ENOENT;
+ modname = "bpf";
+ }
+
+ m->addr = addr - offset;
+ strscpy(m->modname, modname ?: "", MODULE_NAME_LEN);
+ return 0;
+}
+
+static int do_kallsyms_query_by_addr(struct kallsyms_query_by_addr __user *uarg)
+{
+ struct kallsyms_query_by_addr karg;
+ struct kallsyms_query_sym ksym;
+ struct kallsyms_sym_match m;
+ int err;
+
+ err = kallsyms_copy_query_from_user(&karg, sizeof(karg),
+ offsetofend(struct kallsyms_query_by_addr,
+ sym_struct_size),
+ uarg);
+ if (err)
+ return err;
+
+ if (karg.query_flags)
+ return -EINVAL;
+
+ err = kallsyms_copy_sym_from_user(&ksym, karg.sym, karg.sym_struct_size);
+ if (err)
+ return err;
+
+ if (karg.query_addr > ULONG_MAX)
+ return -ENOENT;
+
+ err = kallsyms_find_addr(karg.query_addr, &m);
+ if (err)
+ return err;
+
+ return kallsyms_copy_sym_to_user(karg.sym, karg.sym_struct_size, &ksym,
+ &m);
+}
+
static long kallsyms_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
{
struct seq_file *m = file->private_data;
@@ -1232,6 +1290,8 @@ static long kallsyms_ioctl(struct file *file, unsigned int cmd, unsigned long ar
switch (cmd) {
case KALLSYMS_QUERY_BY_NAME:
return iter->show_value ? do_kallsyms_query_by_name(uarg) : -EPERM;
+ case KALLSYMS_QUERY_BY_ADDR:
+ return iter->show_value ? do_kallsyms_query_by_addr(uarg) : -EPERM;
default:
return -ENOIOCTLCMD;
}
--
2.56.0.679.gc527c65306-goog