---
name: "io_uring_submit_and_wait"
section: "3"
platform: "linux"
package: "liburing"
version: "2.15-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/io_uring_submit_and_wait"
---

# io\_uring\_submit\_and\_wait(3)

submit requests to the submission queue and wait for completion

## NAME

io\_uring\_submit\_and\_wait - submit requests to the submission queue and wait for completion

## SYNOPSIS

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

**int io\_uring\_submit\_and\_wait(struct io\_uring \****ring***,**                              **unsigned** *wait\_nr***);**

## DESCRIPTION

The [**io\_uring\_submit\_and\_wait**(3)](/io_uring_submit_and_wait/3.md) function submits the next requests from the submission queue belonging to the *ring* and waits for *wait\_nr* completion events.

After the caller retrieves a submission queue entry (SQE) with [**io\_uring\_get\_sqe**(3)](/io_uring_get_sqe/3.md) and prepares the SQE, it can be submitted with [**io\_uring\_submit\_and\_wait**(3)](/io_uring_submit_and_wait/3.md)**.**

Ideally used with a ring setup with **IORING\_SETUP\_SINGLE\_ISSUER**\|**IORING\_SETUP\_DEFER\_TASKRUN** as that will greatly reduce the number of context switches that an application will see waiting on multiple requests.

## RETURN VALUE

On success [**io\_uring\_submit\_and\_wait**(3)](/io_uring_submit_and_wait/3.md) returns the number of submitted submission queue entries. On failure it returns **-errno**.

## SEE ALSO

[**io\_uring\_queue\_init\_params**(3)](/io_uring_queue_init_params/3.md), [**io\_uring\_get\_sqe**(3)](/io_uring_get_sqe/3.md), [**io\_uring\_submit**(3)](/io_uring_submit/3.md), [**io\_uring\_submit\_and\_wait\_timeout**(3)](/io_uring_submit_and_wait_timeout/3.md)