Generic Security Services API Library Functions
                                           gssdisplayname(3GS)



NAME
     gssdisplayname - convert internal-form name to text

SYNOPSIS
     cc [flag ...]  file... -lgss [library ...]
     #include 

     OMuint32 gssdisplayname(OMuint32 *minorstatus,
          const gssnamet inputname, gssbuffert outputnamebuffer,
          gssOID *outputnametype);


DESCRIPTION
     The gssdisplayname() function  allows  an  application  to
     obtain  a  textual representation of an opaque internal-form
     name for display purposes.


     If inputname denotes an anonymous  principal,  the  GS-API
     returns   the   gssOID   value  GSCNTANONYMOUS  as  the
     outputnametype, and a textual name that  is  syntactically
     distinct   from  all  valid  supported  printable  names  in
     outputnamebuffer.


     If    inputname    was    created    by    a    call     to
     gssimportname(3GS),  specifying GSCNOID as the name-
     type, the GS-API  returns  GSCNOID  by  means  of  the
     outputnametype parameter.

PARAMETERS
     The parameter descriptions for gssdisplayname() follow:

     minorstatus          Mechanism-specific status code.


     inputname            Name in internal form.


     outputnamebuffer    Buffer to receive textual name string.
                           The   application  must  free  storage
                           associated with this  name  after  use
                           with         a         call         to
                           gssreleasebuffer(3GS).


     outputnametype      The type of the  returned  name.   The
                           returned  gssOID  will  be  a pointer
                           into  static  storage  and  should  be
                           treated as read-only by the caller. In
                           particular, the application should not



SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                           gssdisplayname(3GS)



                           attempt  to  free  it. Specify NUL if
                           this parameter is not required.


ERORS
     The gssdisplayname() function  may  return  the  following
     status codes:

     GSCOMPLETE    Successful completion.


     GSBADNAME    The inputname was ill-formed.


     GSFAILURE     The underlying mechanism detected an error
                       for  which  no specific GS status code is
                       defined.   The  mechanism-specific  status
                       code reported by means of the minorstatus
                       parameter details the error condition.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgss (32-bit)            
    
                                  SUNWgssx (64-bit)           
    
     MT-Level                     Safe                        
    


SEE ALSO
     gssimportname(3GS),   gssreleasebuffer(3GS),    attri-
     butes(5)


     Solaris Security for Developers Guide










SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                           gssdisplayname(3GS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3