gss_krb5_copy_ccache()--Copy Tickets From Associated GSS Credentials to Kerberos Protocol Credentials Cache

Syntax

 #include <krb5.h>

 krb5_error_code gss_krb5_copy_ccache (
    OM_uint32 *                         minor_status,
    gss_cred_id_t                       cred_handle,
    krb5_ccache                         ccache)

  Service Program Name: QSYS/QKRBGSS

  Default public authority: *USE

  Threadsafe: Yes

The gss_krb5_copy_ccache() routine will copy the tickets from the Kerberos credentials cache associated with a GSS-API credential to a credentials cache provided by the caller. The supplied Kerberos credentials cache must have been initialized by krb5_cc_initialize() before calling gss_krb5_copy_ccache(). The GSS-API credential must have been created by specifying GSS_C_INITIATE or GSS_C_BOTH.

Parameters

minor_status (Output): Status code returned from the security mechanism.
cred_handle (Input): The GSS-API credential handle. This must be a GSS_C_INITIATE or GSS_C_BOTH credential.
ccache (Input): The Kerberos credentials cache.

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.
GSS_S_NO_CRED: The credential handle does not refer to a valid GSS-API credential.

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 ]