gss_release_cred(3)gss_release_cred(3)NAMEgss_release_cred - Free resource associated with credential.
SYNOPSIS
#include <gssapi/gssapi.h>
OM_uint32 gss_release_cred(
OM_uint32 * minor_status,
gss_cred_id_t * cred_handle );
PARAMETERS
Kerberos 5 error code. Credentials being released. If GSS_C_NO_CREDEN‐
TIAL is specified, the function executes but does nothing. A value of
GSS_C_NO_CREDENTIALS is returned.
DESCRIPTION
The gss_release_cred() function informs the GSS-API that the specified
credentials handle is no longer required and frees associated
resources. The data structure housing a copy of the credentials within
the application's address space is released. Service table and creden‐
tials cache entries are left intact.
Before deciding when to release credentials, the application must
determine if it is going to be initiating or accepting security con‐
texts more than once during the application's execution. If so, the
application may want to retain credentials and reuse them later with
the initiate or accept security context functions, rather than releas‐
ing them immediately after the first use.
RETURN VALUES
GSS_S_CALL_INACCESSIBLE_READ 01xxxxxx
GSS_S_CALL_INACCESSIBLE_WRITE 02xxxxxx
GSS_S_COMPLETE 00000000
GSS_S_FAILURE xx0Dxxxx
GSS_S_NO_CRED xx07xxxx
SEE ALSO
Functions: gss_acquire_cred(3), gss_add_cred(3), gss_inquire_cred(3),
gss_inquire_cred_by_mech(3)gss_release_cred(3)