shishi_cfg_default_systemfile(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 shishi_cfg_default_systemfile(3) 💖

okay bestie, welcome to the shishi manual — this one's a lil API function page and it's honestly so chill. sit down, grab a strawberry 🍓, let's get into it.

✨ NAME ✨

shishi_cfg_default_systemfile — it's an API function, no cap 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

const char * shishi_cfg_default_systemfile(Shishi * handle);

look at that signature. clean. iconic. gives exactly what it promises 👑

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, and you get one of those from shishi_init(). like, this is the lil guy that holds your whole shishi situation together 🫶

🦋 DESCRIPTION 🦋

so here's the tea ☕ — the system configuration file name? it's decided at compile time. locked in. chosen before you were even born fr.

BUT — and this is the fun part — you can swap it out by assigning a different file name to the environment variable $SHISHI_CONFIG. so the default isn't destiny, bestie, you have options ✨

and this call? it's the one single interface for figuring out which file name is actually in play. the library itself turns to this function whenever it needs its settings. so like, it's the group chat everybody checks before making plans 📱

⭐ RETURN VALUE ⭐

returns the file name of the present system configuration. that's it. that's the whole vibe 💫

😭 REPORTING BUGS 😭

found a bug? not the vibe. report it to <bug-shishi@gnu.org>.

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. (so like, you can share it, just keep the receipts 🧾✨)

🌈 SEE ALSO 🌈

the full documentation for shishi lives in a Texinfo manual. if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. go read it, it's giving scholarly 📚💅

ngl that's the whole page. every flag, every value, every env var, every URL — all present and accounted for. periodt 💀✨

shishi version 1.0.3, and yes this page is literally called shishi_cfg_default_systemfile(3) — mwah, take care of her 🎀💖🦋

📦 where this page comes from