gss_delete_sec_context(3gss) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

gss_delete_sec_context(3gss)

gss...ext(3gss) Generic Security Services API Library Functionsgss...ext(3gss)

NAME
       gss_delete_sec_context - delete a GSS-API security context

SYNOPSIS
       cc [ flag... ] file... -lgss  [ library... ]
       #include <gssapi/gssapi.h>

       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 security context.
       The gss_delete_sec_context() function will delete the local data struc‐
       tures  associated with the specified security context.  You may not ob‐
       tain further security services that use the context specified  by  con‐
       text_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_con‐
       text(3GSS) and  gss_accept_sec_context(3GSS).


       The Solaris implementation of the GSS-API retains the output_token  pa‐
       rameter for compatibility with version 1 of the GSS-API.  Both peer ap‐
       plications  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,  indicat‐
       ing that no token should be transferred by the application.

PARAMETERS
       The parameter descriptions for gss_delete_sec_context() follow:

       minor_status      A mechanism specific status code.


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


       output_token      A  token  to  be sent to remote applications that in‐
                         structs them to delete the context.


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 condi‐
                           tion.


ATTRIBUTES
       See attributes(7)  for descriptions of the following attributes:



       tab()  box;  cw(2.75i)  |cw(2.75i)  lw(2.75i)   |lw(2.75i)   ATTRIBUTE
       TYPEATTRIBUTE VALUE _ MT-LevelSafe



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   security/kerberos-5 = Stability Pass-through committed

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


NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at:
       https://github.com/oracle/solaris-userland

       The original community source was downloaded from:
       http://web.mit.edu/kerberos/dist/krb5/1.20/krb5-1.20.2.tar.gz

       Further information about this software can be found on the open source
       community website at http://web.mit.edu/kerberos/.

Solaris 11.4                      22 Aug 2011                  gss...ext(3gss)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3