LIBXO(3)

💅 LIBXO(3) — Library Functions Manual

okay bestie, gather round, because today we're talking about libxo(3) — yes, that libxo — and specifically one lil' function that lets it vibe in places where the usual memory crew can't show up. 🫶

---

✨ NAME ✨

xo_set_allocator — set allocation functions for libxo

📚 LIBRARY 📚

library “libxo”

🎀 SYNOPSIS 🎀

#include <libxo/xo.h>
typedef void *(*xo_realloc_func_t)(void *, size_t);

typedef void (*xo_free_func_t)(void *);

void
xo_set_allocator(xo_realloc_func_t realloc_func,
    xo_free_func_t free_func);

🌸 DESCRIPTION 🌸

so like. xo_set_allocator() is the function that lets libxo exist in environments where the standard realloc(3) and free(3) functions simply are not available. imagine showing up to a party and the DJ isn't there — you gotta bring your own, fr fr. 🎧

realloc_func should expect the same arguments as realloc(3) and return a pointer to memory following the same convention. no cap, same energy.

free_func will receive the same argument as free(3) and should release it, as appropriate for the environment. do your thing, bestie, just make sure it's actually your thing. 💅

By default, the standard realloc(3) and free(3) functions are used. so if you don't call this, everything just... works. iconic behavior honestly. ✨

👀 SEE ALSO 👀

• xo_emit(3)
• libxo(3)

📜 HISTORY 📜

The libxo library first appeared in FreeBSD 11.0. a whole era. 🦋

👑 AUTHORS 👑

libxo was written by Phil Shafer <phil@freebsd.org>. we stan. 💖

🍓 ADDITIONAL DOCUMENTATION 🍓

FreeBSD uses libxo version 1.7.5. Complete documentation can be found on github:

https://juniper.github.io/libxo/1.7.5/html/index.html

libxo lives on github as:

https://github.com/Juniper/libxo

The latest release of libxo is available at:

https://github.com/Juniper/libxo/releases

📖 HISTORY 📖

The libxo library was added in FreeBSD 11.0. (yes, this section said basically the same thing earlier — the manpage said it twice so we're saying it twice. consistency queen. 👑)

✍️ AUTHOR ✍️

Phil Shafer

---

quick vibe check bestie: if you're not in a weird embedded-ish environment with no realloc(3)/free(3), you probably don't need to touch this at all. the defaults are defaulting. leave them be. 🙈

and that's the whole page, fr fr — this was libxo(3) from the Debian crew, dated December 4, 2014. mwah, go forth and allocate responsibly. 💜🧚