Manual Pages for UNIX Operating System command usage for man gss_compare_name

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 

     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.





SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                           gss_compare_name(3GSS)



     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(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
     attributes(5)


     Oracle Solaris Security for Developers Guide




















SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                           gss_compare_name(3GSS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3