gss_oid_to_str - convert an OID to a string
cc [ flag... ] file... -lgss [ library... ] #include <gssapi/gssapi.h> gss_oid_to_str(OM_uint32 *minor_status, const gss_OID oid, gss_buffer_toid_str);
Generic Security Services API Library Functions gss_oid_to_str(3gss) NAME gss_oid_to_str - convert an OID to a string SYNOPSIS cc [ flag... ] file... -lgss [ library... ] #include <gssapi/gssapi.h> gss_oid_to_str(OM_uint32 *minor_status, const gss_OID oid, gss_buffer_toid_str); PARAMETERS minor_status Status code returned by underlying mechanism. oid GSS-API OID structure to convert. oid_str String to receive converted OID. DESCRIPTION The gss_oid_to_str() function converts a GSS-API OID structure to a string. You can use the function to convert the name of a mechanism from an OID to a simple string. This function is a convenience func- tion, as is its complementary function, gss_str_to_oid(3GSS). If an OID must be created, use gss_create_empty_oid_set(3GSS) and gss_add_oid_set_member(3GSS) to create it. OIDs created in this way must be released with gss_release_oid_set(3GSS). However, it is strongly suggested that applications use the default GSS-API mechanism instead of creating an OID for a specific mechanism. ERRORS The gss_oid_to_str() function returns one of the following status codes: GSS_S_CALL_INACCESSIBLE_READ A required input parameter could not be read. GSS_S_CALL_INACCESSIBLE_WRITE A required output parameter could not be written. 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_add_oid_set_member(3GSS), gss_create_empty_oid_set(3GSS), gss_release_oid_set(3GSS), gss_str_to_oid(3GSS), attributes(7) 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 continue to support this function. 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_oid_to_str(3gss)