shishi_krberror_to_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

💖 shishi_krberror_to_file — the API function, bestie 💖

okay so real talk, this is a page from the shishi manual (that's the manual name, bestie, it's giving "I contain multitudes and also Kerberos") and we're gonna talk about one specific little function. it's called shishi_krberror_to_file. yes the name is long. no we're not shortening it. periodt. 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_krberror_to_file(Shishi * handle, Shishi_asn1 krberror, int
       filetype, const char * filename);

look at her. four arguments. a whole queen. 🎀

🌸 ARGUMENTS 🌸

okay bestie, let's go through the cast of characters one by one, no cap:

  • Shishi * handle — the shishi handle, and you get one of these from shishi_init(). she's the main character, everything runs through her.
  • Shishi_asn1 krberror — the actual KRB-ERROR you wanna save. this is the thing. the moment. the icon. 🦋
  • int filetype — an input variable that says what type of file you're writing, and for the full tea you gotta check Shishi_filetype. iykyk.
  • const char * filename — an input variable with the filename you're writing to. yes, you have to tell it where to go. she's not a mind reader. 🙈

💜 DESCRIPTION 💜

so what does she do?? she writes the KRB-ERROR to a file in the specified TYPE. that's the whole vibe. that's the assignment and she ate. 🔥

⚠️ okay important bestie: the file will be truncated if it already exists. that means if there was stuff in there before, it is gone. evaporated. not me being dramatic, that's just literally what truncation is. protect your data, queen. 😭

⭐ RETURN VALUE ⭐

she returns SHISHI_OK iff successful. that's it. that's the whole return value. if you get SHISHI_OK, you slayed. if you don't... you didn't. 💀

🐛 REPORTING BUGS 🐛

found a bug?? first of all, relatable, second of all, please report it, don't just suffer in silence bestie:

Report bugs to <bug-shishi@gnu.org>.

GNU Shishi home page: http://www.gnu.org/software/shishi/

General help using GNU software: http://www.gnu.org/gethelp/

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.

🌈 SEE ALSO 🌈

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

info shishi

should give you access to the complete manual. go read it, it's the extended universe. 🫶

and that's the whole page, bestie!! this was shishi_krberror_to_file(3) from the shishi manual, version 1.0.3 — shoutout to the version and the source for keeping it real, mwah, stan, bye 💖✨

📦 where this page comes from