NAME    [Toc]    [Back]

       gss_display_name  -  Convert  internal  form name to plain
       text.

SYNOPSIS    [Toc]    [Back]

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

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

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

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

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

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



                                              gss_display_name(3)