Index for Section 3

Alphabetical listing for G

Bottom of page

gss_delete_sec_context(3)
NAME
  gss_delete_sec_context - Release a security context.

SYNOPSIS
  #include <gssapi/gssapi.h>

  OM_uint32 gss_delete_sec_context(
	  OM_uint32 * minor_status,
	  gss_ctx_id_t * context_handle,
	  gss_buffer_t output_token );

PARAMETERS
  minor_status
	  Kerberos 5 error code.

  context_handle
	  Security context to be deleted. After the context is deleted, this
	  parameter is set to GSS_C_NO_CONTEXT.

  output_token
	  Token to be sent to the peer application, instructing it to delete
	  the security context.

	  Specify GSS_C_NO_BUFFER to request local deletion only. Output
	  tokens are provided for Verson 1 compatibility.

DESCRIPTION
  The gss_delete_sec_context() function releases a security context. The
  security context is then unusable for further message protection.

  Local data structures associated with the security context are released.  A
  delete token may be generated. The purpose of the delete token is to tell
  the remote peer application to delete its security context.

				     Note

       This function removes the memory associated with the security context,
       but it does not delete any credentials stored in the cache.

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_CONTEXT		  xx08xxxx

SEE ALSO
  Functions:  gss_accept_sec_context(3), gss_import_sec_context(3),
  gss_init_sec_context(3), gss_process_context_token(3)

Index for Section 3

Alphabetical listing for G

Top of page