sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-01-26 10:04:02 +03:00
Code

s4:dsdb:util_trusts: describe dns_cmp return values

Browse Source 
Signed-off-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
This commit is contained in:
Douglas Bagnall 2024-04-12 21:28:31 +12:00 committed by Andrew Bartlett
parent 8f080c0295
commit 91b802941c
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
source4/dsdb/common/util_trusts.c
View File

@ -619,6 +619,22 @@ static NTSTATUS dsdb_trust_crossref_tdo_info(TALLOC_CTX *mem_ctx,
*
* The DNS names are compared per component, starting from
* the last one.
*
* The function is usable in a sort, but the return value contains more
* information than a simple comparison. There are 5 return values, defined
* above.
*
* DNS_CMP_FIRST_IS_CHILD (-2) means the first argument is a sub-domain of the
* second. e.g. dns_cmp("foo.example.org", "example.org")
*
* DNS_CMP_FIRST_IS_LESS (-1) means the first argument sorts before the
* second, but is not a sub-domain. e.g. dns_cmp("eggsample.org", "example.org").
*
* DNS_CMP_SECOND_IS_CHILD (+2) and DNS_CMP_SECOND_IS_LESS (+1) have the
* similar expected meanings. DNS_CMP_MATCH (0) means equality.
*
* NULL values are the parent of all addresses, which means comparisons
* between a string and NULL will return +2 or -2.
*/
static int dns_cmp(const char *s1, const char *s2)
{