shishi_kdcreq_till(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_kdcreq_till — the manual page, bestie edition 💖

okay so real quick, this is a page from the shishi manual (section 3, the library-functions girlies), and it's all about one lil function that snatches the "till" / endtime field out of a KDC-REQ. let's get into it 🦋

✨ NAME ✨

shishi_kdcreq_till — it's an API function, periodt. 💅

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_kdcreq_till(Shishi * handle, Shishi_asn1 kdcreq, char **
till, size_t * tilllen);

look at her. four arguments. she's serving signature realness 👑

✨ ARGUMENTS ✨

  • Shishi * handle — the Shishi library handle you got from shishi_init(). like, you literally cannot do anything without her. she's the main character. 🎀
  • Shishi_asn1 kdcreq — the KDC-REQ variable we're pulling the endtime out of. this is the thing we're snooping through, respectfully. 🔍
  • char ** till — a pointer to a freshly allocated, null-terminated string holding the "till" field as a generalized time. and no cap, you can pass this as NULL if you only wanna populate tilllen. lowkey efficient of you. ✨
  • size_t * tilllen — pointer to the length of till for output, and it does not count the terminating null. also if you set this one to NULL, then only till gets populated. pick your fighter, bestie 🫶

✨ DESCRIPTION ✨

so what she does is: get the "till" field — aka the "endtime" — in the KDC-REQ, and hand it back to you as a null-terminated string. 💜

the string is typically 15 characters long and it is allocated by this function. so heads up: it is your responsibility as the caller to deallocate it. don't leave her hanging, free your girl 😭

also important, don't skip this: the output length tilllen does not include the terminating zero. okay? okay. 🧚

✨ RETURN VALUE ✨

returns SHISHI_OK iff successful. that's the vibe check. if it's SHISHI_OK, we ate. 🔥

✨ REPORTING BUGS ✨

found a bug? don't be shy, tell the devs! report bugs to <bug-shishi@gnu.org>.

they literally 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. iconic, generous, we love to see it 👑

✨ 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, this command

info shishi

should give you access to the complete manual. go read her, she's worth it 📖✨

and that's the whole page, bestie!! 💖 this was from the shishi manual, version 1.0.3, and yeah the page is literally called shishi_kdcreq_till(3). now go free that string you allocated. i'm so serious. 🎀🦋💅

📦 where this page comes from