io\_uring\_queue\_mmap(3) liburing Manual io\_uring\_queue\_mmap(3)

# [NAME](#NAME)

io\_uring\_queue\_mmap - mmap io\_uring ring after setup

# [SYNOPSIS](#SYNOPSIS)

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

```
int io_uring_queue_mmap(int fd, struct io_uring_params *p,
                        struct io_uring *ring);
```

# [DESCRIPTION](#DESCRIPTION)

The [**io\_uring\_queue\_mmap**(3)](/man/os/liburing/io_uring_queue_mmap.3) function maps the io\_uring ring file descriptor *fd* into memory using the parameters in *p*. The resulting ring is stored in *ring*.

This function is a helper for applications that need to customize the ring setup process. Most applications should use [**io\_uring\_queue\_init**(3)](/man/os/liburing/io_uring_queue_init.3) or [**io\_uring\_queue\_init\_params**(3)](/man/os/liburing/io_uring_queue_init_params.3) instead, which call [**io\_uring\_setup**(2)](/man/os/liburing/io_uring_setup.2) and this function automatically.

The *fd* argument should be a file descriptor returned by [**io\_uring\_setup**(2)](/man/os/liburing/io_uring_setup.2), and *p* should contain the parameters returned by the setup call.

# [RETURN VALUE](#RETURN_VALUE)

Returns 0 on success, or a negative errno value on error.

# [SEE ALSO](#SEE_ALSO)

[**io\_uring\_setup**(2)](/man/os/liburing/io_uring_setup.2), [**io\_uring\_queue\_init**(3)](/man/os/liburing/io_uring_queue_init.3), [**io\_uring\_queue\_init\_params**(3)](/man/os/liburing/io_uring_queue_init_params.3), [**io\_uring\_queue\_exit**(3)](/man/os/liburing/io_uring_queue_exit.3)

January 18, 2025 liburing-2.4

---

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