shishi_priv_priv_der_set(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_priv_priv_der_set(3) — the "here's your DER, bestie" function 💖

okay so picture this: you're deep in the shishi manual (that's the GNU one, the Kerberos bestie), and you've stumbled onto a little function that hands a blob of DER-encoded KRB-PRIV over to your Shishi_priv struct. iconic behaviour, honestly. let's get into it 🫶

✨ NAME ✨

shishi_priv_priv_der_set — it's an API function, and it's giving "set the priv from DER" energy 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_priv_priv_der_set(Shishi_priv * priv, char * der, size_t
derlen);

🎀 ARGUMENTS 🎀

  • Shishi_priv * priv — your priv, as allocated by shishi_priv(). it's the whole point, bestie, don't pass a random one 💜
  • char * der — an input array holding a DER encoded KRB-PRIV. yes literally, that's the payload 🦋
  • size_t derlen — the length of that input array with the DER encoded KRB-PRIV. gotta tell it how many bytes, no cap ✨

🔥 DESCRIPTION 🔥

so what it does: it DER decodes the KRB-PRIV and sets it into the PRIV exchange. that's the whole vibe. 🌈

⚠️ real talk though — if the decoding fails, the KRB-PRIV that's already in the PRIV exchange stays there. it does not get wiped, it does not get replaced, it just chills. so don't go assuming a failed call left you with an empty struct, because it did NOT, and that's on periodt 💀

👑 RETURN VALUE 👑

returns SHISHI_OK. that's it. that's the return. slay 💖

🙈 REPORTING BUGS 🙈

found something cursed? report bugs to <bug-shishi@gnu.org> 🐛

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 lowkey a good time 📚

and that's the whole page, bestie!! this one's from shishi 1.0.3, section shishi_priv_priv_der_set(3) — go forth and set those DERs responsibly 🧚✨💖

📦 where this page comes from