shishi_ap(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

💖 NAME 💖

okay bestie, gather round, because this is shishi_ap — an API function from the shishi manual (section 3, the library-call girlies, iykyk). she's the one who sets up your whole AP exchange moment. periodt.

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_ap(Shishi * handle, Shishi_ap ** ap);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, and like, you get one from shishi_init(). that's the only way to get one, no shortcuts fr.
  • Shishi_ap ** ap — a pointer to the brand-new structure that holds all the info about the AP exchange. she's a pointer-to-pointer, she's a little extra, we love her for it 💅

🦋 DESCRIPTION 🦋

okay so this creates a new AP exchange, and it comes with a random subkey using the default encryption type from configuration. cute, right? 🌸

but hold up, bestie, because here's the thing — there is no guarantee that the receiver will understand that key type. like, none. zero. she might just not get it. so you should probably use shishi_ap_etype() or shishi_ap_nosubkey() instead. do yourself a favor, okay? 🙈

and the tea on the future: this function will likely behave as shishi_ap_nosubkey(), and shishi_ap_nosubkey() will be removed. so like, the plot is plotting. keep that in mind 👑

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's it, that's the whole vibe check. if it's SHISHI_OK, you ate. 🔥

😭 REPORTING BUGS 😭

found a bug? don't be shy, report it 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. so like, go off, 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. that's the whole lore, bestie, go read it 📖✨

and that's the page!! brought to you by shishi version 1.0.3, living in the shishi_ap(3) era 🎀💖 slay, stay curious, and remember: SHISHI_OK only, no cap 💅✨

📦 where this page comes from