gss_krb5_ccache_name()--Set Default Kerberos Protocol Credentials Cache Name

 #include <krb5.h>

 krb5_error_code gss_krb5_ccache_name (
    OM_uint32 *                         minor_status,
    char *                              new_name,
    char **                             old_name)

The gss_krb5_ccache_name() routine sets the default credentials cache name for use by the Kerberos mechanism. The default credentials cache is used by gss_acquire_cred() to create a GSS-API credential. It is also used by gss_init_sec_context() when GSS_C_NO_CREDENTIAL is specified for the GSS-API credential used to establish the security context.

Parameters

minor_status  (Output)

Status code returned from the security mechanism.

new_name  (Input)

The new name for the default GSS-API Kerberos credentials cache.

old_name  (Output)

The name returned of the current default credentials cache or NULL if the default credentials cache has not been set. Specify NULL for this parameter if you do not need the current credentials cache name. The returned name should be released by calling krb5_free_string() when it is no longer needed.

Return Value

The return value is one of the following status codes:

GSS_S_COMPLETE

The routine completed successfully.

GSS_S_FAILURE

The routine failed for reasons which are not defined at the GSS level. The minor_status return parameter contains a mechanism-dependent error code describing the reason for the failure.

Authorities

None.

Error Messages

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]