shishi_safe_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

✨ NAME ✨

shishi_safe_read — it's an API function bestie, that's the whole vibe 💅

Okay so real talk, this little cutie lives in the shishi manual, section 3, and its whole job is reading a SAFE off a file. Iconic.

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_safe_read(Shishi * handle, FILE * fh, Shishi_asn1 * safe);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, and no you can't just make one up, it's gotta be allocated by shishi_init(). That's its origin story fr.
  • FILE * fh — a file handle that's open for reading. Just reading. Don't get weird with it.
  • Shishi_asn1 * safe — an output variable that ends up holding a newly allocated SAFE. It's giving "surprise, here's your SAFE." 🎁

🦋 DESCRIPTION 🦋

So what it does is: read a DER encoded SAFE from the file, and populate the variable you handed it. That's it, that's the function. Simple, clean, slays. ✨

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff it was successful. If you see SHISHI_OK you ate. If you don't… well. 😭

💀 REPORTING BUGS 💀

Found a bug? (not me manifesting one 🙈) Report it 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. So like, go off, 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. Iykyk, info is lowkey underrated.

Okay that's the whole page bestie!! This was shishi 1.0.3, from the shishi_safe_read(3) manual — mwah, go read some SAFEs, periodt 💖🧚💜

📦 where this page comes from