plucky (3) io_uring_prep_fadvise64.3.gz

NAME

       io_uring_prep_fadvise - prepare a fadvise request

SYNOPSIS

       #include <fcntl.h>
       #include <liburing.h>

       void io_uring_prep_fadvise(struct io_uring_sqe *sqe,
                                  int fd,
                                  __u64 offset,
                                  __u32 len,
                                  int advice);

       void io_uring_prep_fadvise64(struct io_uring_sqe *sqe,
                                    int fd,
                                    __u64 offset,
                                    off_t len,
                                    int advice);

DESCRIPTION

       The  io_uring_prep_fadvise(3)  function  prepares  an  fadvise request. The submission queue entry sqe is
       setup to use the file descriptor pointed to by fd to start an fadvise operation  at  offset  and  of  len
       length in bytes, giving it the advise located in advice.

       The io_uring_prep_fadvise64(3) function works like io_uring_prep_fadvise(3) except that it takes a 64-bit
       length rather than just a 32-bit one. Older kernels may not support the 64-bit length  variant.  If  this
       variant  is  attempted  used  on  a kernel that doesn't support 64-bit lengths, then the request will get
       errored with -EINVAL in the results field of the CQE.

       This function prepares an async posix_fadvise(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), io_uring_register(2), posix_fadvise(2)