io\_uring\_register\_clock(3) liburing Manual io\_uring\_register\_clock(3)

# [NAME](#NAME)

io\_uring\_register\_clock - set clock source for event waiting

# [SYNOPSIS](#SYNOPSIS)

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

```
int io_uring_register_clock(struct io_uring *ring,
                            struct io_uring_clock_register *arg);
```

# [DESCRIPTION](#DESCRIPTION)

The [**io\_uring\_register\_clock**(3)](/man/os/liburing/io_uring_register_clock.3) function registers which clock source should be used by io\_uring, when an application waits for event completions. The *ring* argument should point to the ring in question, and the *arg* argument should be a pointer to a **struct io\_uring\_clock\_register .**

The *arg* argument must be filled in with the appropriate information. It looks as follows:

```
struct io_uring_clock_register {


    __u32 clockid;


    __u32 __resv[3];
};
```

The *clockid* field must contain the clock source, with valid sources being:

[**CLOCK\_MONOTONIC**](#CLOCK_MONOTONIC)

a nonsettable system-wide clock that represents monotonic time.

[**CLOCK\_BOOTTIME**](#CLOCK_BOOTTIME)

A nonsettable system-wide clock that is identical to **CLOCK\_MONOTONIC ,** except that is also icnludes any time that the system is suspended.

See [**clock\_gettime**(3)](/man/os/liburing/clock_gettime.3) for more details.

The *\_\_resv* fields must be filled with zeroes.

Available since 6.12.

# [RETURN VALUE](#RETURN_VALUE)

On success [**io\_uring\_register\_clock**(3)](/man/os/liburing/io_uring_register_clock.3) returns 0. On failure it returns **-errno**.

# [SEE ALSO](#SEE_ALSO)

[**clock\_gettime**(3)](/man/os/liburing/clock_gettime.3), [**io\_uring\_register**(2)](/man/os/liburing/io_uring_register.2), [**io\_uring\_wait\_cqe**(3)](/man/os/liburing/io_uring_wait_cqe.3), [**io\_uring\_wait\_cqe\_timeout**(3)](/man/os/liburing/io_uring_wait_cqe_timeout.3),

August 18, 2024 liburing-2.8

---

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