shishi_kdcrep_parse(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_parse(3) — the shishi manual, bestie edition 💅

okay so welcome to the shishi section 3 page for shishi_kdcrep_parse, and honestly? she's a little icon. short, sweet, does exactly one thing. let's get into it 🎀

✨ NAME ✨

shishi_kdcrep_parse — an API function, and yes that's the whole name, she doesn't need a long one 💖

🌈 SYNOPSIS 🌈

#include <shishi.h>

int shishi_kdcrep_parse(Shishi * handle, FILE * fh, Shishi_asn1 *
       kdcrep);

like. look at her. three args, one return, no drama 🌸

🦋 ARGUMENTS 🦋

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). she's the main character here, don't show up without her 👑
  • FILE * fh — a file handle, and it has to be open for reading. reading only, bestie. don't be weird about it 🙈
  • Shishi_asn1 * kdcrep — this is your output variable, and it comes pre-loaded with a freshly allocated KDC-REP. it's giving "here's your brand new thing, go be great" ✨

💖 DESCRIPTION 💖

so what she actually does: she reads an ASCII armored DER encoded KDC-REP out of the file, and then she populates the variable you handed her with it. that's it. that's the whole vibe. read the file → fill the variable → slay 💅

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. and listen, iff is doing a lot of work in that sentence — it's an "if and only if" situation, so if you see SHISHI_OK, you ate. anything else? that's a you problem, not hers 😭

🫶 REPORTING BUGS 🫶

found a bug? don't just sit there spiraling, tell the people:

no cap, they actually want to hear from you 🌈

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 yes, you may copy her. she's generous like that 👑

🔥 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. iykyk — go read the whole thing, there's lore 🦋

lowkey reminder: she parses KDC-REP specifically, so don't come at her with random bytes and expect magic. the DER has to be ASCII armored. periodt 💀

and that's the page, bestie!! this was shishi version 1.0.3, page shishi_kdcrep_parse(3), brought to you by the shishi crew 💜 go forth and parse responsibly 🧚🌸

📦 where this page comes from