File: krb5_read_password.txt

package info (click to toggle)
krb5 1.15-1%2Bdeb9u1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 54,220 kB
  • ctags: 32,381
  • sloc: ansic: 310,596; cpp: 16,220; exp: 13,350; python: 7,990; makefile: 7,223; sh: 6,185; perl: 3,518; asm: 1,460; yacc: 1,006; xml: 503; awk: 396; csh: 147; lisp: 104; sed: 43
file content (70 lines) | stat: -rw-r--r-- 1,467 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
krb5_read_password -  Read a password from keyboard input. 
===========================================================

..

.. c:function:: krb5_error_code krb5_read_password(krb5_context context, const char * prompt, const char * prompt2, char * return_pwd, unsigned int * size_return)

..


:param:

	          **[in]** **context** - Library context

	          **[in]** **prompt** - First user prompt when reading password

	          **[in]** **prompt2** - Second user prompt (NULL to prompt only once)

	          **[out]** **return_pwd** - Returned password

	          **[inout]** **size_return** - On input, maximum size of password; on output, size of password read


..


:retval:
         -   0   Success


:return:
         -  Error in reading or verifying the password Kerberos error codes 

..







This function reads a password from keyboard input and stores it in *return_pwd* . *size_return* should be set by the caller to the amount of storage space available in *return_pwd* ; on successful return, it will be set to the length of the password read.



 *prompt* is printed to the terminal, followed by":", and then a password is read from the keyboard.



If *prompt2* is NULL, the password is read only once. Otherwise, *prompt2* is printed to the terminal and a second password is read. If the two passwords entered are not identical, KRB5_LIBOS_BADPWDMATCH is returned.



Echoing is turned off when the password is read.










..