shishi_prompt_...rd_callback_set(3)

💖 shishi_prompt_password_callback_set — the shishi manual, bestie edition 💖

okay so real talk, this page lives in the shishi manual, and it's all about one lil API function that lets you take over the password-asking duties. let's get into it ✨

---

🌸 NAME 🌸

shishi_prompt_password_callback_set — it's an API function, bestie. that's the whole vibe.

---

🎀 SYNOPSIS 🎀

#include <shishi.h>

void shishi_prompt_password_callback_set(Shishi * handle,
shishi_prompt_password_func cb);

look at her. iconic. two args, returns nothing, just does her thing 💅

---

🦋 ARGUMENTS 🦋

• Shishi * handle — this is your shishi handle, and no you can't just make one up out of thin air. it's allocated by shishi_init(), okay? that's the origin story.
• shishi_prompt_password_func cb — a function pointer to your application's password callback. the type is literally shishi_prompt_password_func. it's giving "bring your own function" energy fr fr.

---

✨ DESCRIPTION ✨

so here's the tea ☕ — you call this to set a callback function that shishi_prompt_password() will use to go ask the user for a password. like, instead of shishi doing the asking itself, it hands the mic to your function. main character energy, honestly 👑

and if you ever need to grab that function pointer back? shishi_prompt_password_callback_get() has you covered. it's right there, iykyk.

your cb function needs to follow the shishi_prompt_password_func prototype, and it looks exactly like this:

int prompt_password (Shishi * handle, char **s, const char *format,
va_list ap);

now listen closely because this part matters 🫶 — if the function returns 0, then the s variable should contain a newly allocated string holding the password that was read from the user. no cap, that's the contract. don't fumble it.

---

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, bestie. report it to <bug-shishi@gnu.org>. 💌

• GNU Shishi home page: http://www.gnu.org/software/shishi/
• General help using GNU software: http://www.gnu.org/gethelp/

---

👑 COPYRIGHT 👑

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 like, go forth and share, just keep the receipts okay? 🎀

---

🌈 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. go read it, it's the director's cut 💜

---

and that's the whole page, bestie!! this was shishi version 1.0.3, straight from the shishi manual (section 3, the library-function girlies 💅). now go set that callback and slay ✨🦋🌸