shisa_cfg_from_file(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

💖 shisa_cfg_from_file — NAME 💖

okay so bestie, this one is shisa_cfg_from_file(3), a lil API function from the shishi manual, and it's literally just "hey, read my config from this file" energy. she's not complicated, she's not doing the most, she's just here to load a vibe from a path. 🎀

✨ SYNOPSIS ✨

#include <shisa.h>

int shisa_cfg_from_file(Shisa * dbh, const char * cfg);

that's it. that's the whole girl. two args, one int, zero drama. 🦋

🌸 ARGUMENTS 🌸

  • Shisa * dbh — the Shisa library handle, and like… she has to come from shisa(). you can't just show up with a random handle, you need the one that was actually created by shisa(). no fake IDs at the door bestie. 💅
  • const char * cfg — the file name of where we're reading the configuration from. literally just the path. that's the whole job. 🔥

💜 DESCRIPTION 💜

so basically this function configures the Shisa library using a configuration file located at cfg. that's the entire plot. she takes your handle, she takes your file name, she goes and reads the config, and the library gets configured. iconic behaviour, no notes. ✨

👑 RETURN VALUE 👑

  • Returns SHISA_OK if it worked, slay, we love a success story 🎉
  • and typically it returns SHISA_CFG_NO_FILE in response to a misnamed file — so if you typo'd your path, that's the one coming back at you. it's giving "girl that file does not exist" 😭

💀 REPORTING BUGS 💀

found something cursed? report bugs to <bug-shishi@gnu.org>.

they wanna hear about it fr fr, don't just suffer in silence. 🫶

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… go off, share it, remix it, just keep the receipts attached bestie. 💖

🌈 SEE ALSO 🌈

the full documentation for shishi is maintained as a Texinfo manual. if the info and shishi programs are properly installed at your site, then this command:

info shishi

should give you access to the complete manual. iykyk, info is lowkey the main character here. ⭐

kisses, and that's the whole page mwah 💋 — this was shishi version 1.0.3, page shisa_cfg_from_file(3), and yes she ate, no crumbs left. 🌸🦋💜

📦 where this page comes from