xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_prompter_posix.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_prompter_posix -  Prompt user for password.
2=================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_prompter_posix(krb5_context context, void * data, const char * name, const char * banner, int num_prompts, krb5_prompt prompts)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **data** - Unused (callback argument)
16
17	          **[in]** **name** - Name to output during prompt
18
19	          **[in]** **banner** - Banner to output during prompt
20
21	          **[in]** **num_prompts** - Number of prompts in *prompts*
22
23	          **[in]** **prompts** - Array of prompts and replies
24
25
26..
27
28
29:retval:
30         -   0   Success
31
32
33:return:
34         -  Kerberos error codes
35
36..
37
38
39
40
41
42
43
44This function is intended to be used as a prompter callback for krb5_get_init_creds_password() or krb5_init_creds_init().
45
46
47
48Writes *name* and *banner* to stdout, each followed by a newline, then writes each prompt field in the *prompts* array, followed by":", and sets the reply field of the entry to a line of input read from stdin. If the hidden flag is set for a prompt, then terminal echoing is turned off when input is read.
49
50
51
52
53
54
55
56
57
58
59..
60
61
62
63
64
65