gss_compare_name(3) — Subroutines
NAME
gss_compare_name − Compare two internal form names.
SYNOPSIS
#include <gssapi/gssapi.h>
OM_uint32 gss_compare_name(
OM_uint32 ∗ minor_status,
const gss_name_t name1,
const gss_name_t name2,
int ∗ const name_equal );
PARAMETERS
minor_status
Kerberos 5 error code.
name1Internal form name to be compared. The application must obtain the internal form name beforehand using a call such as gss_import_name().
name2Internal form name to be compared. The application must obtain the internal form name beforehand using a call such as gss_import_name().
name_equal
True −− The names refer to the same entity.
False −− The names do not refer to the same entity.
DESCRIPTION
The gss_compare_name() function compares two internal form names to determine if they are the same. When a name is created using a function such as gss_import_name(), an aggregate structure is built with a component for each security mechanism that supports the name type. Two names are equal if they refer to the same entity and security mechanisms.
The application must obtain the internal form names beforehand using a call such as gss_import_name().
RETURN VALUES
| GSS_S_BAD_NAME | xx02xxxx |
| GSS_S_BAD_NAMETYPE | xx03xxxx |
| GSS_S_CALL_INACCESSIBLE_READ | 01xxxxxx |
| GSS_S_CALL_INACCESSIBLE_WRITE | 02xxxxxx |
| GSS_S_COMPLETE | 00000000 |
| GSS_S_FAILURE | xx0Dxxxx |
PORTABILITY CONSIDERATIONS
Anonymous principals are not supported by the HP implementation of GSS-API.