Index Index for
Section 3
Index Alphabetical
listing for G
Bottom of page Bottom of
page		 

gss_oid_to_str(3)


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_str Octet string.

  oid	  OBJECT 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

  GSS_S_COMPLETE   00000000
  GSS_S_FAILURE	   xx0Dxxxx


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)

Index Index for
Section 3
Index Alphabetical
listing for G
Top of page Top of
page