shishi_kdcrep_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_kdcrep_to_file ✨

okay bestie, so this is a page from the shishi manual, section 3 — aka the library-functions section, aka where the C girlies live 💅. The function we're obsessing over today is shishi_kdcrep_to_file, and yes it does exactly what it says on the tin. Let's get into it 🫶

🎀 NAME 🎀

shishi_kdcrep_to_file — it's an API function, babes. That's the whole vibe.

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_kdcrep_to_file(Shishi * handle, Shishi_asn1 kdcrep, int
       filetype, const char * filename);

literally just include the header and you're in 🦋

💖 ARGUMENTS 💖

  • Shishi * handle — the shishi handle, and no you can't just make one up, it has to be allocated by shishi_init(). That's the source of truth, periodt.
  • Shishi_asn1 kdcrep — the KDC-REP you wanna save. This is the main character of the whole operation ngl 👑
  • int filetype — an input variable telling everyone what type of file you want written. Which types exist? Go look at Shishi_filetype, bestie, that's where the list lives 👀
  • const char * filename — an input variable holding the filename you're writing to. That's it. That's the destination 📁

🧚 DESCRIPTION 🧚

So what does it do? It writes the KDC-REP out to a file in the specified TYPE. That's the whole thing. Simple, clean, iconic ✨

⚠️ heads up though — the file will be truncated if it exists. Not "appended to", not "merged with", not "politely asked to make room". Truncated. Gone. So maybe don't point it at something precious 😭💀

⭐ RETURN VALUE ⭐

It returns SHISHI_OK if and only if it was successful. "Iff"! That's the math girlies' if and only if — no maybes, no vibes-based ambiguity. Anything that isn't SHISHI_OK means something went sideways 🙈

🌈 REPORTING BUGS 🌈

Found a bug? Don't suffer in silence, bestie. 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, take it, share it, remix it, just keep the receipts 🧾💜)

🦋 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, the command

info shishi

should give you access to the complete manual. slay 💅

okay that's the whole page!! every flag, every arg, every default — nothing skipped, nothing invented. you're welcome, go write some KDC-REPs 💖

this was shishi version 1.0.3, manual page shishi_kdcrep_to_file(3) — mwah, bye bestie 🎀✨

📦 where this page comes from