shishi_kdcreq_renew_p(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_renew_p 💖

okay bestie, welcome to the shishi_kdcreq_renew_p(3) page — yes that's the whole manual name, section 3, we're in the library functions section, it's giving very technical, very demure. sit down, hydrate, let's go. ✨

🌸 NAME 🌸

shishi_kdcreq_renew_p — it's an API function, bestie. that's the whole job description. 💅

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_kdcreq_renew_p(Shishi * handle, Shishi_asn1 kdcreq);

🎀 ARGUMENTS 🎀

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). it's literally the passport for everything you do here, no handle no vibes. 🛂
  • Shishi_asn1 kdcreq — the KDC-REQ variable we're pulling the kdc-options field out of. this is the thing we're interrogating. 🔍

✨ DESCRIPTION ✨

so what this function actually does: it determines whether the KDC-Option renew flag is set. yes. that's it. one job, and it ate. 👑

now the lore: this option is used only by the ticket-granting service. so like, not everybody gets to use it, it's exclusive, it's invite-only. 💅

the RENEW option indicates that the present request is a request for a renewal. the ticket you hand over is encrypted in the secret key for the server on which it is valid. classic.

and here's the catch, bestie, listen closely because this part is a real vibe check: 🚨

this option will only be honored if the ticket to be renewed has its RENEWABLE flag set and the time in its renew-till field has not passed. no flag, no renewal. expired window, no renewal. periodt.

the ticket to be renewed is passed in the padata field as part of the authentication header. that's where it lives. that's where you put it. 🫶

⭐ RETURN VALUE ⭐

returns non-0 iff the renew flag is set in KDC-REQ. so like, truthy = yes bestie the flag is set, 0 = nope, not set. that's the whole answer. 🌈

😭 REPORTING BUGS 😭

found a bug? not you being the main character of QA, we love that. 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. iconic behaviour honestly, we stan a permissive license. 🎀

🧚 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. iykyk. 💜

and that's the page, bestie!! shishi version 1.0.3, page shishi_kdcreq_renew_p(3), and yeah this was the shishi manual all along. go forth and renew responsibly. 💅✨🦋

📦 where this page comes from