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

okay bestie, so this is a page from the shishi manual — specifically the shishi_principal_default(3) one, aka the "who even am I" function. it's giving very ✨identity crisis but make it API✨. let's get into it 🫶

🌸 NAME 🌸

shishi_principal_default — an API function, and honestly? a lil icon. it tells you your default principal name. that's it, that's the whole gig 💅

🦋 SYNOPSIS 🦋

#include <shishi.h>

const char * shishi_principal_default(Shishi * handle);

look at her. one arg. returns a const char *. no drama, no cap. 😌

🎀 ARGUMENTS 🎀

  • Shishi * handle — the Shishi library handle, and you gotta make it with shishi_init(). no handle, no vibes. periodt.

✨ DESCRIPTION ✨

so here's the tea 🍓 — the default principal name is the name that lives in the environment variable USER, or LOGNAME on some systems (iykyk, different systems do different things, it's not that deep).

BUT 🚨 you can override the whole thing by setting the environment variable SHISHI_USER. yes bestie, you have main character energy and you get to pick your own name. the environment variable said "not me being customizable" 💅

👑 RETURN VALUE 👑

it returns the default principal name that the library uses.

⚠️ IMPORTANT, and I mean this with my whole chest — it is NOT a copy of it. so do not modify it and do not deallocate it. that's not your string, bestie, that's the library's string. hands off 🙈

😭 REPORTING BUGS 😭

found a bug? first of all, oof. second of all, report it to <bug-shishi@gnu.org>. they wanna hear about it 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. slay, honestly. that's a generous license and we love to see it 💜

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

info shishi

should give you access to the complete manual. go read it, it's lowkey a whole vibe 📚✨

and that's the page!! version 1.0.3 of shishi, mwah 💋 go forth and know thy principal name, bestie 🧚‍♀️🎀

📦 where this page comes from