Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

gss_duplicate_name (3gss)

Name

gss_duplicate_name - create a copy of an internal name

Synopsis

cc [flag ...]  file... -lgss [library ...]
#include <gssapi/gssapi.h>

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

Description

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 <gssapi/gssapi.h>

       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  mecha-
                         nism-specific  status  code  reported by means of the
                         minor_status parameter details the error condition.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:




       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |MT-Level                     |Safe                         |
       +-----------------------------+-----------------------------+


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE     |
       +---------------+------------------------+
       |Availability   | security/kerberos-5    |
       +---------------+------------------------+
       |Stability      | Pass-through committed |
       +---------------+------------------------+

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


NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source      was      downloaded      from       http://web.mit.edu/ker-
       beros/dist/krb5/1.18/krb5-1.18.4.tar.gz.

       Further information about this software can be found on the open source
       community website at http://web.mit.edu/kerberos/.



Solaris 11.4                      22 Aug 2011         gss_duplicate_name(3gss)