Generic Security Services API Library Functions
                                           gsscontexttime(3GS)



NAME
     gsscontexttime - determine how long a context will  remain
     valid

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

     OMuint32 gsscontexttime(OMuint32 *minorstatus,
          gssctxidt *contexthandle,OMuint32 *timerec);


DESCRIPTION
     The gsscontexttime() function  determines  the  number  of
     seconds for which the specified context will remain valid.

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

     minorstatus      A mechanism-specific status code.


     contexthandle    A read-only value. Identifies the  context
                       to be interrogated.


     timerec          Modifies the number of  seconds  that  the
                       context remains valid.  If the context has
                       already expired, returns zero.


ERORS
     The gsscontexttime() function returns one of the following
     status codes:

     GSCOMPLETE           Successful completion.


     GSCONTEXTEXPIRED    The context has already expired.


     GSNOCONTEXT         The  contexthandle  parameter  did
                              not identify 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



SunOS 5.11          Last change: 15 Jan 2003                    1






Generic Security Services API Library Functions
                                           gsscontexttime(3GS)



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


     Solaris Security for Developers Guide
























SunOS 5.11          Last change: 15 Jan 2003                    2






Generic Security Services API Library Functions
                                           gsscontexttime(3GS)






















































SunOS 5.11          Last change: 15 Jan 2003                    3