bpf: add new helper get_file_path for mapping a file descriptor to a pathname
Subsystems (6)
PATCH v6 1/1 bpf: add new helper get_file_path for mapping a file descriptor to a pathname
When people want to identify which file system files are being opened, read, and written to, they can use this helper with file descriptor as input to achieve this goal. Other pseudo filesystems are also supported.
This requirement is mainly discussed here:
https://github.com/iovisor/bcc/issues/237
v5->v6: addressed Andrii's feedback
- avoid unnecessary goto end by having two explicit returns
v4->v5: addressed Andrii and Daniel's feedback
- rename bpf_fd2path to bpf_get_file_path to be consistent with other helper's names
- when fdget_raw fails, set ret to -EBADF instead of -EINVAL
- remove fdput from fdget_raw's error path
- use IS_ERR instead of IS_ERR_OR_NULL as d_path ether returns a pointer into the buffer or an error code if the path was too long
- modify the normal path's return value to return copied string lengh including NUL
- update this helper description's Return bits.
v3->v4: addressed Daniel's feedback
- fix missing fdput()
- move fd2path from kernel/bpf/trace.c to kernel/trace/bpf_trace.c
- move fd2path's test code to another patch
- add comment to explain why use fdget_raw instead of fdget
v2->v3: addressed Yonghong's feedback
- remove unnecessary LOCKDOWN_BPF_READ
- refactor error handling section for enhanced readability
- provide a test case in tools/testing/selftests/bpf
v1->v2: addressed Daniel's feedback
- fix backward compatibility
- add this helper description
- fix signed-off name
--- include/uapi/linux/bpf.h | 15 ++++++++++- kernel/trace/bpf_trace.c | 48 ++++++++++++++++++++++++++++++++++ tools/include/uapi/linux/bpf.h | 15 ++++++++++- 3 files changed, 76 insertions(+), 2 deletions(-)
include/uapi/linux/bpf.h +14 -1
@@ -2777,6 +2777,18 @@ union bpf_attr {* restricted to raw_tracepoint bpf programs. * Return * 0 on success, or a negative error in case of failure. +* +* int bpf_get_file_path(char *path, u32 size, int fd) +* Description +* Get **file** atrribute from the current task by *fd*, then call +* **d_path** to get it's absolute path and copy it as string into +* *path* of *size*. The **path** also support pseudo filesystems +* (whether or not it can be mounted). The *size* must be strictly +* positive. On success, the helper makes sure that the *path* is +* NUL-terminated. On failure, it is filled with zeroes. +* Return +* On success, returns the length of the copied string INCLUDING +* the trailing NUL, or a negative error in case of failure. */ #define __BPF_FUNC_MAPPER (FN ) \ FN(unspec), \
@@ -2890,7 +2902,8 @@ union bpf_attr {FN (sk_storage_delete), \FN (send_signal), \FN (tcp_gen_syncookie), \ -FN (skb_output), +FN (skb_output), \ +FN (get_file_path),/* integer value in 'imm' field of BPF_CALL instruction selects which helper * function eBPF program intends to call
kernel/trace/bpf_trace.c +48 -0
60 lines not on this page · raw message
tools/include/uapi/linux/bpf.h +14 -1
@@ -2777,6 +2777,18 @@ union bpf_attr {* restricted to raw_tracepoint bpf programs. * Return * 0 on success, or a negative error in case of failure. +* +* int bpf_get_file_path(char *path, u32 size, int fd) +* Description +* Get **file** atrribute from the current task by *fd*, then call +* **d_path** to get it's absolute path and copy it as string into +* *path* of *size*. The **path** also support pseudo filesystems +* (whether or not it can be mounted). The *size* must be strictly +* positive. On success, the helper makes sure that the *path* is +* NUL-terminated. On failure, it is filled with zeroes. +* Return +* On success, returns the length of the copied string INCLUDING +* the trailing NUL, or a negative error in case of failure. */ #define __BPF_FUNC_MAPPER (FN ) \ FN(unspec), \
@@ -2890,7 +2902,8 @@ union bpf_attr {FN (sk_storage_delete), \FN (send_signal), \FN (tcp_gen_syncookie), \ -FN (skb_output), +FN (skb_output), \ +FN (get_file_path),/* integer value in 'imm' field of BPF_CALL instruction selects which helper * function eBPF program intends to call
Signature · 1 line
2.17.1