SHISHI_AUTHENTICATOR_ADD_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

💖 shishi_authenticator_add_authorizationdata — the NAME section, bestie 💖

okay so this is a page from the shishi manual (section 3, the library-functions girlies 🫶), and the function we're hyping up today is literally called:

shishi_authenticator_add_authorizationdata — an API function ✨

that's it. that's the name. it does exactly what it says on the tin and honestly? we love a transparent icon 👑

✨ SYNOPSIS ✨

#include <shishi.h>

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

so you gotta pull in <shishi.h> first, obviously, and then it hands you back an int. classic. 💅

🎀 ARGUMENTS 🎀

bestie the arguments are the whole vibe, let's go one by one:

  • Shishi * handle — your shishi handle, the one you got when you called shishi_init(). it's giving ✨main character✨ because literally everything needs it.
  • Shishi_asn1 authenticator — the authenticator, as allocated by shishi_authenticator(). yes, that specific one. no substitutions, no random authenticators you found lying around. 🚫
  • int32_t adtype — the input authorization data type you wanna add. it's an int32_t, so it's a whole-number type situation. 📏
  • const char * addata — the input authorization data you're adding. this is the actual content, the payload, the moment. 🍓
  • size_t addatalen — the size of the input authorization data you're adding. because addata can't just wander in with no length, that's unsafe and we don't do that here. 😭

🌸 DESCRIPTION 🌸

Add authorization data to authenticator.

that's the whole thing. that's the sentence. it adds authorization data to the authenticator. lowkey the most honest description in the whole manual and I'm obsessed. 🦋

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful.

note the iff, bestie — if and only if. if it's not SHISHI_OK, it was not successful, and you should go check your vibes accordingly. 💀

🙈 REPORTING BUGS 🙈

found a bug? not the cute kind? 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.

slay, that's a genuinely generous license and we respect 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, the command

info shishi

should give you access to the complete manual. iykyk 📖✨

and that's the page, bestie!! this was shishi_authenti...thorizationdata(3) from the shishi manual, version 1.0.3, and the footer's date energy lives right here at the bottom where it belongs. go forth and add your authorization data. periodt. 💅💖🧚

📦 where this page comes from