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
|
krb5_tkt_creds_init - Create a context to get credentials from a KDC's Ticket Granting Service.
=================================================================================================
..
.. c:function:: krb5_error_code krb5_tkt_creds_init(krb5_context context, krb5_ccache ccache, krb5_creds * creds, krb5_flags options, krb5_tkt_creds_context * ctx)
..
:param:
**[in]** **context** - Library context
**[in]** **ccache** - Credential cache handle
**[in]** **creds** - Input credentials
**[in]** **options** - :data:`KRB5_GC` options for this request.
**[out]** **ctx** - New TGS request context
..
:retval:
- 0 Success; otherwise - Kerberos error codes
..
This function prepares to obtain credentials matching *creds* , either by retrieving them from *ccache* or by making requests to ticket-granting services beginning with a ticket-granting ticket for the client principal's realm.
The resulting TGS acquisition context can be used asynchronously with :c:func:`krb5_tkt_creds_step()` or synchronously with :c:func:`krb5_tkt_creds_get()` . See also :c:func:`krb5_get_credentials()` for synchronous use.
Use :c:func:`krb5_tkt_creds_free()` to free *ctx* when it is no longer needed.
..
.. note::
New in 1.9
|