io_uring_prep_close(3)          liburing Manual         io_uring_prep_close(3)

NAME
       io_uring_prep_close - prepare a file descriptor close request

SYNOPSIS
       #include <liburing.h>

       void io_uring_prep_close(struct io_uring_sqe *sqe,
                                 int fd);

       void io_uring_prep_close_direct(struct io_uring_sqe *sqe,
                                       unsigned file_index);


DESCRIPTION
       The io_uring_prep_close(3) function prepares a close request. The
       submission queue entry sqe is setup to close the file descriptor
       indicated by fd.

       For a direct descriptor close request, the offset is specified by the
       file_index argument instead of the fd.  This is identical to
       unregistering the direct descriptor, and is provided as a convenience.

       These functions prepare an async close(2) request. See that man page
       for details.


RETURN VALUE
       None

ERRORS
       The CQE res field will contain the result of the operation. See the
       related man page for details on possible values. Note that where
       synchronous system calls will return -1 on failure and set errno to the
       actual error value, io_uring never uses errno.  Instead it returns the
       negated errno directly in the CQE res field.

SEE ALSO
       io_uring_get_sqe(3), io_uring_submit(3), close(2)

liburing-2.2                    March 13, 2022          io_uring_prep_close(3)