Generic Security Services API Library Functions
                                     gssimportseccontext(3GS)



NAME
     gssimportseccontext - import security context established
     by another process

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

     OMuint32 gssimportseccontext(OMuint32 *minorstatus,
          const gssbuffert interprocesstoken,gssctxidt *contexthandle);


DESCRIPTION
     The gssimportseccontext() function allows  a  process  to
     import  a security context established by another process. A
     given interprocess token can  be  imported  only  once.  See
     gssexportseccontext(3GS).

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

     minorstatus          A mechanism-specific status code.


     interprocesstoken    Token received from exporting process.


     contexthandle        Context handle  of  newly  reactivated
                           context.   Resources  associated  with
                           this context handle must  be  released
                           by  the  application  after use with a
                           call to gssdeleteseccontext(3GS).


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

     GSCOMPLETE           Successful completion.


     GSNOCONTEXT         The token did not contain  a  valid
                              context reference.


     GSDEFECTIVETOKEN    The token was invalid.


     GSUNAVAILABLE        The operation is unavailable.




SunOS 5.11          Last change: 15 Jan 2003                    1






Generic Security Services API Library Functions
                                     gssimportseccontext(3GS)



     GSUNAUTHORIZED       Local policy prevents the import of
                              this  context  by  the current pro-
                              cess.


     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),        gsscontexttime(3GS),
     gssdeleteseccontext(3GS),  gssexportseccontext(3GS),
     gssinitseccontext(3GS),       gssinquirecontext(3GS),
     gssprocesscontexttoken(3GS),  gsswrapsizelimit(3GS),
     attributes(5)


     Solaris Security for Developers Guide














SunOS 5.11          Last change: 15 Jan 2003                    2






Generic Security Services API Library Functions
                                     gssimportseccontext(3GS)






















































SunOS 5.11          Last change: 15 Jan 2003                    3