xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_sname_match.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_sname_match -  Test whether a principal matches a matching principal.
2===========================================================================
3
4..
5
6.. c:function:: krb5_boolean krb5_sname_match(krb5_context context, krb5_const_principal matching, krb5_const_principal princ)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **matching** - Matching principal
16
17	          **[in]** **princ** - Principal to test
18
19
20..
21
22
23
24:return:
25         -  TRUE if princ matches matching , FALSE otherwise.
26
27..
28
29
30
31
32
33
34
35If *matching* is NULL, return TRUE. If *matching* is not a matching principal, return the value of krb5_principal_compare(context, matching, princ).
36
37
38
39
40
41
42
43
44
45
46..
47
48
49
50
51
52
53.. note::
54
55	 A matching principal is a host-based principal with an empty realm and/or second data component (hostname). Profile configuration may cause the hostname to be ignored even if it is present. A principal matches a matching principal if the former has the same non-empty (and non-ignored) components of the latter.
56
57
58
59
60