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.