shishi_prompt_password(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

✨ NAME ✨

shishi_prompt_password — bestie, it's an API function 💖 (from the shishi manual, section 3, iykyk)

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_prompt_password(Shishi * handle, char ** s, const char *
format, ...);

🎀 ARGUMENTS 🎀

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). she's the main character, everything runs through her.
  • char ** s — pointer to a newly allocated output string, and inside that string lives the password you just read. fresh out the box, no cap 🫶
  • const char * format — a printf(3) style format string. yes, that kind of format string.
  • ... — the printf(3) style arguments that go with it. the little squad trailing behind the format string 💅

🦋 DESCRIPTION 🦋

okay so here's the vibe: this function formats and prints a prompt, then reads a password from the user. that's it, that's the whole thing ✨

and here's the lowkey important part — that password is possibly converted. like, converted from Latin-1 to UTF-8, or processed using a Stringprep profile, whatever the situation calls for. and this conversion follows any "stringprocess" keywords you've got hanging out in your configuration files. so if your config says something, this function is listening 👑

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's the green flag, the good ending, the slay 💚

💜 REPORTING BUGS 💜

found a bug? not the moment, but also pls tell someone. 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. (basically: keep the receipts, then do whatever 💖)

🌈 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 giving encyclopedia but make it iconic 🧚

and that's the whole page bestie — this was shishi_prompt_password(3) from shishi 1.0.3, and that's the version + source this came from, periodt 💅✨

📦 where this page comes from