NAME

gss_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

minor_status
Kerberos 5 error code.

cred_handle
Credentials being released. If GSS_C_NO_CREDENTIAL 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 credentials 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 contexts 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 releasing them immediately after the first use. 

RETURN VALUES

SEE ALSO

Functions:  gss_acquire_cred(3), gss_add_cred(3), gss_inquire_cred(3), gss_inquire_cred_by_mech(3)