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)