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

💖 shisa_key_add — the shishi manual, bestie edition 💖

okay so welcome to the shisa_key_add(3) page, part of the shishi family of man pages 🦋 pull up a chair, we're adding keys today and it's gonna be iconic.

✨ NAME ✨

shisa_key_add — literally just an API function, that's the whole name, no notes 💅

🌸 SYNOPSIS 🌸

#include <shisa.h>

int shisa_key_add(Shisa * dbh, const char * realm, const char *
principal, const Shisa_key * key);

yes bestie, that's the signature, copy it exactly, don't freestyle it 🙈

🎀 ARGUMENTS 🎀

  • Shisa * dbh — the Shisa library handle, and you get it from shisa(). it's giving "your all-access pass to the database" energy 👑
  • const char * realm — the name of the realm the principal lives in. where they belong, their little home realm 🏠
  • const char * principal — the name of the principal you're adding a brand new key for 🗝️
  • const Shisa_key * key — a pointer to a Shisa_key structure holding the new key. yes it's a pointer, yes you need it 🫶

💜 DESCRIPTION 💜

so what this does is: it adds a complete key, key, to the database entry that belongs to the principal PRINCIPAL@REALM — and that principal is set by principal and realm. that's it. that's the whole vibe. key goes in, database entry gets a glow-up ✨

🌈 RETURN VALUE 🌈

returns SHISA_OK if it worked, or an error code if it did not. that's the whole deal, no cap 💀

🍓 REPORTING BUGS 🍓

found a bug? don't suffer in silence, bestie, 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.

(yes, that means you can share it, just keep the notice. slay, ethically ✨)

🔥 SEE ALSO 🔥

the full documentation for shishi is maintained as a Texinfo manual 📚 and 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 page, bestie!! this was shishi version 1.0.3, page shisa_key_add(3), and it's been a whole journey. go add those keys. periodt. 🎀💖🦋

📦 where this page comes from