Debian Codegraph @

src/shared/varlink-io.systemd.Resolve.c

raw
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2
3 #include "resolve-util.h"
4 #include "varlink-io.systemd.Resolve.h"
5
6 SD_VARLINK_DEFINE_ENUM_TYPE(
7 DNSProtocol,
8 SD_VARLINK_FIELD_COMMENT("DNS"),
9 SD_VARLINK_DEFINE_ENUM_VALUE(dns),
10 SD_VARLINK_FIELD_COMMENT("Multicast DNS"),
11 SD_VARLINK_DEFINE_ENUM_VALUE(mdns),
12 SD_VARLINK_FIELD_COMMENT("LLMNR"),
13 SD_VARLINK_DEFINE_ENUM_VALUE(llmnr));
14
15 SD_VARLINK_DEFINE_ENUM_TYPE(
16 DNSOverTLSMode,
17 SD_VARLINK_FIELD_COMMENT("DNSOverTLS is disabled."),
18 SD_VARLINK_DEFINE_ENUM_VALUE(no),
19 SD_VARLINK_FIELD_COMMENT("DNSOverTLS is enabled."),
20 SD_VARLINK_DEFINE_ENUM_VALUE(yes),
21 SD_VARLINK_FIELD_COMMENT("Try to use DNSOverTLS, but disabled when the server does not support it."),
22 SD_VARLINK_DEFINE_ENUM_VALUE(opportunistic));
23
24 SD_VARLINK_DEFINE_ENUM_TYPE(
25 ResolveSupport,
26 SD_VARLINK_FIELD_COMMENT("The protocol is disabled."),
27 SD_VARLINK_DEFINE_ENUM_VALUE(no),
28 SD_VARLINK_FIELD_COMMENT("The protocol is enabled."),
29 SD_VARLINK_DEFINE_ENUM_VALUE(yes),
30 SD_VARLINK_FIELD_COMMENT("The protocol is used only for resolving."),
31 SD_VARLINK_DEFINE_ENUM_VALUE(resolve));
32
33 SD_VARLINK_DEFINE_ENUM_TYPE(
34 ResolvConfMode,
35 SD_VARLINK_FIELD_COMMENT("/etc/resolv.conf is a symbolic link to "PRIVATE_UPLINK_RESOLV_CONF"."),
36 SD_VARLINK_DEFINE_ENUM_VALUE(uplink),
37 SD_VARLINK_FIELD_COMMENT("/etc/resolv.conf is a symbolic link to "PRIVATE_STUB_RESOLV_CONF"."),
38 SD_VARLINK_DEFINE_ENUM_VALUE(stub),
39 SD_VARLINK_FIELD_COMMENT("/etc/resolv.conf is a symbolic link to "PRIVATE_STATIC_RESOLV_CONF"."),
40 SD_VARLINK_DEFINE_ENUM_VALUE(static),
41 SD_VARLINK_FIELD_COMMENT("/etc/resolv.conf does not exist."),
42 SD_VARLINK_DEFINE_ENUM_VALUE(missing),
43 SD_VARLINK_FIELD_COMMENT("/etc/resolv.conf is not managed by systemd-resolved."),
44 SD_VARLINK_DEFINE_ENUM_VALUE(foreign));
45
46 SD_VARLINK_DEFINE_STRUCT_TYPE(
47 ResourceKey,
48 SD_VARLINK_FIELD_COMMENT("The RR class, almost always IN, i.e 0x01. If unspecified defaults to IN."),
49 SD_VARLINK_DEFINE_FIELD(class, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
50 SD_VARLINK_FIELD_COMMENT("The RR types, one of A, AAAA, PTR, …"),
51 SD_VARLINK_DEFINE_FIELD(type, SD_VARLINK_INT, 0),
52 SD_VARLINK_FIELD_COMMENT("The domain name."),
53 SD_VARLINK_DEFINE_FIELD(name, SD_VARLINK_STRING, 0));
54
55 SD_VARLINK_DEFINE_STRUCT_TYPE(
56 ResourceRecord,
57 SD_VARLINK_DEFINE_FIELD_BY_TYPE(key, ResourceKey, 0),
58 SD_VARLINK_DEFINE_FIELD(priority, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
59 SD_VARLINK_DEFINE_FIELD(weight, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
60 SD_VARLINK_DEFINE_FIELD(port, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
61 SD_VARLINK_DEFINE_FIELD(name, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
62 SD_VARLINK_DEFINE_FIELD(cpu, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
63 SD_VARLINK_DEFINE_FIELD(os, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
64 SD_VARLINK_DEFINE_FIELD(items, SD_VARLINK_STRING, SD_VARLINK_NULLABLE|SD_VARLINK_ARRAY),
65 SD_VARLINK_DEFINE_FIELD(address, SD_VARLINK_INT, SD_VARLINK_NULLABLE|SD_VARLINK_ARRAY),
66 SD_VARLINK_DEFINE_FIELD(mname, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
67 SD_VARLINK_DEFINE_FIELD(rname, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
68 SD_VARLINK_DEFINE_FIELD(serial, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
69 SD_VARLINK_DEFINE_FIELD(refresh, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
70 SD_VARLINK_DEFINE_FIELD(expire, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
71 SD_VARLINK_DEFINE_FIELD(minimum, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
72 SD_VARLINK_DEFINE_FIELD(exchange, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
73 SD_VARLINK_DEFINE_FIELD(version, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
74 SD_VARLINK_DEFINE_FIELD(size, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
75 SD_VARLINK_DEFINE_FIELD(horiz_pre, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
76 SD_VARLINK_DEFINE_FIELD(vert_pre, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
77 SD_VARLINK_DEFINE_FIELD(latitude, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
78 SD_VARLINK_DEFINE_FIELD(longitude, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
79 SD_VARLINK_DEFINE_FIELD(altitude, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
80 SD_VARLINK_DEFINE_FIELD(keyTag, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
81 SD_VARLINK_DEFINE_FIELD(algorithm, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
82 SD_VARLINK_DEFINE_FIELD(digestType, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
83 SD_VARLINK_DEFINE_FIELD(digest, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
84 SD_VARLINK_DEFINE_FIELD(fptype, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
85 SD_VARLINK_DEFINE_FIELD(fingerprint, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
86 SD_VARLINK_DEFINE_FIELD(flags, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
87 SD_VARLINK_DEFINE_FIELD(protocol, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
88 SD_VARLINK_DEFINE_FIELD(dnskey, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
89 SD_VARLINK_DEFINE_FIELD(signer, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
90 SD_VARLINK_DEFINE_FIELD(typeCovered, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
91 SD_VARLINK_DEFINE_FIELD(labels, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
92 SD_VARLINK_DEFINE_FIELD(originalTtl, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
93 SD_VARLINK_DEFINE_FIELD(expiration, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
94 SD_VARLINK_DEFINE_FIELD(inception, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
95 SD_VARLINK_DEFINE_FIELD(signature, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
96 SD_VARLINK_DEFINE_FIELD(nextDomain, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
97 SD_VARLINK_DEFINE_FIELD(types, SD_VARLINK_INT, SD_VARLINK_NULLABLE|SD_VARLINK_ARRAY),
98 SD_VARLINK_DEFINE_FIELD(iterations, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
99 SD_VARLINK_DEFINE_FIELD(salt, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
100 SD_VARLINK_DEFINE_FIELD(hash, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
101 SD_VARLINK_DEFINE_FIELD(certUsage, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
102 SD_VARLINK_DEFINE_FIELD(selector, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
103 SD_VARLINK_DEFINE_FIELD(matchingType, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
104 SD_VARLINK_DEFINE_FIELD(data, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
105 SD_VARLINK_DEFINE_FIELD(tag, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
106 SD_VARLINK_DEFINE_FIELD(value, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
107 SD_VARLINK_DEFINE_FIELD(target, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
108 /* This field is retired */
109 /* SD_VARLINK_DEFINE_FIELD(params, SD_VARLINK_STRING, SD_VARLINK_NULLABLE|SD_VARLINK_ARRAY), */
110 SD_VARLINK_DEFINE_FIELD(svcparams, SD_VARLINK_OBJECT, SD_VARLINK_NULLABLE),
111 SD_VARLINK_DEFINE_FIELD(order, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
112 SD_VARLINK_DEFINE_FIELD(preference, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
113 SD_VARLINK_DEFINE_FIELD(naptrFlags, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
114 SD_VARLINK_DEFINE_FIELD(services, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
115 SD_VARLINK_DEFINE_FIELD(regexp, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
116 SD_VARLINK_DEFINE_FIELD(replacement, SD_VARLINK_STRING, SD_VARLINK_NULLABLE));
117
118 static SD_VARLINK_DEFINE_STRUCT_TYPE(
119 ResolvedAddress,
120 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
121 SD_VARLINK_DEFINE_FIELD(family, SD_VARLINK_INT, 0),
122 SD_VARLINK_DEFINE_FIELD(address, SD_VARLINK_INT, SD_VARLINK_ARRAY));
123
124 static SD_VARLINK_DEFINE_METHOD(
125 ResolveHostname,
126 SD_VARLINK_FIELD_COMMENT("The Linux interface index for the network interface to search on. Typically left unspecified, in order to search on all interfaces."),
127 SD_VARLINK_DEFINE_INPUT(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
128 SD_VARLINK_FIELD_COMMENT("The host name to resolve."),
129 SD_VARLINK_DEFINE_INPUT(name, SD_VARLINK_STRING, 0),
130 SD_VARLINK_FIELD_COMMENT("The address family to search for, one of AF_INET or AF_INET6."),
131 SD_VARLINK_DEFINE_INPUT(family, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
132 SD_VARLINK_FIELD_COMMENT("Various search flags."),
133 SD_VARLINK_DEFINE_INPUT(flags, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
134 SD_VARLINK_FIELD_COMMENT("Array of resolved IP addresses"),
135 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(addresses, ResolvedAddress, SD_VARLINK_ARRAY),
136 SD_VARLINK_FIELD_COMMENT("Canonical name of the host."),
137 SD_VARLINK_DEFINE_OUTPUT(name, SD_VARLINK_STRING, 0),
138 SD_VARLINK_FIELD_COMMENT("Various flags indicating details on discovered data."),
139 SD_VARLINK_DEFINE_OUTPUT(flags, SD_VARLINK_INT, 0));
140
141 static SD_VARLINK_DEFINE_STRUCT_TYPE(
142 ResolvedName,
143 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
144 SD_VARLINK_DEFINE_FIELD(name, SD_VARLINK_STRING, 0));
145
146 static SD_VARLINK_DEFINE_ENUM_TYPE(
147 BrowseServiceUpdateFlag,
148 SD_VARLINK_FIELD_COMMENT("Indicates that the service was added."),
149 SD_VARLINK_DEFINE_ENUM_VALUE(added),
150 SD_VARLINK_FIELD_COMMENT("Indicates that the service was removed."),
151 SD_VARLINK_DEFINE_ENUM_VALUE(removed));
152
153 static SD_VARLINK_DEFINE_STRUCT_TYPE(
154 ServiceData,
155 SD_VARLINK_DEFINE_FIELD_BY_TYPE(updateFlag, BrowseServiceUpdateFlag, 0),
156 SD_VARLINK_FIELD_COMMENT("The address family of the service, one of AF_INET or AF_INET6."),
157 SD_VARLINK_DEFINE_FIELD(family, SD_VARLINK_INT, 0),
158 SD_VARLINK_FIELD_COMMENT("The name of the service, e.g., 'My Service'. May be null if not specified."),
159 SD_VARLINK_DEFINE_FIELD(name, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
160 SD_VARLINK_FIELD_COMMENT("The type of service, e.g., '_http._tcp'."),
161 SD_VARLINK_DEFINE_FIELD(type, SD_VARLINK_STRING, 0),
162 SD_VARLINK_FIELD_COMMENT("The domain in which the service resides, e.g., 'local'."),
163 SD_VARLINK_DEFINE_FIELD(domain, SD_VARLINK_STRING, 0),
164 SD_VARLINK_FIELD_COMMENT("The Linux interface index for the network interface associated with this service."),
165 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, 0));
166
167 static SD_VARLINK_DEFINE_METHOD(
168 ResolveAddress,
169 SD_VARLINK_FIELD_COMMENT("The Linux interface index for the network interface to search on. Typically left unspecified, in order to search on all interfaces."),
170 SD_VARLINK_DEFINE_INPUT(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
171 SD_VARLINK_FIELD_COMMENT("The address family of the specified address, one of AF_INET or AF_INET6."),
172 SD_VARLINK_DEFINE_INPUT(family, SD_VARLINK_INT, 0),
173 SD_VARLINK_FIELD_COMMENT("The IP address to look up, either 4 or 16 integers (depending if an AF_INET or AF_INET6 address shall be resolved)."),
174 SD_VARLINK_DEFINE_INPUT(address, SD_VARLINK_INT, SD_VARLINK_ARRAY),
175 SD_VARLINK_DEFINE_INPUT(flags, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
176 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(names, ResolvedName, SD_VARLINK_ARRAY),
177 SD_VARLINK_DEFINE_OUTPUT(flags, SD_VARLINK_INT, 0));
178
179 static SD_VARLINK_DEFINE_STRUCT_TYPE(
180 ResolvedService,
181 SD_VARLINK_DEFINE_FIELD(priority, SD_VARLINK_INT, 0),
182 SD_VARLINK_DEFINE_FIELD(weight, SD_VARLINK_INT, 0),
183 SD_VARLINK_DEFINE_FIELD(port, SD_VARLINK_INT, 0),
184 SD_VARLINK_DEFINE_FIELD(hostname, SD_VARLINK_STRING, 0),
185 SD_VARLINK_DEFINE_FIELD(canonicalName, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
186 SD_VARLINK_DEFINE_FIELD_BY_TYPE(addresses, ResolvedAddress, SD_VARLINK_ARRAY|SD_VARLINK_NULLABLE));
187
188 static SD_VARLINK_DEFINE_STRUCT_TYPE(
189 ResolvedCanonical,
190 SD_VARLINK_FIELD_COMMENT("The DNS-SD name of the service. For simple SRV services this field is absent or null."),
191 SD_VARLINK_DEFINE_FIELD(name, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
192 SD_VARLINK_DEFINE_FIELD(type, SD_VARLINK_STRING, 0),
193 SD_VARLINK_DEFINE_FIELD(domain, SD_VARLINK_STRING, 0));
194
195 static SD_VARLINK_DEFINE_METHOD(
196 ResolveService,
197 SD_VARLINK_DEFINE_INPUT(name, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
198 SD_VARLINK_DEFINE_INPUT(type, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
199 SD_VARLINK_DEFINE_INPUT(domain, SD_VARLINK_STRING, 0),
200 SD_VARLINK_DEFINE_INPUT(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
201 SD_VARLINK_DEFINE_INPUT(family, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
202 SD_VARLINK_DEFINE_INPUT(flags, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
203 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(services, ResolvedService, SD_VARLINK_ARRAY),
204 SD_VARLINK_DEFINE_OUTPUT(txt, SD_VARLINK_STRING, SD_VARLINK_ARRAY|SD_VARLINK_NULLABLE),
205 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(canonical, ResolvedCanonical, 0),
206 SD_VARLINK_DEFINE_OUTPUT(flags, SD_VARLINK_INT, 0));
207
208 static SD_VARLINK_DEFINE_STRUCT_TYPE(
209 ResolvedRecord,
210 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
211 SD_VARLINK_DEFINE_FIELD_BY_TYPE(rr, ResourceRecord, SD_VARLINK_NULLABLE),
212 SD_VARLINK_DEFINE_FIELD(raw, SD_VARLINK_STRING, 0));
213
214 SD_VARLINK_DEFINE_STRUCT_TYPE(
215 DNSServer,
216 SD_VARLINK_FIELD_COMMENT("IPv4 or IPv6 address of the server."),
217 SD_VARLINK_DEFINE_FIELD(address, SD_VARLINK_INT, SD_VARLINK_ARRAY),
218 SD_VARLINK_FIELD_COMMENT("IPv4 or IPv6 address of the server, formatted as a human-readable string."),
219 SD_VARLINK_DEFINE_FIELD(addressString, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
220 SD_VARLINK_FIELD_COMMENT("Address family of the server, one of AF_INET or AF_INET6."),
221 SD_VARLINK_DEFINE_FIELD(family, SD_VARLINK_INT, 0),
222 SD_VARLINK_FIELD_COMMENT("Port number of the server."),
223 SD_VARLINK_DEFINE_FIELD(port, SD_VARLINK_INT, 0),
224 SD_VARLINK_FIELD_COMMENT("Interface index for which this server is configured."),
225 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
226 SD_VARLINK_FIELD_COMMENT("Server Name Indication (SNI) of the server."),
227 SD_VARLINK_DEFINE_FIELD(name, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
228 SD_VARLINK_FIELD_COMMENT("Indicates if the DNS server is accessible or not."),
229 SD_VARLINK_DEFINE_FIELD(accessible, SD_VARLINK_BOOL, 0));
230
231 SD_VARLINK_DEFINE_STRUCT_TYPE(
232 SearchDomain,
233 SD_VARLINK_FIELD_COMMENT("Domain name."),
234 SD_VARLINK_DEFINE_FIELD(name, SD_VARLINK_STRING, 0),
235 SD_VARLINK_FIELD_COMMENT("Indicates whether or not this is a routing-only domain."),
236 SD_VARLINK_DEFINE_FIELD(routeOnly, SD_VARLINK_BOOL, 0),
237 SD_VARLINK_FIELD_COMMENT("Interface index for which this search domain is configured."),
238 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE));
239
240 SD_VARLINK_DEFINE_STRUCT_TYPE(
241 DNSScope,
242 SD_VARLINK_FIELD_COMMENT("Protocol associated with this scope."),
243 SD_VARLINK_DEFINE_FIELD_BY_TYPE(protocol, DNSProtocol, 0),
244 SD_VARLINK_FIELD_COMMENT("Address family associated with this scope."),
245 SD_VARLINK_DEFINE_FIELD(family, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
246 SD_VARLINK_FIELD_COMMENT("Interface index associated with this scope."),
247 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
248 SD_VARLINK_FIELD_COMMENT("Interface name associated with this scope."),
249 SD_VARLINK_DEFINE_FIELD(ifname, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
250 SD_VARLINK_FIELD_COMMENT("DNSSEC mode associated with this scope."),
251 SD_VARLINK_DEFINE_FIELD(dnssec, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
252 SD_VARLINK_FIELD_COMMENT("DNSOverTLS mode associated with this scope."),
253 SD_VARLINK_DEFINE_FIELD_BY_TYPE(dnsOverTLS, DNSOverTLSMode, SD_VARLINK_NULLABLE));
254
255 SD_VARLINK_DEFINE_STRUCT_TYPE(
256 DNSConfiguration,
257 SD_VARLINK_FIELD_COMMENT("Interface name, if any, associated with this configuration. Empty for global configuration."),
258 SD_VARLINK_DEFINE_FIELD(ifname, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
259 SD_VARLINK_FIELD_COMMENT("Interface index, if any, associated with this configuration. Empty for global configuration."),
260 SD_VARLINK_DEFINE_FIELD(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
261 SD_VARLINK_FIELD_COMMENT("Delegate name, if any, associated with this configuration. Empty for global or link configurations."),
262 SD_VARLINK_DEFINE_FIELD(delegate, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
263 SD_VARLINK_FIELD_COMMENT("Indicates whether or not this link's DNS servers will be used for resolving domain names that do not match any link's configured domains."),
264 SD_VARLINK_DEFINE_FIELD(defaultRoute, SD_VARLINK_BOOL, SD_VARLINK_NULLABLE),
265 SD_VARLINK_FIELD_COMMENT("DNS server currently selected to use for lookups."),
266 SD_VARLINK_DEFINE_FIELD_BY_TYPE(currentServer, DNSServer, SD_VARLINK_NULLABLE),
267 SD_VARLINK_FIELD_COMMENT("Array of configured DNS servers."),
268 SD_VARLINK_DEFINE_FIELD_BY_TYPE(servers, DNSServer, SD_VARLINK_ARRAY|SD_VARLINK_NULLABLE),
269 SD_VARLINK_FIELD_COMMENT("Array of configured fallback DNS servers, set for global configuration only."),
270 SD_VARLINK_DEFINE_FIELD_BY_TYPE(fallbackServers, DNSServer, SD_VARLINK_ARRAY|SD_VARLINK_NULLABLE),
271 SD_VARLINK_FIELD_COMMENT("Array of configured search domains."),
272 SD_VARLINK_DEFINE_FIELD_BY_TYPE(searchDomains, SearchDomain, SD_VARLINK_ARRAY|SD_VARLINK_NULLABLE),
273 SD_VARLINK_FIELD_COMMENT("Array of configured DNSSEC negative trust anchors."),
274 SD_VARLINK_DEFINE_FIELD(negativeTrustAnchors, SD_VARLINK_STRING, SD_VARLINK_ARRAY|SD_VARLINK_NULLABLE),
275 SD_VARLINK_FIELD_COMMENT("DNSSEC mode."),
276 SD_VARLINK_DEFINE_FIELD(dnssec, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
277 SD_VARLINK_FIELD_COMMENT("Indicates if the current DNS server supports DNSSEC. Always false if DNSSEC mode is \"no\"."),
278 SD_VARLINK_DEFINE_FIELD(dnssecSupported, SD_VARLINK_BOOL, SD_VARLINK_NULLABLE),
279 SD_VARLINK_FIELD_COMMENT("DNSOverTLS mode."),
280 SD_VARLINK_DEFINE_FIELD_BY_TYPE(dnsOverTLS, DNSOverTLSMode, SD_VARLINK_NULLABLE),
281 SD_VARLINK_FIELD_COMMENT("LLMNR support."),
282 //SD_VARLINK_DEFINE_FIELD_BY_TYPE(llmnr, ResolveSupport, SD_VARLINK_NULLABLE),
283 SD_VARLINK_DEFINE_FIELD(llmnr, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
284 SD_VARLINK_FIELD_COMMENT("mDNS support."),
285 SD_VARLINK_DEFINE_FIELD_BY_TYPE(mDNS, ResolveSupport, SD_VARLINK_NULLABLE),
286 SD_VARLINK_FIELD_COMMENT("resolv.conf mode, set for global configuration only."),
287 SD_VARLINK_DEFINE_FIELD_BY_TYPE(resolvConfMode, ResolvConfMode, SD_VARLINK_NULLABLE),
288 SD_VARLINK_FIELD_COMMENT("Array of current DNS scopes."),
289 SD_VARLINK_DEFINE_FIELD_BY_TYPE(scopes, DNSScope, SD_VARLINK_ARRAY|SD_VARLINK_NULLABLE));
290
291 static SD_VARLINK_DEFINE_METHOD(
292 ResolveRecord,
293 SD_VARLINK_DEFINE_INPUT(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
294 SD_VARLINK_DEFINE_INPUT(name, SD_VARLINK_STRING, 0),
295 SD_VARLINK_DEFINE_INPUT(class, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
296 SD_VARLINK_DEFINE_INPUT(type, SD_VARLINK_INT, 0),
297 SD_VARLINK_DEFINE_INPUT(flags, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
298 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(rrs, ResolvedRecord, SD_VARLINK_ARRAY),
299 SD_VARLINK_DEFINE_OUTPUT(flags, SD_VARLINK_INT, 0));
300
301 static SD_VARLINK_DEFINE_METHOD_FULL(
302 BrowseServices,
303 SD_VARLINK_REQUIRES_MORE,
304 SD_VARLINK_FIELD_COMMENT("The domain to browse for services. If null, the default browsing domain local is used."),
305 SD_VARLINK_DEFINE_INPUT(domain, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
306 SD_VARLINK_FIELD_COMMENT("The service type to browse for (e.g., '_http._tcp')."),
307 SD_VARLINK_DEFINE_INPUT(type, SD_VARLINK_STRING, SD_VARLINK_NULLABLE),
308 SD_VARLINK_FIELD_COMMENT("The Linux interface index for the network interface to search on."),
309 SD_VARLINK_DEFINE_INPUT(ifindex, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
310 SD_VARLINK_FIELD_COMMENT("Various browsing flags to modify the operation."),
311 SD_VARLINK_DEFINE_INPUT(flags, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
312 SD_VARLINK_FIELD_COMMENT("An array of service data containing information about discovered services."),
313 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(browserServiceData, ServiceData, SD_VARLINK_ARRAY));
314
315 static SD_VARLINK_DEFINE_METHOD(
316 DumpDNSConfiguration,
317 SD_VARLINK_FIELD_COMMENT("The current global and per-interface DNS configurations"),
318 SD_VARLINK_DEFINE_OUTPUT_BY_TYPE(configuration, DNSConfiguration, SD_VARLINK_ARRAY));
319
320 static SD_VARLINK_DEFINE_ERROR(NoNameServers);
321 static SD_VARLINK_DEFINE_ERROR(NoSuchResourceRecord);
322 static SD_VARLINK_DEFINE_ERROR(QueryTimedOut);
323 static SD_VARLINK_DEFINE_ERROR(MaxAttemptsReached);
324 static SD_VARLINK_DEFINE_ERROR(InvalidReply);
325 static SD_VARLINK_DEFINE_ERROR(QueryAborted);
326 static SD_VARLINK_DEFINE_ERROR(QueryRefused);
327 static SD_VARLINK_DEFINE_ERROR(
328 DNSSECValidationFailed,
329 SD_VARLINK_DEFINE_FIELD(result, SD_VARLINK_STRING, 0),
330 SD_VARLINK_DEFINE_FIELD(extendedDNSErrorCode, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
331 SD_VARLINK_DEFINE_FIELD(extendedDNSErrorMessage, SD_VARLINK_STRING, SD_VARLINK_NULLABLE));
332 static SD_VARLINK_DEFINE_ERROR(NoTrustAnchor);
333 static SD_VARLINK_DEFINE_ERROR(ResourceRecordTypeUnsupported);
334 static SD_VARLINK_DEFINE_ERROR(NetworkDown);
335 static SD_VARLINK_DEFINE_ERROR(NoSource);
336 static SD_VARLINK_DEFINE_ERROR(StubLoop);
337 static SD_VARLINK_DEFINE_ERROR(
338 DNSError,
339 SD_VARLINK_DEFINE_FIELD(rcode, SD_VARLINK_INT, 0),
340 SD_VARLINK_DEFINE_FIELD(extendedDNSErrorCode, SD_VARLINK_INT, SD_VARLINK_NULLABLE),
341 SD_VARLINK_DEFINE_FIELD(extendedDNSErrorMessage, SD_VARLINK_STRING, SD_VARLINK_NULLABLE));
342 static SD_VARLINK_DEFINE_ERROR(CNAMELoop);
343 static SD_VARLINK_DEFINE_ERROR(BadAddressSize);
344 static SD_VARLINK_DEFINE_ERROR(ResourceRecordTypeInvalidForQuery);
345 static SD_VARLINK_DEFINE_ERROR(ZoneTransfersNotPermitted);
346 static SD_VARLINK_DEFINE_ERROR(ResourceRecordTypeObsolete);
347 static SD_VARLINK_DEFINE_ERROR(InconsistentServiceRecords);
348 static SD_VARLINK_DEFINE_ERROR(ServiceNotProvided);
349
350 SD_VARLINK_DEFINE_INTERFACE(
351 io_systemd_Resolve,
352 "io.systemd.Resolve",
353 SD_VARLINK_SYMBOL_COMMENT("Resolves a hostname to one or more IP addresses."),
354 &vl_method_ResolveHostname,
355 SD_VARLINK_SYMBOL_COMMENT("Resolves an IP address to a hostname."),
356 &vl_method_ResolveAddress,
357 SD_VARLINK_SYMBOL_COMMENT("Resolves a named DNS-SD or unnamed simple SRV service."),
358 &vl_method_ResolveService,
359 SD_VARLINK_SYMBOL_COMMENT("Resolves a domain name to one or more DNS resource records."),
360 &vl_method_ResolveRecord,
361 SD_VARLINK_SYMBOL_COMMENT("Starts browsing for DNS-SD services of specified type."),
362 &vl_method_BrowseServices,
363 SD_VARLINK_SYMBOL_COMMENT("Current global and per-link DNS configurations."),
364 &vl_method_DumpDNSConfiguration,
365 SD_VARLINK_SYMBOL_COMMENT("The type of protocol."),
366 &vl_type_DNSProtocol,
367 SD_VARLINK_SYMBOL_COMMENT("The mode of DNSOverTLS."),
368 &vl_type_DNSOverTLSMode,
369 SD_VARLINK_SYMBOL_COMMENT("Whether the protocol is enabled."),
370 &vl_type_ResolveSupport,
371 SD_VARLINK_SYMBOL_COMMENT("The management mode of /etc/resolve.conf file."),
372 &vl_type_ResolvConfMode,
373 SD_VARLINK_SYMBOL_COMMENT("Encapsulates a resolved address."),
374 &vl_type_ResolvedAddress,
375 SD_VARLINK_SYMBOL_COMMENT("Encapsulates a resolved host name."),
376 &vl_type_ResolvedName,
377 SD_VARLINK_SYMBOL_COMMENT("Encapsulates resolved service information."),
378 &vl_type_ResolvedService,
379 SD_VARLINK_SYMBOL_COMMENT("Encapsulates the canonical name, type and domain of a DNS-SD or simple SRV service. Note that due to CNAME redirections and similar, a named DNS-SD service might resolve to a canonical service that is an unnamed simple SRV service. Or in other words: resolving a named service might return an unnamed canonical service."),
380 &vl_type_ResolvedCanonical,
381 SD_VARLINK_SYMBOL_COMMENT("The 'key' part of a DNS resource record."),
382 &vl_type_ResourceKey,
383 SD_VARLINK_SYMBOL_COMMENT("A full DNS resource record.."),
384 &vl_type_ResourceRecord,
385 SD_VARLINK_SYMBOL_COMMENT("Encapsulates information about a resolved DNS resource record "),
386 &vl_type_ResolvedRecord,
387 SD_VARLINK_SYMBOL_COMMENT("Describes the update flag for browsing services, indicating whether a service was added or removed during browsing."),
388 &vl_type_BrowseServiceUpdateFlag,
389 SD_VARLINK_SYMBOL_COMMENT("Encapsulates the service data obtained from browsing."),
390 &vl_type_ServiceData,
391 SD_VARLINK_SYMBOL_COMMENT("Encapsulates a DNS server address specification."),
392 &vl_type_DNSServer,
393 SD_VARLINK_SYMBOL_COMMENT("Encapsulates a search domain specification."),
394 &vl_type_SearchDomain,
395 SD_VARLINK_SYMBOL_COMMENT("Encapsulates a global or per-link DNS configuration, including configured DNS servers, search domains, and more."),
396 &vl_type_DNSConfiguration,
397 SD_VARLINK_SYMBOL_COMMENT("Encapsulates a DNS scope specification."),
398 &vl_type_DNSScope,
399 &vl_error_NoNameServers,
400 &vl_error_NoSuchResourceRecord,
401 &vl_error_QueryTimedOut,
402 &vl_error_MaxAttemptsReached,
403 &vl_error_InvalidReply,
404 &vl_error_QueryAborted,
405 &vl_error_QueryRefused,
406 &vl_error_DNSSECValidationFailed,
407 &vl_error_NoTrustAnchor,
408 &vl_error_ResourceRecordTypeUnsupported,
409 &vl_error_NetworkDown,
410 &vl_error_NoSource,
411 &vl_error_StubLoop,
412 &vl_error_DNSError,
413 &vl_error_CNAMELoop,
414 &vl_error_BadAddressSize,
415 &vl_error_ResourceRecordTypeInvalidForQuery,
416 &vl_error_ZoneTransfersNotPermitted,
417 &vl_error_ResourceRecordTypeObsolete,
418 SD_VARLINK_SYMBOL_COMMENT("The DNS resource records of the specified service are not consistent (e.g. lacks a DNS-SD service type when resolved)."),
419 &vl_error_InconsistentServiceRecords,
420 SD_VARLINK_SYMBOL_COMMENT("The service is explicitly not provided on the queried domain (RFC 2782 root domain SRV record)."),
421 &vl_error_ServiceNotProvided);