NAME

gss_oid_to_str − Display OID as a string. 

SYNOPSIS

#include <gssapi/gssapi.h>
OM_uint32 gss_oid_to_str(
        OM_uint32 ∗ minor_status,
        gss_buffer_t oid_str,
        gss_OID oid );

PARAMETERS

minor_status
Kerberos 5 error code.

oid_strOctet string. 

oidOBJECT IDENTIFIER. 

DESCRIPTION

The function gss_oid_to_str() returns a string representing the input OID in numeric ANS.1 syntax format (enclosed in curly-braces, space-delimited, e.g. “{2 16 840 1 113687 1 2 1}”). 

The string is releaseable using gss_release_buffer().  If the input oid does not represent a syntactically valid object identifier, GSS_S_FAILURE status is returned and the returned oid_str result is NULL. 

RETURN VALUES

PORTABILITY CONSIDERATIONS

Implementations should be able to accept the numeric ASN.1 syntax form as described for gss_oid_to_str(), and this form should be used for portability, but implementations of this routine may also accept other formats (e.g., “1.2.3.3”). 

SEE ALSO

Functions:  gss_str_to_oid(3), gss_release_oid(3)