Skip to content

Libbpf eBPF macro BPF_PROBE_READ_STR_INTO

v0.4.0

The BPF_PROBE_READ_STR_INTO macro is a variant of the BPF_PROBE_READ_INTO macro, which is used to do a string read into user-provided storage.

Definition

#define BPF_PROBE_READ_STR_INTO(dst, src, a, ...) ({                \
    ___core_read(bpf_probe_read_kernel_str, bpf_probe_read_kernel,      \
             dst, (src), a, ##__VA_ARGS__)              \
})

Usage

BPF_PROBE_READ_STR_INTO is very similar to BPF_PROBE_READ_INTO, but it uses the bpf_probe_read_kernel_str helper function instead of the bpf_probe_read_kernel helper function. This makes it better suites for reading NUL-terminated strings from kernel memory.

This macro does not emit CO-RE relocations. Its value is mostly in the pointer chasing use cases where this macro can convert one accessor into multiple bpf_probe_read_kernel_str calls.

Please refer to the BPF_PROBE_READ documentation for more details on usage of it and its variants like this macros.

Example

Docs could be improved

This part of the docs is incomplete, contributions are very welcome