LIBXO(3)

💖 LIBXO(3) 💖

okay bestie, this is the libxo(3) manual page — Library Functions Manual energy, and today we're talking about exactly two functions. they're little. they're powerful. they're iconic.

---

🌸 NAME 🌸

xo_set_version, xo_set_version_h — record content-version information in encoded output

like... they literally just write down which version of the data you're looking at. that's the whole gig. and it slays.

---

📚 LIBRARY 📚

library "libxo"

yep. that's the one. the library. 🎀

---

✨ SYNOPSIS ✨

#include <libxo/xo.h>

void
xo_set_version(const char *version);

void
xo_set_version_h(xo_handle_t *xop, const char *version);

two functions. two voids. zero returns. we love a no-strings-attached situation. 🦋

---

💅 DESCRIPTION 💅

so, the xo_set_version function records a version number that gets emitted as part of the data — but only for the encoding styles XML and JSON. the other styles don't get the version, no cap.

this version number is lowkey perfect for tracking changes in the content, which means whoever's consuming your data can actually tell which version of the data model is in use. it's giving "read the room, but also read the version field." 👑

---

🔥 SEE ALSO 🔥

• xo_emit(3)
• libxo(3)

go read those too, bestie. they're the main characters of this friend group.

---

⭐ HISTORY ⭐

the libxo library first appeared in FreeBSD 11.0. a legend was born. 💫

---

🫶 AUTHORS 🫶

libxo was written by Phil Shafer <phil@freebsd.org>. thank you for your service, king. 👑

---

🌈 ADDITIONAL DOCUMENTATION 🌈

FreeBSD uses libxo version 1.7.5. the 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

and the latest release of libxo is available at:

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

go click. go read. go be informed. 📖✨

---

💜 HISTORY 💜

the libxo library was added in FreeBSD 11.0. (yes, again. it's said twice in the original and we respect the lore. ✨)

---

🎀 AUTHOR 🎀

Phil Shafer

---

okay that's the whole page, bestie, and it's a wrap!! 💖 this was the LIBXO(3) page from Debian, dated December 4, 2014 — shoutout to that date for being the origin story of this whole vibe. periodt. 🎀🦋💅