shishi_tgs_req_der(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_tgs_req_der(3) — the shishi manual, bestie edition 💖

okay so real talk, this one lives in the shishi manual, section 3 (that's the "library functions, she's a coder" section, iykyk ✨). It's an API function, and honestly? She's giving "quiet overachiever who just does one thing perfectly." Obsessed. 🫶

🌸 NAME 🌸

shishi_tgs_req_der — yes babe, that's the whole name, she's an API function and she knows it 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_tgs_req_der(Shishi_tgs * tgs, char ** out, size_t * outlen);

look at her. three little params. no drama. 🌈

🎀 ARGUMENTS 🎀

  • Shishi_tgs * tgs — the structure that holds all the info about the TGS exchange. she's the main character of this story, fr fr.
  • char ** out — the output array, freshly allocated, holding the DER encoding of TGS-REQ. brand new, never used, she's got that new-array smell 🦋
  • size_t * outlen — the length of that output array with the DER encoding of TGS-REQ. because bestie, you gotta know how big she is before you go poking around 👑

💜 DESCRIPTION 💜

okay so the whole vibe here is: DER encode TGS-REQ. that's it, that's the job, she ate and left no crumbs 🔥

out is allocated by this function — like, she made it, she's responsible for bringing it into this world. And it is the responsibility of the caller to deallocate it. so like. you made the mess, you clean it up, no cap. 🧹💀

🚨 bestie listen: she hands you memory. She does NOT take it back. If you forget to free out, that's a leak and it's on you, not her. periodt.

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that "iff" is doing so much heavy lifting, it means if-and-only-if, so like, anything that isn't SHISHI_OK means girlie did NOT succeed, and you should probably check on that 🙈

😭 REPORTING BUGS 😭

found a bug? not me gaslighting you into thinking it's a feature — go tell the actual maintainers:

they're nice, they wanna hear from you, slay 💖

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: go off, share the file, just keep the receipts ✨🫶)

🌈 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.

like, if it's installed properly. if it's not, that's a you-and-your-install problem, bestie 😭

shishi 1.0.3 shishi_tgs_req_der(3) — that's the version, that's the page, that's the whole thing. mwah 💋 go free your out array and be iconic. 💅🌸💖

📦 where this page comes from