Movatterモバイル変換

io_uring_prep_link_timeout(3) — Linux manual page

io_uring_pr...ink_timeout(3) liburing Manualio_uring_pr...ink_timeout(3)

NAME        top

       io_uring_prep_link_timeout - a timeout request for linked sqes

SYNOPSIS        top

#include <liburing.h>void io_uring_prep_link_timeout(struct io_uring_sqe *sqe,struct __kernel_timespec *ts,unsignedflags);

DESCRIPTION        top

       Theio_uring_prep_link_timeout(3) function prepares a timeout       request for linked sqes. The submission queue entrysqe is       setup for with timeout specified byts.  The flags argument holds       modifierflags for the timeout behaviour of the request.       Thets argument must be filled in with the appropriate information       for the timeout. It looks as follows:           struct __kernel_timespec {               __kernel_time64_t tv_sec;               long long tv_nsec;           };       Theflags argument may contain:IORING_TIMEOUT_ABS              The value specified ints is an absolute value rather than              a relative one.IORING_TIMEOUT_BOOTTIME              The boottime clock source should be used.IORING_TIMEOUT_REALTIME              The realtime clock source should be used.IORING_TIMEOUT_ETIME_SUCCESS              Consider an expired timeout a success in terms of the              posted completion.       It is invalid to create a chain (linked sqes) consisting only of a       link timeout request. If all the requests in the chain are       completed before timeout, then the link timeout request gets       canceled. Upon timeout, all the uncompleted requests in the chain       get canceled.

RETURN VALUE        top

       None

ERRORS        top

       These are the errors that are reported in the CQEres field. On       success,0is returned.-ETIMEThe specified timeout occurred and triggered the completion              event.-EINVAL              One of the fields set in the SQE was invalid. For example,              two clock sources where given, or the specified timeout              seconds or nanoseconds where < 0.-EFAULT              io_uring was unable to access the data specified by ts.-ECANCELED              The timeout was canceled because all submitted requests              were completed successfully or one of the requests resulted              in failure.-ENOENT              The request to which the linked timeout was linked already              completed and could not be found when the timer expired.

SEE ALSO        top

io_uring_get_sqe(3),io_uring_prep_timeout(3)

COLOPHON        top

       This page is part of theliburing (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-08-11.  (At that time,       the date of the most recent commit that was found in the       repository was 2025-08-02.)  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 isnot part of the original manual page), send a mail to       man-pages@man7.orgliburing-2.4                 January 23, 2023io_uring_pr...ink_timeout(3)

Pages that refer to this page:io_uring_prep_futex_wait(3), io_uring_prep_futex_waitv(3), io_uring_prep_link_timeout(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.