io\_uring\_cq\_eventfd\_toggle(3) liburing Manual io\_uring\_cq\_eventfd\_toggle(3)

# [NAME](#NAME)

io\_uring\_cq\_eventfd\_toggle - toggle eventfd notifications on or off

# [SYNOPSIS](#SYNOPSIS)

```
#include <liburing.h>
```

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

# [DESCRIPTION](#DESCRIPTION)

The [**io\_uring\_cq\_eventfd\_toggle**(3)](/man/os/liburing/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)](/man/os/liburing/io_uring_register_eventfd.3) or [**io\_uring\_register\_eventfd\_async**(3)](/man/os/liburing/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](#RETURN_VALUE)

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

[**-EOPNOTSUPP**](#EOPNOTSUPP)

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

# [SEE ALSO](#SEE_ALSO)

[**io\_uring\_register\_eventfd**(3)](/man/os/liburing/io_uring_register_eventfd.3), [**io\_uring\_register\_eventfd\_async**(3)](/man/os/liburing/io_uring_register_eventfd_async.3), [**io\_uring\_cq\_eventfd\_enabled**(3)](/man/os/liburing/io_uring_cq_eventfd_enabled.3)

January 18, 2025 liburing-2.4

---

Document: io_uring_cq_eventfd_toggle(3) from liburing 2.15-r5 (Chainguard OS)
Source: https://github.com/axboe/liburing.git