io\_uring\_buf\_ring\_init(3) liburing Manual io\_uring\_buf\_ring\_init(3)

# [NAME](#NAME)

io\_uring\_buf\_ring\_init - Initialise a buffer ring

# [SYNOPSIS](#SYNOPSIS)

```
#include <liburing.h>
```

```
void io_uring_buf_ring_init(struct io_uring_buf_ring *br);
```

# [DESCRIPTION](#DESCRIPTION)

[**io\_uring\_buf\_ring\_init**(3)](/man/os/liburing/io_uring_buf_ring_init.3) initialises *br* so that it is ready to be used. It may be called after [**io\_uring\_register\_buf\_ring**(3)](/man/os/liburing/io_uring_register_buf_ring.3) but must be called before the buffer ring is used in any other way.

# [RETURN VALUE](#RETURN_VALUE)

None

# [NOTES](#NOTES)

Unless manual setup is needed, it's recommended to use [**io\_uring\_setup\_buf\_ring**(3)](/man/os/liburing/io_uring_setup_buf_ring.3) as it provides a simpler way to setup a provided buffer ring.

# [SEE ALSO](#SEE_ALSO)

[**io\_uring\_register\_buf\_ring**(3)](/man/os/liburing/io_uring_register_buf_ring.3), [**io\_uring\_setup\_buf\_ring**(3)](/man/os/liburing/io_uring_setup_buf_ring.3), [**io\_uring\_buf\_ring\_add**(3)](/man/os/liburing/io_uring_buf_ring_add.3) [**io\_uring\_buf\_ring\_advance**(3)](/man/os/liburing/io_uring_buf_ring_advance.3), [**io\_uring\_buf\_ring\_cq\_advance**(3)](/man/os/liburing/io_uring_buf_ring_cq_advance.3)

June 13, 2022 liburing-2.2

---

Document: io_uring_buf_ring_init(3) from liburing 2.15-r5 (Chainguard OS)
Source: https://github.com/axboe/liburing.git