shishi_key_principal_set(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_set(3) 💖

okay bestie, welcome to section 3 of the shishi manual — this one's a tiny little function but it's lowkey carrying the whole "whose key is this anyway" situation, and honestly? iconic. 🎀

✨ NAME ✨

shishi_key_principal_set — an API function, and yes that's literally its whole job description, she's humble like that 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

void shishi_key_principal_set(Shishi_key * key, const char * principal);

look at her. two args, returns nothing, no drama. main character energy fr fr ✨

🦋 ARGUMENTS 🦋

  • Shishi_key * key — the structure that holds key information. she's the one getting a new label, she's the moment 💜
  • const char * principal — a string with the new principal name. this is what's being written in, the glow-up in text form 🫶

💫 DESCRIPTION 💫

so basically, this function sets the principal that owns the key. like, assigning the key its person. the string is copied into the key, which is the important part bestie — that means you can dispose of the variable immediately after calling this function. no waiting, no keeping it around, no "just in case" hoarding. you call it, you free your thing, you move on. periodt. 💅

ngl that copy behaviour is the whole vibe check of this function and she passed 🌈

😭 REPORTING BUGS 😭

found something cursed? not me gatekeeping — report bugs to <bug-shishi@gnu.org>.

go tell them, they 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. that's it, that's the permission slip, and honestly it ate 💖

🌈 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 your one-stop shop for the entire lore, iykyk 🧚

okay that's the whole page, love you, bye — this was shishi version 1.0.3, shishi_key_principal_set(3), delivered to you with zero context switches and maximum sparkle ⭐💖🌸

📦 where this page comes from