| 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); |