NAME    [Toc]    [Back]

       gss_oid_to_str - Display OID as a string.

SYNOPSIS    [Toc]    [Back]

       #include <gssapi/gssapi.h>

       OM_uint32 gss_oid_to_str(
               OM_uint32 * minor_status,
               gss_buffer_t oid_str,
               gss_OID oid );

PARAMETERS    [Toc]    [Back]

       Kerberos  5 error code.  Octet string.  OBJECT IDENTIFIER.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       GSS_S_COMPLETE   00000000
       GSS_S_FAILURE    xx0Dxxxx

PORTABILITY CONSIDERATIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       Functions:  gss_str_to_oid(3), gss_release_oid(3)



                                                gss_oid_to_str(3)