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

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)