# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_tkt_creds_init - Create a context to get credentials from a KDC’s Ticket Granting Service.

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 - `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 `krb5_tkt_creds_step()` or synchronously with `krb5_tkt_creds_get()` . See also `krb5_get_credentials()` for synchronous use.

Use `krb5_tkt_creds_free()` to free ctx when it is no longer needed.

Note

New in 1.9