|
HTML rendering created 2025-02-02 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | SEE ALSO | COLOPHON |
|
|
|
io_uring_prep_fadvise(3) liburing Manual io_uring_prep_fadvise(3)
io_uring_prep_fadvise - prepare a fadvise request
#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);
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.
None
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.
io_uring_get_sqe(3), io_uring_submit(3), io_uring_register(2),
posix_fadvise(2)
This page is part of the liburing (A library for io_uring)
project. Information about the project can be found at
⟨https://github.com/axboe/liburing⟩. If you have a bug report for
this manual page, send it to io-uring@vger.kernel.org. This page
was obtained from the project's upstream Git repository
⟨https://github.com/axboe/liburing⟩ on 2025-02-02. (At that time,
the date of the most recent commit that was found in the
repository was 2025-01-22.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
liburing-2.2 March 13, 2022 io_uring_prep_fadvise(3)
Pages that refer to this page: io_uring_prep_fadvise(3), io_uring_prep_fadvise64(3)
|
HTML rendering created 2025-02-02 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|