Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

gss_add_oid_set_member (3gss)

Name

gss_add_oid_set_member - fier set

Synopsis

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

OM_uint32 gss_add_oid_set_member(OM_uint32 *minor_status,
const gss_OID member_oid, gss_OID_set *oid_set);

Description

Generic Security Services API Library Functions
                                                  gss_add_oid_set_member(3gss)



NAME
       gss_add_oid_set_member  - add an object identifier to an object identi-
       fier set

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

       OM_uint32 gss_add_oid_set_member(OM_uint32 *minor_status,
            const gss_OID member_oid, gss_OID_set *oid_set);


PARAMETERS
       The parameter descriptions for gss_add_oid_set_member() follow:

       minor_status    A mechanism specific status code.


       member_oid      Object identifier to be copied into the set.


       oid_set         Set in which the object identifier should be inserted.


DESCRIPTION
       The gss_add_oid_set_member() function adds an object identifier  to  an
       object identifier set. You should use this function in conjunction with
       gss_create_empty_oid_set(3GSS) when constructing  a  set  of  mechanism
       OIDs  for  input  to gss_acquire_cred(3GSS). The oid_set parameter must
       refer to an OID-set created by GSS-API, that  is,  a  set  returned  by
       gss_create_empty_oid_set(3GSS).


       The GSS-API creates a copy of the member_oid and inserts this copy into
       the set, expanding the storage allocated to the OID-set elements array,
       if necessary.  New members are always added to the end of the OID set's
       elements. If the member_oid is  already  present,  the  oid_set  should
       remain unchanged.

ERRORS
       The  gss_add_oid_set_member()  function can 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 mechanism-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_create_empty_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_add_oid_set_member(3gss)