FcConfigSetSysRoot(3)

okay bestie, you clicked into the FcConfigSetSysRoot(3) manual page and it's giving “set the system root directory” energy 💅✨

🌸 NAME 🌸

FcConfigSetSysRoot — set the system root directory 🎀

🦋 SYNOPSIS 🦋

Here's the include and the signature, exactly as they are, no cap:

#include <fontconfig/fontconfig.h>

void FcConfigSetSysRoot (FcConfig *config, const FcChar8 *sysroot);

💅 DESCRIPTION 💅

okay so this is the part where you set sysroot as the system root directory. Like, that's the whole assignment, and it ate 💅.

Every file path that's used or created with this config — and yup, that includes file properties in patterns — will be considered relative to this sysroot, or made relative to it. No weirdness, just everything sitting under that root vibe 🌈.

This is lowkey iconic because it lets a host generate caches for targets at build time. (Build-time cache generation? Obsessed.) 🫶

It also means a cache can be re-targeted to a different base directory — but only if FcConfigGetSysRoot is used to resolve file paths. That's the catch, bestie, don't forget it 💖.

And when you set this on the current config, that causes changing the current config, which means it calls FcConfigSetCurrent(). So yeah, it's making moves on the current config fr fr.

🎀 SINCE 🎀

version 2.10.92 ✨ — she's been around.

---

xoxo, Fontconfig 2.17.0 • 27 June 2025 • catch u on FcConfigSetSysRoot(3) again 💖🫶