SHISHI_AUTHENTICATOR_AUTHORIZATIONDATA(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_authenticator_authorizationdata — okay bestie, this is an API function, and it's the one that pulls authorization data out of an authenticator. That's the whole vibe. Periodt. ✨

(It lives in the shishi manual, section 3, so if you see shishi_authenti...thorizationdata(3) floating around, that's literally her. 💅)

🎀 SYNOPSIS 🎀

#include <shishi.h>

int shishi_authenticator_authorizationdata(Shishi * handle, Shishi_asn1
authenticator, int32_t * adtype, char ** addata, size_t * addatalen,
size_t nth);

✨ ARGUMENTS ✨

  • Shishi * handle — your shishi handle, as allocated by shishi_init(). She's the main character, everything goes through her. 👑
  • Shishi_asn1 authenticator — the authenticator, as allocated by shishi_authenticator(). Yes, you have to make one first, no skipping steps bestie. 🦋
  • int32_t * adtype — output authorization data type. She gets written to, she does not get read from, okay? 💜
  • char ** addata — newly allocated output authorization data. Newly allocated, meaning somebody's gotta free that later, not me tho. 🙈
  • size_t * addatalen — on output, the actual size of that newly allocated authorization data. She tells you how big the thing you just got is. 📏
  • size_t nth — the element number of the authorization-data you wanna extract. So which one, bestie. Pick one. 🌸

🔥 EXTRACT NTH AUTHORIZATION DATA FROM AUTHENTICATOR 🔥

Extract nth authorization data from authenticator. The first field is 1.

Lowkey important: it's 1-indexed, not 0-indexed. So "the first one" is 1, not 0. Don't come at me, that's just how she is. 💀

💖 RETURN VALUE 💖

Returns SHISHI_OK iff successful. That's it, that's the whole return value situation. If you see SHISHI_OK, you ate. 🔥

🌈 REPORTING BUGS 🌈

Found a bug? Report it to <bug-shishi@gnu.org>. Not me, I'm just the messenger. 😭

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.

🫶 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 it, it's giving ✨educated✨.

And that's a wrap, bestie! This page ships with shishi, version 1.0.3, from the shishi source — that's the whole footer situation, no date drama, just version 1.0.3 doing her thing. Mwah. 💅💖

📦 where this page comes from