xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_auth_con_init.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_auth_con_init -  Create and initialize an authentication context.
2=======================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_auth_con_init(krb5_context context, krb5_auth_context * auth_context)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[out]** **auth_context** - Authentication context
16
17
18..
19
20
21:retval:
22         -   0   Success; otherwise - Kerberos error codes
23
24
25..
26
27
28
29
30
31
32
33This function creates an authentication context to hold configuration and state relevant to krb5 functions for authenticating principals and protecting messages once authentication has occurred.
34
35
36
37By default, flags for the context are set to enable the use of the replay cache (#KRB5_AUTH_CONTEXT_DO_TIME), but not sequence numbers. Use krb5_auth_con_setflags() to change the flags.
38
39
40
41The allocated *auth_context* must be freed with krb5_auth_con_free() when it is no longer needed.
42
43
44
45
46
47
48
49
50
51
52..
53
54
55
56
57
58