Generic Security Services API Library Functions
                                         gssduplicatename(3GS)



NAME
     gssduplicatename - create a copy of an internal name

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

     OMuint32 gssduplicatename(OMuint32 *minorstatus,
          const gssnamet srcname,gssnamet *destname);


DESCRIPTION
     The gssduplicatename() function creates an exact duplicate
     of  the  existing internal name srcname.  The new destname
     will be  independent  of  the  srcname.  The  srcname  and
     destname must both be released, and the release of one does
     not affect the validity of the other.

PARAMETERS
     The parameter descriptions for gssduplicatename() follow:

     minorstatus    A mechanism-specific status code.


     srcname        Internal name to be duplicated.


     destname       The resultant  copy  of  srcname.   Storage
                     associated  with  this name must be freed by
                     the application after use  with  a  call  to
                     gssreleasename(3GS).


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

     GSCOMPLETE    Successful completion.


     GSBADNAME    The srcname parameter 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.






SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                         gssduplicatename(3GS)



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


     Solaris Security for Developers Guide
































SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                         gssduplicatename(3GS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3