Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

gss_release_oid (3gss)

Name

gss_release_oid - release an object identifier

Synopsis

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

gss_release_oid(OM_uint32 *minor_status, const gss_OID *oid);

Description

Generic Security Services API Library Functions          gss_release_oid(3gss)



NAME
       gss_release_oid - release an object identifier

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

       gss_release_oid(OM_uint32 *minor_status, const gss_OID *oid);


DESCRIPTION
       The  gss_release_oid()  function deletes an OID. Such an OID might have
       been created with gss_str_to_oid().


       Since creating and deleting  individual  OIDs  is  discouraged,  it  is
       preferable  to  use gss_release_oid_set() if it is necessary to deallo-
       cate a set of OIDs.

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

       minor_status    A mechanism-specific status code.


       oid             The object identifier of the mechanism to be deleted.


ERRORS
       gss_release_oid() returns one of the following status codes:

       GSS_S_COMPLETE    Successful completion.


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


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




       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |MT Level                     |Safe                         |
       +-----------------------------+-----------------------------+


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


       +---------------+------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE     |
       +---------------+------------------------+
       |Availability   | security/kerberos-5    |
       +---------------+------------------------+
       |Stability      | Pass-through committed |
       +---------------+------------------------+

SEE ALSO
       gss_release_oid_set(3GSS), gss_str_to_oid(3GSS), attributes(7)


WARNINGS
       This  function  is  included for compatibility only with programs using
       earlier versions of the GSS-API and should not be  used  for  new  pro-
       grams.  Other  implementations  of  the  GSS-API might not support this
       function, so portable programs should not rely on  it.  Sun  might  not
       continue to support this function.



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/ker-
       beros/dist/krb5/1.18/krb5-1.18.4.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_release_oid(3gss)