SHISHI_AP_SET_TKTOPTIONSASN1USAGE(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_ap_set_tktoptionsasn1usage — a whole vibe 💖

okay bestie, we're in the shishi manual (yes, that shishi, the GNU one, section 3, the library-calls girlies) and today's main character is shishi_ap_set_tktoptionsasn1usage(3). she's an API function. she sets ticket options and does ASN.1 stuff. multi-talented. no cap.

✨ NAME ✨

shishi_ap_set_tktoptionsasn1usage — literally just "API function". that's it. that's the whole name section. she doesn't need a long bio, she's booked and busy.

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_ap_set_tktoptionsasn1usage(Shishi_ap * ap, Shishi_tkt * tkt,
int options, Shishi_asn1 node, const char * field, int
authenticatorcksumkeyusage, int authenticatorkeyusage);

seven arguments. SEVEN. she's giving main character energy and honestly? ate. 💅

🎀 ARGUMENTS 🎀

the whole friend group, one by one:

  • Shishi_ap * ap — the structure that holds all the info about the AP exchange. this is like, the group chat itself.
  • Shishi_tkt * tkt — the ticket to set in AP. yes queen, insert yourself.
  • int options — the AP-REQ options to set in AP. the little switches, the settings, the preferences.
  • Shishi_asn1 node — an input ASN.1 structure, which gets stored as the authenticator checksum data. she's the payload, she's the moment.
  • const char * field — the field inside that ASN.1 structure that we're actually using. not the whole structure, bestie, just the field. iykyk.
  • int authenticatorcksumkeyusage — the key usage for the checksum in the authenticator. (say that five times fast. i'll wait.)
  • int authenticatorkeyusage — the key usage for the authenticator itself. different thing. don't mix them up. fr fr.

🦋 DESCRIPTION 🦋

so what does she actually do? she sets the ticket, the options, and the authenticator checksum data — and she does it by using shishi_ap_set_tktoptionsdata(). iconic delegation, love that for her.

and the authenticator checksum data? it's the DER encoding of the ASN.1 field you handed her. so whatever field you point at, she's DER-encoding it and tucking it in as checksum data. cute, precise, done.

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. that's the good one. that's the "she slayed" signal. 🌈

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, tell the devs:

they want to know. bugs are not a personality trait, they're a to-do list. 🫶

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. respect the copyright notice and this notice. periodt. 💖)

🔥 SEE ALSO 🔥

the full documentation for shishi lives in a Texinfo manual. if the info pages and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. go read the whole thing, it's giving ✨ comprehensive ✨

and that's the page!! written against shishi version 1.0.3, and if you ever forget which page you're on, it's shishi_ap_set_tktoptionsasn1usage(3) — she's in section 3, she's an API function, and she ate. bye bestie, go set some tkt options 🦋💅✨

📦 where this page comes from