io_uring_cq_eventfd_toggle(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON

io_uring_cq...ntfd_toggle(3) liburing Manual io_uring_cq...ntfd_toggle(3)

NAME         top

       io_uring_cq_eventfd_toggle - toggle eventfd notifications on or
       off

SYNOPSIS         top

       #include <liburing.h>

       int io_uring_cq_eventfd_toggle(struct io_uring *ring, bool enabled);

DESCRIPTION         top

       The io_uring_cq_eventfd_toggle(3) function toggles eventfd
       notifications for the io_uring instance specified by ring.  If
       enabled is true, eventfd notifications are enabled. If enabled is
       false, they are disabled.

       An eventfd must first be registered with the ring using
       io_uring_register_eventfd(3) or io_uring_register_eventfd_async(3)
       before this function can be used.

       This can be useful when the application wants to temporarily stop
       receiving eventfd notifications, for example during a batch
       processing phase.

RETURN VALUE         top

       Returns 0 on success. On error, a negative errno value is
       returned:

       -EOPNOTSUPP
              The kernel does not support toggling eventfd notifications,
              or no eventfd is registered.

SEE ALSO         top

       io_uring_register_eventfd(3), io_uring_register_eventfd_async(3),
       io_uring_cq_eventfd_enabled(3)

COLOPHON         top

       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 2026-05-24.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2026-05-18.)  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.4                 January 18, 2025io_uring_cq...ntfd_toggle(3)

Pages that refer to this page: io_uring_cq_eventfd_enabled(3)io_uring_cq_eventfd_toggle(3)