gss_process_context_token.3 (2010 09)

g
gss_process_context_token(3) gss_process_context_token(3)
NAME
gss_process_context_token() - process a context to the security service
SYNOPSIS
#include <gssapi.h>
OM_uint32 gss_process_context_token (
OM_uint32 *minor_status,
const gss_ctx_id_t *context_handle,
const gss_buffer_t input_token_buffer)
DESCRIPTION
The gss_process_context_token()
routine passes tokens generated by the
gss_delete_security_context()
routine to the security service.
Usually, tokens are associated with either the context establishment or with per-message security ser-
vices. If the tokens are associated with the context establishment, they are passed to the
gss_init_sec_context()
or gss_accept_sec_context()
routine. If the tokens are associ-
ated with the per-message security service, they are passed to the
gss_verify() or gss_unseal()
routine.
Tokens generated by the
gss_delete_security_context()
routine are passed by the
gss_process_context_token()
routine to the security service for processing.
Input Parameters
context_handle Specifies the context handle on which the security service processes the token.
input_token_buffer Specifies an opaque pointer to the first byte of the token to be processed.
Output Parameters
minor_status Returns a status code from the security mechanism.
STATUS CODES
The following status codes can be returned:
GSS_S_COMPLETE The routine was completed successfully.
GSS_S_DEFECTIVE_TOKEN
Consistency checks performed on the input_token parameter failed.
GSS_S_FAILURE The routine failed. See the minor_status parameter return value for more
information.
GSS_S_NO_CONTEXT The supplied context handle did not refer to a valid context.
AUTHOR
gss_process_context_token() was developed by Sun Microsystems, Inc.
SEE ALSO
gss_accept_sec_context(3), gss_delete_sec_context(3), gss_init_sec_context(3), gss_verify_mic(3),
gss_unseal(3).
The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages
add /opt/dce/share/man to MANPATH.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1