gss_str_to_oid - convert a string to an OID
cc [ flag... ] file... -lgss [ library... ] #include <gssapi/gssapi.h> OM_uint32 gss_str_to_oid(OM_uint32 *minor_status, const gss_buffer_t oid_str,gss_OID *oid);
Generic Security Services API Library Functions gss_str_to_oid(3gss) NAME gss_str_to_oid - convert a string to an OID SYNOPSIS cc [ flag... ] file... -lgss [ library... ] #include <gssapi/gssapi.h> OM_uint32 gss_str_to_oid(OM_uint32 *minor_status, const gss_buffer_t oid_str,gss_OID *oid); DESCRIPTION The gss_str_to_oid() function converts a string to a GSS-API OID struc- ture. You can use the function to convert a simple string to an OID to . This function is a convenience function, as is its complementary function, gss_oid_to_str(3GSS). OIDs created with gss_str_to_oid() must be deallocated through gss_release_oid(3GSS), if available. If an OID must be created, use gss_create_empty_oid_set(3GSS) and gss_add_oid_set_member(3GSS) to cre- ate 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. PARAMETERS The parameter descriptions for gss_str_to_oid() are as follows: minor_status Status code returned by underlying mechanism. oid GSS-API OID structure to receive converted string. oid_str String to convert. ERRORS gss_str_to_oid() 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_oid_to_str(3GSS), gss_release_oid_set(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_str_to_oid(3gss)