Manual Pages for UNIX Operating System command usage for man gss_delete_sec_context

Generic Security Services API Library Functions
                                     gss_delete_sec_context(3GSS)



NAME
     gss_delete_sec_context - delete a GSS-API security context

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

     OM_uint32 gss_delete_sec_context(OM_uint32 *minor_status,
          gss_ctx_id_t *context_handle,gss_buffer_t output_token);


DESCRIPTION
     Use the gss_delete_sec_context() function to delete a  secu-
     rity  context.   The  gss_delete_sec_context() 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 context_handle.


     In  addition  to  deleting  established  security  contexts,
     gss_delete_sec_context() will delete any half-built security
     contexts that result from incomplete sequences of  calls  to
     gss_init_sec_context(3GSS)                               and
     gss_accept_sec_context(3GSS).


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

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

     minor_status      A mechanism specific status code.


     context_handle    Context handle identifying  specific  con-
                       text  to  delete.  After deleting the con-
                       text, the GSS-API will set  context_handle
                       to  GSS_C_NO_CONTEXT.


     output_token      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
                                     gss_delete_sec_context(3GSS)



ERRORS
     gss_delete_sec_context() may  return  the  following  status
     codes:

     GSS_S_COMPLETE      Successful completion.


     GSS_S_NO_CONTEXT    No valid context was supplied.


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


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



     ____________________________________________________________________
    |       ATTRIBUTE TYPE        |           ATTRIBUTE VALUE           |
    |_____________________________|_____________________________________|
    | Availability                | system/library/security/gss (32-bit)|
    |_____________________________|_____________________________________|
    |                             | SUNWgssx (64-bit)                   |
    |_____________________________|_____________________________________|
    | MT-Level                    | Safe                                |
    |_____________________________|_____________________________________|


SEE ALSO
     gss_accept_sec_context(3GSS),    gss_init_sec_context(3GSS),
     attributes(5)


     Oracle Solaris Security for Developers Guide













SunOS 5.11          Last change: 15 jan 2003                    2






Generic Security Services API Library Functions
                                     gss_delete_sec_context(3GSS)






















































SunOS 5.11          Last change: 15 jan 2003                    3