io_uring_check_version(3)

✨ io_uring_check_version(3) — the liburing Manual, bestie edition ✨

okay so. you ever load a library and just... not know what version you got? 🫠 yeah. that's the vibe this whole page is about. these are the functions and macros that let you check the liburing version — the one you're linked against at runtime vs the one you're compiling against, which are lowkey not always the same thing, and that's the whole tea. 🍵

🌸 NAME 🌸

io_uring_check_version — functions and macros to check the liburing version 💅

🦋 SYNOPSIS 🦋

#include <liburing.h>

bool io_uring_check_version(int major, int minor);
IO_URING_CHECK_VERSION(major, minor);

int io_uring_major_version(void);
IO_URING_VERSION_MAJOR;

int io_uring_minor_version(void);
IO_URING_VERSION_MINOR;

🎀 DESCRIPTION 🎀

okay bestie, there's six things here and they all come in pairs: a runtime version (the library the dynamic linker actually loaded) and a compile-time version (the one you're building against). know the difference, it's giving main character energy. 👑

• io_uring_check_version(3) — returns false if the liburing library loaded by the dynamic linker is greater-than or equal-to the major and minor numbers you passed in. so yeah, false here is actually the good news, don't panic 😭
• IO_URING_CHECK_VERSION(3) — the macro twin 💖 returns 0 if the liburing library being compiled against is greater-than or equal-to the major and minor numbers you passed in.
• io_uring_major_version(3) — returns the major version number of the liburing library loaded by the dynamic linker. runtime, bb. ✨
• IO_URING_VERSION_MAJOR(3) — returns the major version number of the liburing library being compiled against. compile-time, bb. 💅
• io_uring_minor_version(3) — returns the minor version number of the liburing library loaded by the dynamic linker. runtime again, the sequel. 🦋
• IO_URING_VERSION_MINOR(3) — returns the minor version number of the liburing library being compiled against. compile-time again, the sequel's sequel. 🌸

not me reminding you that "loaded by the dynamic linker" and "being compiled against" are two different libraries sometimes, and that's exactly why these six exist. iykyk. 🙈

that's the whole page, no cap. go check your versions, you icon. 🫶

mwah 💋 this was brought to you by liburing-2.4, dated December 1, 2022, and it's still slaying in io_uring_check_version(3).