Generic Security Services API Library Functions
                                      gsscanonicalizename(3GS)



NAME
     gsscanonicalizename  -  convert  an  internal  name  to  a
     mechanism name

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

     OMuint32 gsscanonicalizename(OMuint32 *minorstatus,
          const gssnamet inputname,const gssOID mechtype,
          gssnamet *outputname);


DESCRIPTION
     The gsscanonicalizename() function generates  a  canonical
     mechanism name from an arbitrary internal name.  The mechan-
     ism name is the name that would be  returned  to  a  context
     acceptor on successful authentication of a context where the
     initiator used  the  inputname  in  a  successful  call  to
     gssacquirecred(3GS),  specifying  an  OID  set containing
     mechtype  as  its  only  member,  followed  by  a  call  to
     gssinitseccontext(3GS),   specifying  mechtype  as  the
     authentication mechanism.

PARAMETERS
     The parameter descriptions for gsscanonicalizename()  fol-
     low:

     minorstatus    Mechanism-specific status code.


     inputname      The name  for  which  a  canonical  form  is
                     desired.


     mechtype       The authentication mechanism for  which  the
                     canonical  form of the name is desired.  The
                     desired mechanism must be  specified  expli-
                     citly; no default is provided.


     outputname     The resultant canonical name.  Storage asso-
                     ciated  with  this name must be freed by the
                     application  after  use  with  a   call   to
                     gssreleasename(3GS).


ERORS
     The gsscanonicalizename() function may return  the  status
     codes:




SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                      gsscanonicalizename(3GS)



     GSCOMPLETE        Successful completion.


     GSBADMECH        The identified mechanism is  not  sup-
                           ported.


     GSBADNAMETYPE    The provided internal name contains no
                           elements  that  could  be processed by
                           the specified mechanism.


     GSBADNAME        The provided internal  name  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
     gssacquirecred(3GS),          gssinitseccontext(3GS),
     gssreleasename(3GS), attributes(5)


     Solaris Security for Developers Guide







SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                      gsscanonicalizename(3GS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3