CXL_NEW(3)

CXL_NEW(3) — cxl_new 🎀

okay so welcome to the libcxl Manual page for cxl_new, bestie. This is the creation moment where you get a library context handle, and it’s giving main character energy for all your library operations 💅

✨ NAME ✨

cxl_new — Create a new library context object that acts as a handle for all library operations 🫶

📚 SYNOPSIS 📚

#include <cxl/libcxl.h>

int cxl_new(struct cxl_ctx **ctx);

🦋 DESCRIPTION 🦋

cxl_new instantiates a new library context, and stores an opaque pointer in ctx. No cap, that pointer is literally your handle. The context is freed by linklibcxl:cxl_unref[3], i.e. cxl_new(3) implies an internal linklibcxl:cxl_ref[3] 💖

💀 RETURN VALUE 💀

Returns 0 on success, and a negative errno on failure. Possible error codes are:

• -ENOMEM
• -ENXIO

🌸 EXAMPLE 🌸

See example usage in test/libcxl.c 👑

🧚 COPYRIGHT 🧚

Copyright © 2016 - 2022, Intel Corporation. License GPLv2: GNU GPL version 2 http://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

🌈 SEE ALSO 🌈

• linklibcxl:cxl_ref[3]
• linklibcxl:cxl_unref[3]

xoxo, this page is brought to you by libcxl, dated 2026-06-30, and filed under CXL_NEW(3) 💖✨