opensolaris man page for gss_release_oid

gss_release_oid(3GSS)				  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 deallocate
       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 mechanism-specific sta-
			 tus code reported by means of the minor_status parameter details the error condition.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgss (32-bit)		   |
       +-----------------------------+-----------------------------+
       |			     |SUNWgssx (64-bit) 	   |
       +-----------------------------+-----------------------------+
       |MT Level		     |Safe			   |
       +-----------------------------+-----------------------------+

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

       Solaris Security for Developers Guide

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 con-
       tinue to support this function.

SunOS 5.11							    15 Jan 2003 					     gss_release_oid(3GSS)