io_uring_get_sqe128(3)          liburing Manual         io_uring_get_sqe128(3)

NAME
       io_uring_get_sqe128 - get the next available 128-byte submission queue
       entry from the submission queue

SYNOPSIS
       #include <liburing.h>

       struct io_uring_sqe *io_uring_get_sqe128(struct io_uring *ring);

DESCRIPTION
       The io_uring_get_sqe128(3) function gets the next available 128-byte
       submission queue entry from the submission queue belonging to the ring
       param.

       On success io_uring_get_sqe128(3) returns a pointer to the submission
       queue entry. On failure NULL is returned.

       If a submission queue entry is returned, it should be filled out via
       one of the prep functions such as io_uring_prep_uring_cmd128(3) and
       submitted via io_uring_submit(3).

       Note that neither io_uring_get_sqe128(3) nor the prep functions set (or
       clear) the user_data field of the SQE. If the caller expects
       io_uring_cqe_get_data(3) or io_uring_cqe_get_data64(3) to return valid
       data when reaping IO completions, either io_uring_sqe_set_data(3) or
       io_uring_sqe_set_data64(3) MUST have been called before submitting the
       request.


RETURN VALUE
       io_uring_get_sqe128(3) returns a pointer to the next submission queue
       event on success and NULL on failure. If NULL is returned, the SQ ring
       either wasn't created with support for 128-byte SQE entries (
       IORING_SETUP_SQE128 or IORING_SETUP_SQE_MIXED ) or is currently full
       and entries must be submitted for processing before new ones can get
       allocated.

SEE ALSO
       io_uring_get_sqe(3), io_uring_submit(3), io_uring_sqe_set_data(3)

liburing-2.13                  October 22, 2025         io_uring_get_sqe128(3)