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)

liburing-2.1                                    November 15, 2021                    io_uring_submit_and_wait(3)