shishi_encprivpart_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_encprivpart_user_data — a whole API function, bestie ✨

shishi manual, section 3 (that's the library-call girlies 🫶). Okay so listen, this one is genuinely useful and also very "why is memory management like this" energy, so let's get into it.

🌸 NAME 🌸

shishi_encprivpart_user_data — it's an API function, babes. That's the whole name. Iconic of it to be that straightforward. 💅

🎀 SYNOPSIS 🎀

#include <shishi.h>

int shishi_encprivpart_user_data(Shishi * handle, Shishi_asn1
encprivpart, char ** userdata, size_t * userdatalen);

Look at her. Four parameters, one int return, zero chill. 🌈

🦋 ARGUMENTS 🦋

  • Shishi * handle — the shishi handle, and you gotta get it the way you're supposed to: as allocated by shishi_init(). No freelancing. 💜
  • Shishi_asn1 encprivpart — the encprivpart, and bestie it has to come from shishi_priv(). That's the vibe check: if it wasn't allocated by shishi_priv(), we are not doing this. 🙈
  • char ** userdata — output array with the newly allocated user data from KRB-PRIV. Yes, newly allocated, we'll get to that. 😭
  • size_t * userdatalen — output size of the output user data buffer. She's telling you how big the thing is. 📏

✨ DESCRIPTION ✨

So the actual assignment here: read the user data value from KRB-PRIV. That's it, that's the job. 💖

Now here's the part you cannot skim, and I'm saying this with love:

userdata is allocated by this function, and it is the responsibility of the caller to deallocate it.

Not me handing you a freshly allocated buffer and then walking away like a main character. That's literally the deal though. She mallocs, you free. Teamwork. 🤝

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. Iff, bestie. Iff. That's the fancy math-girl "if and only if." Anything else and something went sideways. 💀

🔥 REPORTING BUGS 🔥

Found a bug? First of all, valid. Report it to <bug-shishi@gnu.org>.

Go off, tell them everything. They want to know. 🫶

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. (Translation: take it, share it, just keep the receipts attached. Respect the author, periodt. 🌸)

🌈 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 the whole thing, it's giving comprehensive. 📚✨

And that's the page, babe — from the shishi squad, version 1.0.3, dated with the shishi_encprivpart_user_data(3) energy we all know and love. Now go free that userdata buffer before I find out you didn't. 💅🎀🦋

📦 where this page comes from