shishi_principal_default_guess(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_principal_default_guess ✨

okay bestie, so this one lives in the shishi family of manual pages, section 3, and it's an API function — aka a lil helper you call from your own code. it's giving "who even am I" but for principals. let's get into it 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

char * shishi_principal_default_guess();

no arguments, no drama. she takes nothing and gives you a string. iconic behavior honestly.

🦋 DESCRIPTION 🦋

so this function guesses the principal name for the user. and the way she does it? she goes snooping through your environment variables, in this order:

  • SHISHI_USER
  • USER
  • LOGNAME

she checks those, one by one, looking for a name to vibe with. and if all of that fails — like, every single one of them is a no-show — she just shrugs and returns the literal string:

"user"

periodt. that's the fallback. that's her last resort. not me relating to a fallback string 😭

💖 RETURN VALUE 💖

she returns the guessed default principal for the user, as a string. and bestie, listen — this string is yours now. it's not borrowed, it's not on loan, you have to deallocate it yourself by calling free() on it. if you don't? that's a memory leak, and leaks are not the vibe. free your strings, queen 👑

🎀 REPORTING BUGS 🎀

found a bug? don't suffer in silence, tell the people:

Copyright © 2002-2022 Simon Josefsson.

and the legal tea: 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 go forth and redistribute, just keep the receipts 💜

🌈 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, this command:

info shishi

should give you access to the complete manual. iykyk 🧚

and that's the whole page, bestie!! this one's from shishi version 1.0.3, and it's the shishi_principal_default_guess(3) page — thanks for reading the whole thing, you ate that fr fr 🫶✨💖

📦 where this page comes from