gss_krb5_ccache_name()--Set Default Kerberos Protocol Credentials Cache Name
Syntax
#include <krb5.h> krb5_error_code gss_krb5_ccache_name ( OM_uint32 * minor_status, char * new_name, char ** old_name)Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
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
Message ID | Error Message Text |
---|---|
CPE3418 E | Possible APAR condition or hardware failure. |
CPFA081 E | Unable to set return value or error code. |
API introduced: V5R2
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]