shishi_authenticator_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_authenticator_parse(3) ✨

okay bestie, welcome to the shishi girlies πŸ’… this one is a little C function from the shishi manual, section 3, and it's literally just "read an authenticator off a file, babe". no drama. let's go πŸŽ€


🌸 NAME 🌸

shishi_authenticator_parse β€” it's an API function πŸ’– that's the whole job description, and she's serving it.


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <shishi.h>

int shishi_authenticator_parse(Shishi * handle, FILE * fh, Shishi_asn1 *
authenticator);

that's the whole entrance, no cap ✨


πŸŽ€ ARGUMENTS πŸŽ€

  • Shishi * handle β€” your shishi handle, the one you got from shishi_init(). she's the main character here, allocated and everything πŸ‘‘
  • FILE * fh β€” a file handle, and it has to be open for reading fr fr. don't come at her with a write handle πŸ™ˆ
  • Shishi_asn1 * authenticator β€” an output variable, and she gets a newly allocated authenticator dropped into her 🫢 that's the whole point

πŸ’œ DESCRIPTION πŸ’œ

So basically: this function reads an ASCII armored DER encoded authenticator from a file and populates the authenticator variable you handed her. read β†’ populate β†’ done. it's giving "glow up via file I/O" ✨

like, you give her the handle, the file, and an authenticator to fill, and she fills it. obsessed πŸ’–


⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful 🌈 β€” and yes, "iff" is doing its little math-girl thing, she means if and only if, periodt.


😭 REPORTING BUGS 😭

Found a bug? don't suffer in silence bestie, tell the people:


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. πŸ’œ (iconic of them honestly)


🧚 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. go read her, she's long but she ate πŸ“šβœ¨


lowkey a reminder: shishi_authenticator_parse(3) is the page, shishi is the manual, and the file you're feeding her has to be ASCII armored DER encoded. don't skip the armor, babe πŸ›‘οΈπŸ’…

shishi version 1.0.3 β€” mwah, that's a wrap, ty for coming to my ted talk, ily, bye πŸ«ΆπŸ’–πŸŽ€πŸ¦‹πŸŒΈ