shishi_aprep_read(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_aprep_read(3) — the shishi manual, section 3 ✨

okay bestie, gather round, because today we're reading a whole entire function together and it's gonna be so good 🫶

🌸 NAME 🌸

shishi_aprep_read — it's an API function, babe. that's the whole vibe. 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_aprep_read(Shishi * handle, FILE * fh, Shishi_asn1 * aprep);

there it is. three arguments, one int coming back at you. iconic behavior fr fr 🔥

🎀 ARGUMENTS 🎀

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). it's literally the main character of this whole library, no cap 👑
  • FILE * fh — a file handle that's open for reading. yes bestie, open for reading, don't come at it with a write mode, that's not the assignment 😭
  • Shishi_asn1 * aprep — this is an output variable, and it comes out holding a newly allocated AP-REP. so like, you hand it a pointer, it hands you back a whole freshly allocated AP-REP. slay 💖

🦋 DESCRIPTION 🦋

so the way this works is: it reads a DER encoded AP-REP from the file, and then it populates the variable you gave it. that's it. that's the function. read the thing, fill the thing, done. lowkey elegant honestly 🌈

⭐ RETURN VALUE ⭐

it returns SHISHI_OK iff successful. and yes we said iff, meaning if and only if, so if you got SHISHI_OK you ATE, and if you didn't… well. 🙈

💀 REPORTING BUGS 💀

found a bug? don't just scream into the group chat, actually report it to <bug-shishi@gnu.org>. that's the move, bestie 🫶

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.

(translation: you can copy and share this freely, just keep the copyright notice and this notice with it. be a good citizen about it 💜)

🌟 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. go read it, it's giving knowledge 📚✨

and that's the whole page, bestie!! you understood every single word of it, I'm so proud, genuinely 💅

this was shishi 1.0.3, dated the shishi shishi_aprep_read(3) era — mwah, bye, go read some DER 🍓🧚

📦 where this page comes from