xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_init_creds_init.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_init_creds_init -  Create a context for acquiring initial credentials.
2============================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_init_creds_init(krb5_context context, krb5_principal client, krb5_prompter_fct prompter, void * data, krb5_deltat start_time, krb5_get_init_creds_opt * options, krb5_init_creds_context * ctx)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **client** - Client principal to get initial creds for
16
17	          **[in]** **prompter** - Prompter callback
18
19	          **[in]** **data** - Prompter callback argument
20
21	          **[in]** **start_time** - Time when credentials become valid (0 for now)
22
23	          **[in]** **options** - Options structure (NULL for default)
24
25	          **[out]** **ctx** - New initial credentials context
26
27
28..
29
30
31:retval:
32         -   0   Success; otherwise - Kerberos error codes
33
34
35..
36
37
38
39
40
41
42
43This function creates a new context for acquiring initial credentials. Use krb5_init_creds_free() to free *ctx* when it is no longer needed.
44
45
46
47Any subsequent calls to krb5_init_creds_step(), krb5_init_creds_get(), or krb5_init_creds_free() for this initial credentials context must use the same *context* argument as the one passed to this function.
48
49
50
51
52
53
54
55
56
57
58..
59
60
61
62
63
64