diff options
| author | Martin Kelly <martin.kelly@crowdstrike.com> | 2023-09-25 14:50:34 -0700 |
|---|---|---|
| committer | Andrii Nakryiko <andrii.nakryiko@gmail.com> | 2023-10-02 11:17:48 -0700 |
| commit | a20576f5f202103e0ae26de7751cf08ecd7231c1 (patch) | |
| tree | c1b367989b154d49a242c1d1e5cfb285bb070723 | |
| parent | bfa471bc859b9aebfbf72d953314165a0dc1c172 (diff) | |
| download | libbpf-a20576f5f202103e0ae26de7751cf08ecd7231c1.tar.gz | |
libbpf: Add ring_buffer__ring
Add a new function ring_buffer__ring, which exposes struct ring * to the
user, representing a single ringbuffer.
Signed-off-by: Martin Kelly <martin.kelly@crowdstrike.com>
Signed-off-by: Andrii Nakryiko <andrii@kernel.org>
Link: https://lore.kernel.org/bpf/20230925215045.2375758-4-martin.kelly@crowdstrike.com
| -rw-r--r-- | src/libbpf.h | 15 | ||||
| -rw-r--r-- | src/libbpf.map | 1 | ||||
| -rw-r--r-- | src/ringbuf.c | 8 |
3 files changed, 24 insertions, 0 deletions
diff --git a/src/libbpf.h b/src/libbpf.h index 0e52621..de3ef59 100644 --- a/src/libbpf.h +++ b/src/libbpf.h @@ -1229,6 +1229,7 @@ LIBBPF_API int bpf_tc_query(const struct bpf_tc_hook *hook, /* Ring buffer APIs */ struct ring_buffer; +struct ring; struct user_ring_buffer; typedef int (*ring_buffer_sample_fn)(void *ctx, void *data, size_t size); @@ -1249,6 +1250,20 @@ LIBBPF_API int ring_buffer__poll(struct ring_buffer *rb, int timeout_ms); LIBBPF_API int ring_buffer__consume(struct ring_buffer *rb); LIBBPF_API int ring_buffer__epoll_fd(const struct ring_buffer *rb); +/** + * @brief **ring_buffer__ring()** returns the ringbuffer object inside a given + * ringbuffer manager representing a single BPF_MAP_TYPE_RINGBUF map instance. + * + * @param rb A ringbuffer manager object. + * @param idx An index into the ringbuffers contained within the ringbuffer + * manager object. The index is 0-based and corresponds to the order in which + * ring_buffer__add was called. + * @return A ringbuffer object on success; NULL and errno set if the index is + * invalid. + */ +LIBBPF_API struct ring *ring_buffer__ring(struct ring_buffer *rb, + unsigned int idx); + struct user_ring_buffer_opts { size_t sz; /* size of this struct, for forward/backward compatibility */ }; diff --git a/src/libbpf.map b/src/libbpf.map index 5771232..7a7370c 100644 --- a/src/libbpf.map +++ b/src/libbpf.map @@ -400,4 +400,5 @@ LIBBPF_1.3.0 { bpf_program__attach_netfilter; bpf_program__attach_tcx; bpf_program__attach_uprobe_multi; + ring_buffer__ring; } LIBBPF_1.2.0; diff --git a/src/ringbuf.c b/src/ringbuf.c index 94d11fb..efde453 100644 --- a/src/ringbuf.c +++ b/src/ringbuf.c @@ -330,6 +330,14 @@ int ring_buffer__epoll_fd(const struct ring_buffer *rb) return rb->epoll_fd; } +struct ring *ring_buffer__ring(struct ring_buffer *rb, unsigned int idx) +{ + if (idx >= rb->ring_cnt) + return errno = ERANGE, NULL; + + return rb->rings[idx]; +} + static void user_ringbuf_unmap_ring(struct user_ring_buffer *rb) { if (rb->consumer_pos) { |