Generic Security Services API Library Functions
                                            gssexportname(3GS)



NAME
     gssexportname - convert a mechanism name to export form

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

     OMuint32 gssexportname(OMuint32 *minorstatus,
          const gssnamet inputname,gssbuffert exportedname);


DESCRIPTION
     The gssexportname() function  allows  a  GS-API  internal
     name  to  be  converted  into a mechanism-specific name. The
     function produces a canonical contiguous string  representa-
     tion  of  a  mechanism name, suitable for direct comparison,
     with memory(3C), or  for  use  in  authorization  functions,
     matching  entries in an access-control list.  The inputname
     parameter must specify a valid mechanism name, that  is,  an
     internal  name  generated by gssacceptseccontext(3GS) or
     by gsscanonicalizename(3GS).

PARAMETERS
     The parameter descriptions for gssexportname() follow:

     minorstatus     A mechanism-specific status code.


     inputname       The mechanism name to be exported.


     exportedname    The canonical  contiguous  string  form  of
                      inputname.  Storage  associated  with this
                      string must freed by the application  after
                      use with gssreleasebuffer(3GS).


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

     GSCOMPLETE       Successful completion.


     GSNAMENOTMN    The provided internal name  was  not  a
                          mechanism name.


     GSFAILURE        The underlying  mechanism  detected  an
                          error  for which no specific GS status
                          code  is   defined.    The   mechanism-



SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                            gssexportname(3GS)



                          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
     gssacceptseccontext(3GS),   gsscanonicalizename(3GS),
     gssreleasebuffer(3GS)memory(3C), attributes(5)


     Solaris Security for Developers Guide


























SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                            gssexportname(3GS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3