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

SEE ALSO

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