Generic Security Services API Library Functions
                                     gssdeleteseccontext(3GS)



NAME
     gssdeleteseccontext - delete a GS-API security context

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

     OMuint32 gssdeleteseccontext(OMuint32 *minorstatus,
          gssctxidt *contexthandle,gssbuffert outputtoken);


DESCRIPTION
     Use the gssdeleteseccontext() function to delete a  secu-
     rity  context.   The  gssdeleteseccontext() function will
     delete the local data structures associated with the  speci-
     fied  security context.  You may not obtain further security
     services that use the context specified by contexthandle.


     In  addition  to  deleting  established  security  contexts,
     gssdeleteseccontext() will delete any half-built security
     contexts that result from incomplete sequences of  calls  to
     gssinitseccontext(3GS)                               and
     gssacceptseccontext(3GS).


     The  Solaris  implementation  of  the  GS-API  retains  the
     outputtoken  parameter  for compatibility with version 1 of
     the  GS-API.   Both   peer   applications   should   invoke
     gssdeleteseccontext(),  passing the value GSCNOBUFER
     to the outputtoken parameter; this indicates that no  token
     is  required.   If  the application passes a valid buffer to
     gssdeleteseccontext(),  it  will  return  a   zero-length
     token, indicating that no token should be transferred by the
     application.

PARAMETERS
     The parameter descriptions for gssdeleteseccontext() fol-
     low:

     minorstatus      A mechanism specific status code.


     contexthandle    Context handle identifying  specific  con-
                       text  to  delete.  After deleting the con-
                       text, the GS-API will set  contexthandle
                       to  GSCNOCONTEXT.


     outputtoken      A token to be sent to remote  applications
                       that instructs them to delete the context.



SunOS 5.11          Last change: 15 jan 2003                    1






Generic Security Services API Library Functions
                                     gssdeleteseccontext(3GS)



ERORS
     gssdeleteseccontext() may  return  the  following  status
     codes:

     GSCOMPLETE      Successful completion.


     GSNOCONTEXT    No valid context was supplied.


     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),    gssinitseccontext(3GS),
     attributes(5)


     Solaris Security for Developers Guide













SunOS 5.11          Last change: 15 jan 2003                    2






Generic Security Services API Library Functions
                                     gssdeleteseccontext(3GS)






















































SunOS 5.11          Last change: 15 jan 2003                    3