Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

gss_compare_name (3gss)

Name

gss_compare_name - form names

Synopsis

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

OM_uint32 gss_compare_name(OM_uint32 *minor_status,
const gss_name_t name1,const gss_name_t name2,
int *name_equal);

Description

Generic Security Services API Library Functions         gss_compare_name(3gss)



NAME
       gss_compare_name - compare two internal-form names

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

       OM_uint32 gss_compare_name(OM_uint32 *minor_status,
            const gss_name_t name1,const gss_name_t name2,
            int *name_equal);


DESCRIPTION
       The  gss_compare_name()  function  allows an application to compare two
       internal-form names to determine whether they refer to the same entity.


       If either name presented to  gss_compare_name()  denotes  an  anonymous
       principal, the routines indicate that the two names do not refer to the
       same identity.

PARAMETERS
       The parameter descriptions for gss_compare_name() follow:

       minor_status    Mechanism-specific status code.


       name1           Internal-form name.


       name2           Internal-form name.


       name_equal      If non-zero, the names refer to same entity. If 0,  the
                       names  refer to different entities. Strictly, the names
                       are not known to refer to the same identity.


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

       GSS_S_COMPLETE        Successful completion.


       GSS_S_BAD_NAMETYPE    The two names were of incomparable types.


       GSS_S_BAD_NAME        One or both of name1 or name2 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.


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
       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_compare_name(3gss)