shishi_keys_add_keytab_mem(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_keys_add_keytab_mem 💖

okay bestie, welcome to the shishi manual, section 3, and today's main character is shishi_keys_add_keytab_mem(3). she's a lil API function and she's literally just here to slurp keys out of a memory buffer and drop them into your key set. no cap. 🎀

✨ NAME ✨

shishi_keys_add_keytab_mem — API function

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_keys_add_keytab_mem(Shishi * handle, const char * data,
       size_t len, Shishi_keys * keys);

🌸 ARGUMENTS 🌸

  • Shishi * handle — the shishi handle, bestie. the one you got from shishi_init(). she's the whole vibe.
  • const char * data — a constant memory buffer holding a keytab of len size. it's giving "raw bytes, don't touch".
  • size_t len — the size of that memory buffer with the keytab data. yes, the length. periodt.
  • Shishi_keys * keys — an allocated key set, and she's where the keys are gonna live. this is the destination, the home, the main character of the operation.

💅 DESCRIPTION 💅

So basically: this function reads keys from a MIT keytab data structure and adds them to the key set. that's it. that's the job. lowkey iconic. ✨

Now the tea: the format of keytabs is proprietary, and this function supports the 0x0501 and 0x0502 formats. only those two, okay? don't come at her with anything else.

If you wanna know how the format actually works under the hood, go read the section The MIT Kerberos Keytab Binary File Format in the Shishi manual — it's a whole description of the reverse-engineered format. iykyk. 🕵️♀️

🫶 RETURNS 🫶

  • Returns SHISHI_KEYTAB_ERROR if the data does not represent a valid keytab structure. (basically: if it's not a keytab, she's gonna say so. 😭)
  • Returns SHISHI_OK on success. slay. 💖

🙈 REPORTING BUGS 🙈

Found a bug? Not me manifesting that but okay — report bugs 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.

fr fr, just keep the notice. that's the whole ask. 🎀

🌈 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, bestie, it's good for you 💜

and that's the whole page, no notes. this was shishi version 1.0.3, and we out here on shishi_keys_add_keytab_mem(3). take care of her, she's doing her best. 💅✨🦋

📦 where this page comes from