shishi_ticket_set_enc_part(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_ticket_set_enc_part — bestie's guide to the shishi manual 💖

okay so listen, this is a page from the shishi manual (section 3, the library functions girlies 🫶) and we're about to make encrypted enc-part fields happen. no cap.

✨ NAME ✨

shishi_ticket_set_enc_part — an API function, and yes she's exactly as niche as she sounds 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_ticket_set_enc_part(Shishi * handle, Shishi_asn1 ticket,
int32_t etype, uint32_t kvno, const char * buf, size_t buflen);

like. look at those parameters. iconic.

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, bestie. you get one from shishi_init() and you do NOT just make one up, okay? that's the rules. 😭
  • Shishi_asn1 ticket — the Ticket you're adding the enc-part field to. she's getting a lil upgrade ✨
  • int32_t etype — the encryption type used to encrypt enc-part. which flavor of crypto we're vibing with.
  • uint32_t kvno — key version number. gotta know which key's turn it is 🔑
  • const char * buf — input array holding the encrypted enc-part. the goods. the payload. the moment. 💅
  • size_t buflen — size of that input array with the encrypted enc-part. because buf can't just be out here with no length, that's chaos. 🦋

💜 DESCRIPTION 💜

so what she does: she sets the encrypted enc-part field in the Ticket. that's it, that's the job, and she eats every time. 👑

and here's the tea on how that encrypted data usually gets made — you normally call shishi_encrypt() on the DER encoded enc-part. like, that's the pipeline.

but bestie, if you're in a rush (and who isn't, we're all busy), you may want to use shishi_ticket_add_enc_part() instead. she calculates the encrypted data and calls this function, all in one step. one step!! no extra work, main character energy, we love a two-for-one. 🌈

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. and if it's not SHISHI_OK? that's a vibe check failure, go read the error. 💀

🙈 REPORTING BUGS 🙈

found a bug? first of all, relatable. second of all, report it to <bug-shishi@gnu.org> — they wanna hear it fr fr.

GNU Shishi home page: http://www.gnu.org/software/shishi/

General help using GNU software: http://www.gnu.org/gethelp/

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. (that's the whole license vibe — no royalty, just keep the notice, periodt. 🎀)

🦋 SEE ALSO 🦋

the full documentation for shishi is maintained as a Texinfo manual, which is the fancy girl version of docs. if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. iykyk. 🧚

and that's the whole page, bestie — shishi 1.0.3, shishi_ticket_set_enc_part(3), slayed and delivered. go encrypt something cute. 💖✨🌸

📦 where this page comes from