]>
Commit | Line | Data |
---|---|---|
db9ecf05 | 1 | /* SPDX-License-Identifier: LGPL-2.1-or-later */ |
0ef6f454 LP |
2 | #pragma once |
3 | ||
a8fbdf54 TA |
4 | #include <errno.h> |
5 | #include <stdbool.h> | |
6 | #include <stddef.h> | |
7 | #include <stdint.h> | |
8 | ||
74b2466e LP |
9 | #include "hashmap.h" |
10 | #include "in-addr-util.h" | |
11 | ||
3b37fa73 | 12 | /* Length of a single label, with all escaping removed, excluding any trailing dot or NUL byte */ |
74b2466e | 13 | #define DNS_LABEL_MAX 63 |
3b37fa73 LP |
14 | |
15 | /* Worst case length of a single label, with all escaping applied and room for a trailing NUL byte. */ | |
422baca0 | 16 | #define DNS_LABEL_ESCAPED_MAX (DNS_LABEL_MAX*4+1) |
74b2466e | 17 | |
1dfbf000 LP |
18 | /* Maximum length of a full hostname, consisting of a series of unescaped labels, and no trailing dot or NUL byte */ |
19 | #define DNS_HOSTNAME_MAX 253 | |
20 | ||
2b442ac8 | 21 | /* Maximum length of a full hostname, on the wire, including the final NUL byte */ |
5e55cde9 | 22 | #define DNS_WIRE_FORMAT_HOSTNAME_MAX 255 |
2b442ac8 | 23 | |
e7ff0e0b LP |
24 | /* Maximum number of labels per valid hostname */ |
25 | #define DNS_N_LABELS_MAX 127 | |
26 | ||
7470cc4c | 27 | typedef enum DNSLabelFlags { |
64c82c25 LP |
28 | DNS_LABEL_LDH = 1 << 0, /* Follow the "LDH" rule — only letters, digits, and internal hyphens. */ |
29 | DNS_LABEL_NO_ESCAPES = 1 << 1, /* Do not treat backslashes specially */ | |
30 | DNS_LABEL_LEAVE_TRAILING_DOT = 1 << 2, /* Leave trailing dot in place */ | |
7470cc4c ZJS |
31 | } DNSLabelFlags; |
32 | ||
33 | int dns_label_unescape(const char **name, char *dest, size_t sz, DNSLabelFlags flags); | |
642900d3 | 34 | int dns_label_unescape_suffix(const char *name, const char **label_end, char *dest, size_t sz); |
422baca0 LP |
35 | int dns_label_escape(const char *p, size_t l, char *dest, size_t sz); |
36 | int dns_label_escape_new(const char *p, size_t l, char **ret); | |
74b2466e | 37 | |
f7455baa | 38 | static inline int dns_name_parent(const char **name) { |
7470cc4c | 39 | return dns_label_unescape(name, NULL, DNS_LABEL_MAX, 0); |
f7455baa LP |
40 | } |
41 | ||
349cc4a5 | 42 | #if HAVE_LIBIDN |
bdf10b5b LP |
43 | int dns_label_apply_idna(const char *encoded, size_t encoded_size, char *decoded, size_t decoded_max); |
44 | int dns_label_undo_idna(const char *encoded, size_t encoded_size, char *decoded, size_t decoded_max); | |
87057e24 | 45 | #endif |
bdf10b5b | 46 | |
7470cc4c | 47 | int dns_name_concat(const char *a, const char *b, DNSLabelFlags flags, char **ret); |
9ca45586 | 48 | |
7470cc4c | 49 | static inline int dns_name_normalize(const char *s, DNSLabelFlags flags, char **ret) { |
9ca45586 | 50 | /* dns_name_concat() normalizes as a side-effect */ |
7470cc4c | 51 | return dns_name_concat(s, NULL, flags, ret); |
9ca45586 LP |
52 | } |
53 | ||
df6cfeef NO |
54 | static inline int dns_name_is_valid(const char *s) { |
55 | int r; | |
9ca45586 LP |
56 | |
57 | /* dns_name_normalize() verifies as a side effect */ | |
7470cc4c ZJS |
58 | r = dns_name_normalize(s, 0, NULL); |
59 | if (r == -EINVAL) | |
60 | return 0; | |
61 | if (r < 0) | |
62 | return r; | |
63 | return 1; | |
64 | } | |
65 | ||
66 | static inline int dns_name_is_valid_ldh(const char *s) { | |
67 | int r; | |
68 | ||
69 | r = dns_name_concat(s, NULL, DNS_LABEL_LDH|DNS_LABEL_NO_ESCAPES, NULL); | |
df6cfeef NO |
70 | if (r == -EINVAL) |
71 | return 0; | |
72 | if (r < 0) | |
73 | return r; | |
74 | return 1; | |
75 | } | |
74b2466e | 76 | |
7a08d314 YW |
77 | void dns_name_hash_func(const char *s, struct siphash *state); |
78 | int dns_name_compare_func(const char *a, const char *b); | |
d5099efc | 79 | extern const struct hash_ops dns_name_hash_ops; |
74b2466e | 80 | |
ae72b22c | 81 | int dns_name_between(const char *a, const char *b, const char *c); |
74b2466e LP |
82 | int dns_name_equal(const char *x, const char *y); |
83 | int dns_name_endswith(const char *name, const char *suffix); | |
eb241cdb | 84 | int dns_name_startswith(const char *name, const char *prefix); |
74b2466e | 85 | |
58db254a LP |
86 | int dns_name_change_suffix(const char *name, const char *old_suffix, const char *new_suffix, char **ret); |
87 | ||
74b2466e | 88 | int dns_name_reverse(int family, const union in_addr_union *a, char **ret); |
b914e211 | 89 | int dns_name_address(const char *p, int *family, union in_addr_union *a); |
74b2466e | 90 | |
dc477e73 LP |
91 | bool dns_name_is_root(const char *name); |
92 | bool dns_name_is_single_label(const char *name); | |
54adabf7 | 93 | |
3cd03457 | 94 | int dns_name_to_wire_format(const char *domain, uint8_t *buffer, size_t len, bool canonical); |
0a49b6b6 | 95 | |
7e8131e9 | 96 | bool dns_srv_type_is_valid(const char *name); |
154ae087 | 97 | bool dnssd_srv_type_is_valid(const char *name); |
0a49b6b6 | 98 | bool dns_service_name_is_valid(const char *name); |
0e8eedbb LP |
99 | |
100 | int dns_service_join(const char *name, const char *type, const char *domain, char **ret); | |
101 | int dns_service_split(const char *joined, char **name, char **type, char **domain); | |
e7ff0e0b LP |
102 | |
103 | int dns_name_suffix(const char *name, unsigned n_labels, const char **ret); | |
104 | int dns_name_count_labels(const char *name); | |
db5b0e92 | 105 | |
97c67192 | 106 | int dns_name_skip(const char *a, unsigned n_labels, const char **ret); |
db5b0e92 | 107 | int dns_name_equal_skip(const char *a, unsigned n_labels, const char *b); |
b9282bc1 LP |
108 | |
109 | int dns_name_common_suffix(const char *a, const char *b, const char **ret); | |
0cf40f55 LP |
110 | |
111 | int dns_name_apply_idna(const char *name, char **ret); | |
08a4849e LP |
112 | |
113 | int dns_name_is_valid_or_address(const char *name); | |
64c82c25 LP |
114 | |
115 | int dns_name_dot_suffixed(const char *name); |