NAME¶
gss_process_context_token - API function
SYNOPSIS¶
#include <gss.h>
OM_uint32 gss_process_context_token(OM_uint32 * minor_status,
const gss_ctx_id_t context_handle, const gss_buffer_t
token_buffer);
ARGUMENTS¶
- OM_uint32 * minor_status
- (Integer, modify) Implementation specific status code.
- const gss_ctx_id_t context_handle
- (gss_ctx_id_t, read) Context handle of context on
which token is to be processed
- const gss_buffer_t token_buffer
- (buffer, opaque, read) Token to process.
DESCRIPTION¶
Provides a way to pass an asynchronous token to the security service. Most
context-level tokens are emitted and processed synchronously by
gss_init_sec_context and gss_accept_sec_context, and the application is
informed as to whether further tokens are expected by the
GSS_C_CONTINUE_NEEDED major status bit. Occasionally, a mechanism may need to
emit a context-level token at a point when the peer entity is not expecting a
token. For example, the initiator's final call to gss_init_sec_context may
emit a token and return a status of GSS_S_COMPLETE, but the acceptor's call to
gss_accept_sec_context may fail. The acceptor's mechanism may wish to send a
token containing an error indication to the initiator, but the initiator is
not expecting a token at this point, believing that the context is fully
established. Gss_process_context_token provides a way to pass such a token to
the mechanism at any time.
RETURN VALUE¶
`GSS_S_COMPLETE`: Successful completion.
`GSS_S_DEFECTIVE_TOKEN`: Indicates that consistency checks performed on the
token failed.
`GSS_S_NO_CONTEXT`: The context_handle did not refer to a valid context.
REPORTING BUGS¶
Report bugs to <bug-gss@gnu.org>. GNU Generic Security Service home page:
http://www.gnu.org/software/gss/ General help using GNU software:
http://www.gnu.org/gethelp/
COPYRIGHT¶
Copyright © 2003-2013 Simon Josefsson.
Copying and distribution of this file, with or without modification, are
permitted in any medium without royalty provided the copyright notice and this
notice are preserved.
SEE ALSO¶
The full documentation for
gss is maintained as a Texinfo manual. If the
info and
gss programs are properly installed at your site, the
command
- info gss
should give you access to the complete manual.