Generic Security Services API Library Functions
                                            gssimportname(3GS)



NAME
     gssimportname  -  convert  a  contiguous  string  name  to
     GSAPI internal format

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

     OMuint32 gssimportname(OMuint32 * minorstatus,
          const gssbuffert inputnamebuffer, const gssOID inputnametype,
          gssnamet *outputname);


DESCRIPTION
     The gssimportname() function converts a contiguous  string
     name  to  internal  form.  In  general,  the  internal  name
     returned by means of the outputname parameter will not be a
     mechanism   name;   the   exception   to   this  is  if  the
     inputnametype indicates that the  contiguous  string  pro-
     vided by means of the inputnamebuffer parameter is of type
     GSCNTEXPORTNAME, in which case, the  returned  internal
     name  will  be  a  mechanism  name  for  the  mechanism that
     exported the name.

PARAMETERS
     The parameter descriptions for gssimportname() follow:

     minorstatus         Status code returned by the  underlying
                          mechanism.


     inputnamebuffer    The gssbufferdesc structure  contain-
                          ing the name to be imported.


     inputnametype      A gssOID  that  specifies  the  format
                          that the inputnamebuffer is in.


     outputname          The gssnamet structure to receive the
                          returned name in internal form. Storage
                          associated with this name must be freed
                          by  the  application  after  use with a
                          call to gssreleasename().


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





SunOS 5.11          Last change: 30 Jun 2005                    1






Generic Security Services API Library Functions
                                            gssimportname(3GS)



     GSCOMPLETE        The  gssimportname()  function  com-
                           pleted successfully.


     GSBADNAMETYPE    The inputnametype was unrecognized.


     GSBADNAME        The inputname parameter could not  be
                           interpreted as a name of the specified
                           type.


     GSBADMECH        The        inputnametype         was
                           GSCNTEXPORTNAME,  but the mechan-
                           ism contained within the inputname is
                           not supported.


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


     Solaris Security for Developers Guide






SunOS 5.11          Last change: 30 Jun 2005                    2






Generic Security Services API Library Functions
                                            gssimportname(3GS)






















































SunOS 5.11          Last change: 30 Jun 2005                    3