Debian Codegraph @

src/shared/dns-domain.h

raw
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 #pragma once
3
4 #include "shared-forward.h"
5
6 typedef enum DNSLabelFlags {
7 DNS_LABEL_LDH = 1 << 0, /* Follow the "LDH" rule — only letters, digits, and internal hyphens. */
8 DNS_LABEL_NO_ESCAPES = 1 << 1, /* Do not treat backslashes specially */
9 DNS_LABEL_LEAVE_TRAILING_DOT = 1 << 2, /* Leave trailing dot in place */
10 } DNSLabelFlags;
11
12 int dns_label_unescape(const char **name, char *dest, size_t sz, DNSLabelFlags flags);
13 int dns_label_unescape_suffix(const char *name, const char **label_terminal, char *dest, size_t sz);
14 int dns_label_escape(const char *p, size_t l, char *dest, size_t sz);
15 int dns_label_escape_new(const char *p, size_t l, char **ret);
16
17 int dns_name_parent(const char **name);
18
19 int dns_name_concat(const char *a, const char *b, DNSLabelFlags flags, char **ret);
20
21 static inline int dns_name_normalize(const char *s, DNSLabelFlags flags, char **ret) {
22 /* dns_name_concat() normalizes as a side-effect */
23 return dns_name_concat(s, NULL, flags, ret);
24 }
25
26 static inline int dns_name_is_valid(const char *s) {
27 int r;
28
29 /* dns_name_concat() verifies as a side effect */
30 r = dns_name_concat(s, NULL, 0, NULL);
31 if (r == -EINVAL)
32 return 0;
33 if (r < 0)
34 return r;
35 return 1;
36 }
37
38 static inline int dns_name_is_valid_ldh(const char *s) {
39 int r;
40
41 r = dns_name_concat(s, NULL, DNS_LABEL_LDH|DNS_LABEL_NO_ESCAPES, NULL);
42 if (r == -EINVAL)
43 return 0;
44 if (r < 0)
45 return r;
46 return 1;
47 }
48
49 void dns_name_hash_func(const char *name, struct siphash *state);
50 int dns_name_compare_func(const char *a, const char *b);
51 extern const struct hash_ops dns_name_hash_ops;
52 extern const struct hash_ops dns_name_hash_ops_free;
53
54 int dns_name_between(const char *a, const char *b, const char *c);
55 int dns_name_equal(const char *x, const char *y);
56 int dns_name_endswith(const char *name, const char *suffix);
57 int dns_name_startswith(const char *name, const char *prefix);
58
59 int dns_name_change_suffix(const char *name, const char *old_suffix, const char *new_suffix, char **ret);
60
61 int dns_name_reverse(int family, const union in_addr_union *a, char **ret);
62 int dns_name_address(const char *p, int *family, union in_addr_union *ret);
63
64 bool dns_name_is_root(const char *name);
65 bool dns_name_is_single_label(const char *name);
66
67 int dns_name_to_wire_format(const char *domain, uint8_t *buffer, size_t len, bool canonical);
68 int dns_name_from_wire_format(const uint8_t **data, size_t *len, char **ret);
69
70 bool dns_srv_type_is_valid(const char *name);
71 bool dnssd_srv_type_is_valid(const char *name);
72 bool dns_service_name_is_valid(const char *name);
73 bool dns_subtype_name_is_valid(const char *name);
74
75 int dns_service_join(const char *name, const char *type, const char *domain, char **ret);
76 int dns_service_split(const char *joined, char **ret_name, char **ret_type, char **ret_domain);
77
78 int dns_name_suffix(const char *name, unsigned n_labels, const char **ret);
79 int dns_name_count_labels(const char *name);
80
81 int dns_name_skip(const char *a, unsigned n_labels, const char **ret);
82 int dns_name_equal_skip(const char *a, unsigned n_labels, const char *b);
83
84 int dns_name_common_suffix(const char *a, const char *b, const char **ret);
85
86 int dns_name_apply_idna(const char *name, char **ret);
87
88 int dns_name_is_valid_or_address(const char *name);
89
90 int dns_name_dot_suffixed(const char *name);
91
92 bool dns_name_dont_resolve(const char *name);