gss_display_name(3)gss_display_name(3)NAMEgss_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
Kerberos 5 error code. Internal form name to be displayed.
The application must obtain the internal form name beforehand
using a call such as gss_import_name(). 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(). 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 fur‐
ther 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)gss_display_name(3)