Index Index for
Section 3
Index Alphabetical
listing for G
Bottom of page Bottom of
page		 

gss_release_cred(3)


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

  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)

Index Index for
Section 3
Index Alphabetical
listing for G
Top of page Top of
page