---
name: "shishi_prompt_password_callback_set"
section: "3"
platform: "linux"
package: "shishi-doc"
version: "1.0.3-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/shishi_prompt_password_callback_set"
---

# shishi\_prompt\_password\_callback\_set(3)

API function

## NAME

shishi\_prompt\_password\_callback\_set - API function

## SYNOPSIS

**#include \<shishi.h\>**

**void shishi\_prompt\_password\_callback\_set(Shishi \*** *handle***, shishi\_prompt\_password\_func** *cb***);**

## ARGUMENTS

- Shishi \* handle

  shishi handle as allocated by **shishi\_init()**.

- shishi\_prompt\_password\_func cb

  function pointer to application password callback, a **shishi\_prompt\_password\_func** type.

## DESCRIPTION

Set a callback function that will be used by **shishi\_prompt\_password()** to query the user for a password.  The function pointer can be retrieved using **shishi\_prompt\_password\_callback\_get()**.

The *cb* function should follow the **shishi\_prompt\_password\_func** prototype:

int prompt\_password (Shishi \* *handle*, char \*\**s*, const char \**format*, va\_list *ap*);

If the function returns 0, the *s* variable should contain a newly allocated string with the password read from the user.

## REPORTING BUGS

Report bugs 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.

## 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.