shisa_key_remove(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 💖

shisa_key_remove — the API function that yeets a key out of the Shisa database, no cap 🗑️✨

This one lives in the shishi manual, section 3, bestie — it's the shisa_key_remove(3) page, and it's literally about deleting keys. Periodt.

✨ SYNOPSIS ✨

#include <shisa.h>

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

🎀 ARGUMENTS 🎀

  • Shisa * dbh — the Shisa library handle, and you gotta get it from shisa() first, okay? No handle, no vibes 🫶
  • const char * realm — the name of the realm that your principal belongs to. Like, which kingdom are they from 👑
  • const char * principal — the name of the principal whose key is getting removed. This is their key, and we're saying bye 💅
  • const Shisa_key * key — pointer to a Shisa_key structure stuffed with hints about what matching criteria to use when picking which key to grab 🔍

🌸 DESCRIPTION 🌸

So basically, this function removes a key from the Shisa database — the one that matches the hints sitting in key — for the user PRINCIPAL@REALM. 🦋

And here's the cute part: not every single element of key has to be filled in! Only the ones you actually need to locate that key uniquely. Minimal effort, maximum slay. ✨

For example — say you wanna remove the only key of etype 3, i.e., DES-CBC-MD5. Then you set the field key->etype to 3, and every other field to zero. That's it. That's the whole recipe. 🍓

💜 RETURN VALUE 💜

  • SHISA_OK — it worked, we ate, no crumbs 🔥
  • SHISA_NO_KEY — literally no key could be located 😭
  • SHISA_MULTIPLE_KEY_MATCH — more than one key matched the criteria you gave. Oops, too many matches, that's a whole situation 💀
  • or an error code otherwise — yeah, other stuff can go wrong too 🙈

🧚 REPORTING BUGS 🧚

Found a bug? Report it to <bug-shishi@gnu.org> — the devs wanna know, fr fr.

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.

⭐ 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. Go read it, iykyk 📚✨

okay that's the whole page, bestie — this was shisa_key_remove(3) from shishi version 1.0.3. go forth and remove keys responsibly 💖🎀🦋

📦 where this page comes from