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

gss_display_name(3)


NAME

  gss_display_name - Convert internal form name to plain text.


SYNOPSIS

  #include <gssapi/gssapi.h>

  OM_uint32 gss_display_name(
	  OM_uint32 * minor_status,
	  const gss_name_t input_name,
	  gss_buffer_t output_name_buffer,
	  gss_OID * output_name_type );


PARAMETERS

  minor_status
	  Kerberos 5 error code.

  input_name
	  Internal form name to be displayed.

	  The application must obtain the internal form name beforehand using
	  a call such as gss_import_name().

  output_name_buffer
	  Buffer to receive the text string for the name.

	  The application must free storage associated with this name after
	  use with a call to gss_release_buffer().

  output_name_type
	  Name type of the returned name.  gss_import_name() lists the
	  supported name types. Specify NULL if this information is not
	  needed.

	  The returned gss_OID is a pointer into static storage and must be
	  treated as read-only by the application. The application must not
	  free it.


DESCRIPTION

  The gss_display_name() function converts an internal form name to text.
  This allows an application to obtain a printable representation of the
  internal name. The syntax of a printable name is defined by the
  GSS_KRB5_NT_PRINCIPAL_NAME name type.	 gss_import_name() contains further
  details.

  The application must obtain the internal form name beforehand using a call
  such as gss_import_name().

  The printable name is placed in a buffer that must be released with a call
  to gss_release_buffer() after use.


RETURN VALUES

  GSS_S_BAD_NAME		  xx02xxxx
  GSS_S_CALL_INACCESSIBLE_READ	  01xxxxxx
  GSS_S_CALL_INACCESSIBLE_WRITE	  02xxxxxx
  GSS_S_COMPLETE		  00000000
  GSS_S_FAILURE			  xx0Dxxxx


PORTABILITY CONSIDERATIONS

  Since the format of a printable name is specific to HP Application Security
  SDK, comparing the output of this function should be avoided. Similarly, do
  not import this name using gss_import_name().


SEE ALSO

  Functions:  gss_compare_name(3), gss_export_name(3), gss_import_name(3),
  gss_release_buffer(3)

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