Generic Security Services API Library Functions
                                  gssprocesscontexttoken(3GS)



NAME
     gssprocesscontexttoken - pass asynchronous token to secu-
     rity service

SYNOPSIS
     cc [ flag... ] file... -lgss  [ library... ]
     #include 

     OMuint32 gssprocesscontexttoken(OMuint32 *minorstatus,
          const gssctxidt contexthandle,const gssbuffert tokenbuffer);


DESCRIPTION
     The gssprocesscontexttoken() function provides a  way  to
     pass  an  asynchronous  token  to the security service. Most
     context-level tokens are emitted and processed synchronously
     by  gssinitseccontext() and gssacceptseccontext(), and
     the application is informed as to whether further tokens are
     expected  by  the  GSCONTINUENEDED  major  status bit.
     Occasionally, a mechanism might 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
     gssinitseccontext()  may emit a token and return a status
     of   GSCOMPLETE,   but   the    acceptor's    call    to
     gssacceptseccontext()  might fail. The acceptor's mechan-
     ism might want to send a token containing an  error  indica-
     tion  to the initiator, but the initiator is not expecting a
     token at this point, believing that  the  context  is  fully
     established.  gssprocesscontexttoken()  provides a way to
     pass such a token to the mechanism at any time.


     This function is provided for compatibility with the GS-API
     version   1.   Because  gssdeleteseccontext()  no  longer
     returns   a   valid   outputtoken    to    be    sent    to
     gssprocesscontexttoken(), applications using a newer ver-
     sion of the GS-API do not need to rely on this function.

PARAMETERS
     The parameter descriptions  for  gssprocesscontexttoken()
     are as follows:

     minorstatus      A mechanism-specific status code.


     contexthandle    Context handle of context on  which  token
                       is to be processed.


     tokenbuffer      Token to process.




SunOS 5.11          Last change: 15 Jan 2003                    1






Generic Security Services API Library Functions
                                  gssprocesscontexttoken(3GS)



ERORS
     gssprocesscontexttoken() returns  one  of  the  following
     status codes:

     GSCOMPLETE           Successful completion.


     GSDEFECTIVETOKEN    Indicates that  consistency  checks
                              performed on the token failed.


     GSNOCONTEXT         The contexthandle did not refer to
                              a valid context.


     GSFAILURE            The underlying  mechanism  detected
                              an  error for which no specific GS
                              status  code   is   defined.    The
                              mechanism-specific    status   code
                              reported   by    means    of    the
                              minorstatus  parameter details the
                              error condition.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgss (32-bit)            
    
                                  SUNWgssx (64-bit)           
    
     MT Level                     Safe                        
    


SEE ALSO
     gssacceptseccontext(3GS),  gssdeleteseccontext(3GS),
     gssinitseccontext(3GS), attributes(5)


     Solaris Security for Developers Guide







SunOS 5.11          Last change: 15 Jan 2003                    2






Generic Security Services API Library Functions
                                  gssprocesscontexttoken(3GS)






















































SunOS 5.11          Last change: 15 Jan 2003                    3