GSS_INQUIRE_NAMES_FOR_MECH(3GSS) Generic Security Services API Library Functions


NAME


gss_inquire_names_for_mech - list the name-types supported by the
specified mechanism

SYNOPSIS


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

OM_uint32 gss_inquire_names_for_mech(OM_uint32 *minor_status,
const gss_OID mechanism,gss_OID_set *name_types);


DESCRIPTION


The gss_inquire_names_for_mech() function returns the set of name-types
supported by the specified mechanism.

PARAMETERS


The parameter descriptions for gss_inquire_names_for_mech() follow:

minor_status
A mechanism-specific status code.


mechanism
The mechanism to be interrogated.


name_types
Set of name-types supported by the specified mechanism.
The returned OID set must be freed by the application
after use with a call to gss_release_oid_set(3GSS).


ERRORS


The gss_inquire_names_for_mech() function may return the following
values:

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(5) for descriptions of the following attributes:


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

SEE ALSO


gss_release_oid_set(3GSS), attributes(5)


Solaris Security for Developers Guide


January 15, 2003
GSS_INQUIRE_NAMES_FOR_MECH(3GSS)