shishi_safe_safe_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_safe_safe_der_set — the NAME section, bestie

okay so. bestie. this is shishi_safe_safe_der_set, a function from the shishi manual (section 3, the library-calls girlies ✨). it's an API function. that's the whole vibe of the name, no cap. 🎀

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_safe_safe_der_set(Shishi_safe * safe, char * der, size_t
derlen);

like. it takes three things and gives you back an int. iconic behavior honestly. 💅

🦋 ARGUMENTS 🦋

  • Shishi_safe * safe — this is the safe (the struct, not the adjective, i know 😭) and you gotta have allocated it already with shishi_safe(). don't just hand me a random pointer, bestie, i will simply pass away.
  • char * der — an input array holding a DER encoded KRB-SAFE. yes it's char *. yes it's DER. we contain multitudes. 🌈
  • size_t derlen — the length of that input array with the DER encoded KRB-SAFE. like, how many bytes. the count. the receipts. 👑

✨ DESCRIPTION ✨

so what it DOES. it DER decodes the KRB-SAFE, and then it sets it into the SAFE exchange. that's the whole job. ate, left no crumbs. 🍓

and here's the plot twist that matters, so listen up: if the decoding fails, the KRB-SAFE in the SAFE exchange remains — as in, it stays exactly how it was. no half-decoded mess, no drama. the original stays put. 🫶

💜 RETURN VALUE 💜

returns SHISHI_OK. that's it. that's the return value. short king behavior fr fr. 💀

😭 REPORTING BUGS 😭

found a bug? spill the tea 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.

(translation: share it, remix it, just keep the receipts bestie 🧚)

🌈 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. main character research arc. 📚

k bye, this was shishi version 1.0.3, documented in shishi_safe_safe_der_set(3) — mwah, stay decoded bestie 💖✨🎀🦋

📦 where this page comes from