RFC 1509            GSSAPI - Overview and C bindings      September 1993


3.6. gss_delete_sec_context

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

   Purpose:

   Delete a security context.  gss_delete_sec_context will delete the
   local data structures associated with the specified security context,
   and generate an output_token, which when passed to the peer
   gss_process_context_token will instruct it to do likewise.  No
   further security services may be obtained using the context specified
   by context_handle.

   Parameters:

      minor_status      integer, modify
                        Mechanism specific status code.

      context_handle    gss_ctx_id_t, modify
                        context handle identifying context to delete.

      output_token      buffer, opaque, modify
                        token to be sent to remote application to
                        instruct it to also delete the context

   Function value:

      GSS status code:

      GSS_S_COMPLETE    Successful completion

      GSS_S_FAILURE     Failure, see minor_status for more information

      GSS_S_NO_CONTEXT  No valid context was supplied

3.7. gss_context_time

      OM_uint32  gss_context_time (
                     OM_uint32 *     minor_status,
                     gss_ctx_id_t    context_handle,
                     OM_uint32 *     time_rec)
   Purpose:

   Determines the number of seconds for which the specified context will
   remain valid.




 
RFC 1509            GSSAPI - Overview and C bindings      September 1993


      Parameters:

      minor_status      integer, modify
                        Implementation specific status code.

      context_handle    gss_ctx_id_t, read
                        Identifies the context to be interrogated.

      time_rec          integer, modify
                        Number of seconds that the context will remain
                        valid.  If the context has already expired,
                        zero will be returned.
   Function value:

      GSS status code:

      GSS_S_COMPLETE    Successful completion

      GSS_S_CONTEXT_EXPIRED The context has already expired

      GSS_S_CREDENTIALS_EXPIRED The context is recognized, but
                        associated credentials have expired

      GSS_S_NO_CONTEXT The context_handle parameter did not identify a
                        valid context

3.8. gss_sign

      OM_uint32  gss_sign (
                     OM_uint32 *     minor_status,
                     gss_ctx_id_t    context_handle,
                     int             qop_req,
                     gss_buffer_t    message_buffer,
                     gss_buffer_t    msg_token)
   Purpose:

   Generates a cryptographic signature for the supplied message, and
   places the signature in a token for transfer to the peer application.