GSS_TEST_OID_SET_MEMBER(3GSS)
Generic Security Services API Library Functions
gss_test_oid_set_member - interrogate an object identifier set
cc [ flag... ] file... -lgss [ library... ]
#include <gssapi/gssapi.h>
OM_uint32 gss_test_oid_set_member(OM_uint32 *minor_status,
const gss_OID member,const gss_OID_set set,
int *present);
The gss_test_oid_set_member() function interrogates an object
identifier set to determine if a specified object identifier is a
member. This function should be used with OID sets returned by
gss_indicate_mechs(3GSS), gss_acquire_cred(3GSS), and
gss_inquire_cred(3GSS), but it will also work with user-generated
sets.
The parameter descriptions for gss_test_oid_set_member() follow:
minor_status
A mechanism-specific status code
member
An object identifier whose presence is to be tested
set
An object identifier set.
present
The value of present is non-zero if the specified OID
is a member of the set; if not, the value of present
is zero.
The gss_test_oid_set_member() 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
mechanism-specific status code reported by means of
the minor_status parameter details the error
condition.
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Safe |
+---------------+-----------------+
gss_acquire_cred(3GSS), gss_indicate_mechs(3GSS),
gss_inquire_cred(3GSS), attributes(7)
Solaris Security for Developers Guide
January 15, 2003 GSS_TEST_OID_SET_MEMBER(3GSS)
Generic Security Services API Library Functions
NAME
gss_test_oid_set_member - interrogate an object identifier set
SYNOPSIS
cc [ flag... ] file... -lgss [ library... ]
#include <gssapi/gssapi.h>
OM_uint32 gss_test_oid_set_member(OM_uint32 *minor_status,
const gss_OID member,const gss_OID_set set,
int *present);
DESCRIPTION
The gss_test_oid_set_member() function interrogates an object
identifier set to determine if a specified object identifier is a
member. This function should be used with OID sets returned by
gss_indicate_mechs(3GSS), gss_acquire_cred(3GSS), and
gss_inquire_cred(3GSS), but it will also work with user-generated
sets.
PARAMETERS
The parameter descriptions for gss_test_oid_set_member() follow:
minor_status
A mechanism-specific status code
member
An object identifier whose presence is to be tested
set
An object identifier set.
present
The value of present is non-zero if the specified OID
is a member of the set; if not, the value of present
is zero.
ERRORS
The gss_test_oid_set_member() 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
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 |
+---------------+-----------------+
SEE ALSO
gss_acquire_cred(3GSS), gss_indicate_mechs(3GSS),
gss_inquire_cred(3GSS), attributes(7)
Solaris Security for Developers Guide
January 15, 2003 GSS_TEST_OID_SET_MEMBER(3GSS)