Manual Pages for UNIX Operating System command usage for man gss_duplicate_name

Generic Security Services API Library Functions
                                         gss_duplicate_name(3GSS)



NAME
     gss_duplicate_name - create a copy of an internal name

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

     OM_uint32 gss_duplicate_name(OM_uint32 *minor_status,
          const gss_name_t src_name,gss_name_t *dest_name);


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

PARAMETERS
     The parameter descriptions for gss_duplicate_name() follow:

     minor_status    A mechanism-specific status code.


     src_name        Internal name to be duplicated.


     dest_name       The resultant  copy  of  src_name.   Storage
                     associated  with  this name must be freed by
                     the application after use  with  a  call  to
                     gss_release_name(3GSS).


ERRORS
     The gss_duplicate_name() function may return  the  following
     status codes:

     GSS_S_COMPLETE    Successful completion.


     GSS_S_BAD_NAME    The src_name parameter was ill-formed.


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






SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                         gss_duplicate_name(3GSS)



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



     ____________________________________________________________________
    |       ATTRIBUTE TYPE        |           ATTRIBUTE VALUE           |
    |_____________________________|_____________________________________|
    | Availability                | system/library/security/gss (32-bit)|
    |_____________________________|_____________________________________|
    |                             | SUNWgssx (64-bit)                   |
    |_____________________________|_____________________________________|
    | MT-Level                    | Safe                                |
    |_____________________________|_____________________________________|


SEE ALSO
     gss_release_name(3GSS), attributes(5)


     Oracle Solaris Security for Developers Guide
































SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                         gss_duplicate_name(3GSS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3