shishi_safe_user_data(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_safe_user_data — the glow-up edition 💖

okay bestie, so this is a page from the shishi manual, section 3 (that's the library-functions girlies, iykyk). It's called shishi_safe_user_data and it's literally here to pull the user data out of a KRB-SAFE. No cap. ✨

🌸 NAME 🌸

shishi_safe_user_data — it's an API function, babes. That's the whole vibe. 👑

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_safe_user_data(Shishi * handle, Shishi_asn1 safe, char **
userdata, size_t * userdatalen);

yes, the line break in the middle of the declaration is real, we don't make the rules 💅

🎀 ARGUMENTS 🎀

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). She's the main character, everything runs through her 🫶
  • Shishi_asn1 safe — the safe, allocated by shishi_safe(). This is the little KRB-SAFE container we're snooping in 🧚
  • char ** userdata — output array, and it gets a newly allocated user data from the KRB-SAFE dropped into it. Fresh out the oven, no cap 🍓
  • size_t * userdatalen — output size of the output user data buffer. Basically "how big is the thing we just handed you" 📏

🦋 DESCRIPTION 🦋

So what she does: she reads the user data value out of the KRB-SAFE. Simple, iconic, no notes. 💜

lowkey important though — userdata is allocated by this function, which means it is the responsibility of the caller to deallocate it. Not me, not shishi, not the vibes. You. Free it or it's a leak bestie 😭

🌈 RETURN VALUE 🌈

Returns SHISHI_OK iff successful. Like, if it worked. If it didn't... it won't be SHISHI_OK. That's the whole system 🎀

🙈 REPORTING BUGS 🙈

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

they want to hear from you fr fr 🫶

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, very generous 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 it, it's giving ✨

mwah 💋 that's the whole page. this was shishi version 1.0.3, and the page itself is shishi_safe_user_data(3) — take care of your userdata and she'll take care of you. bye bestie, drink water 🌸

📦 where this page comes from