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

✨ NAME ✨

okay so bestie, today's main character is shisa_init — an API function from the shishi manual, page shisa_init(3). she makes handles. that's her whole thing. 💅

🌸 SYNOPSIS 🌸

#include <shisa.h>

int shisa_init(Shisa ** dbh);

like. that's it. one line. she's low maintenance, she's iconic. 🎀

🦋 ARGUMENTS 🦋

  • Shisa ** dbh — this is the returned pointer to a created Shisa library handle. so you hand her a pointer-to-a-pointer and she fills it in for you, bestie. that's the deal. ✨

💖 DESCRIPTION 💖

She creates a Shisa library handle, using shisa(), and she reads the system configuration file from its default location. slay.

The path to that default system configuration file? decided at compile time — it's literally $sysconfdir/shisa.conf. no cap. that's where it lives. 🫶

Now here's the tea, and it's important: the handle is allocated regardless of return value. the one and only exception is SHISA_INIT_ERROR, which means there was a problem allocating the handle itself. every other error condition comes up while reading a file. so like… the handle can exist even when things went sideways. she said "i'll be here anyway." 👑

⭐ RETURN VALUE ⭐

She returns SHISA_OK, or an error code. and SHISA_INIT_ERROR specifically means a failure to create the handle. that's the one to watch for, bestie. 👀

😭 REPORTING BUGS 😭

found a bug? report it to <bug-shishi@gnu.org>. do it. the devs wanna know, fr fr.

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 basically: go off, copy it, share it, remix it — just keep the copyright notice and this notice intact. that's the whole vibe check. 🌈

🧚 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, this command

info shishi

should give you access to the complete manual. iykyk. 📖✨

and that's the whole page, bestie!! this was shishi version 1.0.3, page shisa_init(3). go forth and init responsibly. 💖🎀🦋💅🫶👑

📦 where this page comes from