shishi_key_principal(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_key_principal — the manual page bestie 💖

okay so real talk, this is a page from the shishi manual, section 3 (that's the library-functions girlies, iykyk). her name is shishi_key_principal(3) and she's lowkey one of the most chill functions in the whole library. let's get into it ✨

🌸 NAME 🌸

shishi_key_principal — literally just an API function, that's her whole thing 💅

🦋 SYNOPSIS 🦋

#include <shishi.h>

const char * shishi_key_principal(const Shishi_key * key);

no cap, that's the entire signature. one function, one argument, one return. iconic behavior honestly 🎀

🍓 ARGUMENTS 🍓

  • const Shishi_key * key — bestie this is the structure that holds key information. that's it. that's the whole vibe. she just wants the key struct and she'll handle the rest 🫶

✨ DESCRIPTION ✨

okay so here's the tea ☕ — this function grabs the principal part of the key owner principal name. and when we say principal part, we mean everything except the realm.

so if the full principal name is giving user@REALM energy, this function hands you back the user part and lets the realm do its own thing. main character energy for the principal, side quest energy for the realm 💅

👑 RETURN VALUE 👑

she returns the principal owning the key.

⚠️ IMPORTANT BESTIE ⚠️ — this is NOT a copy of it. do not modify it. do not deallocate it. it's giving "borrowed pointer, look but don't touch" 😭 she's letting you see it, not keep it. hands off, fr fr.

😭 REPORTING BUGS 😭

found a bug? don't be shy, tell the shishi girlies directly:

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 basically: take it, share it, remix it, just keep the receipts bestie 💖)

🌟 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, it's the extended cut 🎬✨

and that's the whole page bestie!! 🦋 this lil number came straight out of shishi version 1.0.3 (yes, the version footer, we love her), and the manual page is shishi_key_principal(3). mwah, go forth and get those principals 💅💖🎀

📦 where this page comes from