Man page - io_uring_submit_and_wait(3)

Packages contains this manual

Manual

io_uring_submit_and_wait

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO

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) 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) and prepares the SQE, it can be submitted with io_uring_submit_and_wait (3) .

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) returns the number of submitted submission queue entries. On failure it returns -errno .

SEE ALSO

io_uring_queue_init_params (3), io_uring_get_sqe (3), io_uring_submit (3), io_uring_submit_and_wait_timeout (3)