Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

gss_create_empty_oid_set (3gss)

Name

gss_create_empty_oid_set - identifier set containing no object identifiers

Synopsis

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

OM_uint32 gss_create_empty_oid_set(OM_uint32 *minor_status,
gss_OID_set *oid_set);

Description

Generic Security Services API Library Functions
                                                gss_create_empty_oid_set(3gss)



NAME
       gss_create_empty_oid_set  -  create an object-identifier set containing
       no object identifiers

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

       OM_uint32 gss_create_empty_oid_set(OM_uint32 *minor_status,
            gss_OID_set *oid_set);


DESCRIPTION
       The gss_create_empty_oid_set() function  creates  an  object-identifier
       set  containing  no  object  identifiers to which members may be subse-
       quently added using the gss_add_oid_set_member(3GSS)  function.   These
       functions can be used to construct sets of mechanism object identifiers
       for input to gss_acquire_cred(3GSS).

PARAMETERS
       The parameter descriptions for gss_create_empty_oid_set() follow:

       minor_status    Mechanism-specific status code


       oid_set         Empty object identifier set. The function will allocate
                       the  gss_OID_set_desc  object,  which  the  application
                       must    free    after    use    with    a    call    to
                       gss_release_oid_set(3GSS).


ERRORS
       The gss_create_empty_oid_set() function may return 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_acquire_cred(3GSS),                   gss_add_oid_set_member(3GSS),
       gss_release_oid_set(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/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_create_empty_oid_set(3gss)