io_uring_sqring_wait(3)

io_uring_sqring_wait3

Wait for free space in the sq ring

Usage

#include <liburing.h>

int io_uring_sqring_wait(struct io_uring *ring);

Overview

The function io_uring_sqring_wait(3) allows the caller to wait for space to free up in the SQ ring belonging to the ring param, which happens when the kernel side thread has consumed one or more entries. If the SQ ring is currently non-full, no action is taken.

This feature can only be used when the ring has been setup with IORING_SETUP_SQPOLL and hence is using an offloaded approach to request submissions.

Return value

On success it returns the free space. If the kernel does not support the feature, -EINVAL is returned.

Releases

Unchanged in 3 releases since Debian 12 (Bookworm).

  1. 12–Arch

From liburing 2.15-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.