NAME    [Toc]    [Back]

       gss_release_cred  -  Free resource associated with credential.

SYNOPSIS    [Toc]    [Back]

       #include <gssapi/gssapi.h>

       OM_uint32 gss_release_cred(
               OM_uint32 * minor_status,
               gss_cred_id_t * cred_handle );

PARAMETERS    [Toc]    [Back]

       Kerberos 5 error code.   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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

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



                                              gss_release_cred(3)