gss_delete_sec_context(3)gss_delete_sec_context(3)NAMEgss_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
Kerberos 5 error code. Security context to be deleted. After the con‐
text is deleted, this parameter is set to GSS_C_NO_CONTEXT. 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)gss_delete_sec_context(3)