1 /* Key type used to cache DNS lookups made by the kernel
3 * See Documentation/networking/dns_resolver.txt
5 * Copyright (c) 2007 Igor Mammedov
6 * Author(s): Igor Mammedov (niallain@gmail.com)
7 * Steve French (sfrench@us.ibm.com)
8 * Wang Lei (wang840925@gmail.com)
9 * David Howells (dhowells@redhat.com)
11 * This library is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU Lesser General Public License as published
13 * by the Free Software Foundation; either version 2.1 of the License, or
14 * (at your option) any later version.
16 * This library is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
19 * the GNU Lesser General Public License for more details.
21 * You should have received a copy of the GNU Lesser General Public License
22 * along with this library; if not, see <http://www.gnu.org/licenses/>.
24 #include <linux/module.h>
25 #include <linux/moduleparam.h>
26 #include <linux/slab.h>
27 #include <linux/string.h>
28 #include <linux/kernel.h>
29 #include <linux/keyctl.h>
30 #include <linux/err.h>
31 #include <linux/seq_file.h>
32 #include <linux/dns_resolver.h>
33 #include <keys/dns_resolver-type.h>
34 #include <keys/user-type.h>
37 MODULE_DESCRIPTION("DNS Resolver");
38 MODULE_AUTHOR("Wang Lei");
39 MODULE_LICENSE("GPL");
41 unsigned int dns_resolver_debug;
42 module_param_named(debug, dns_resolver_debug, uint, 0644);
43 MODULE_PARM_DESC(debug, "DNS Resolver debugging mask");
45 const struct cred *dns_resolver_cache;
47 #define DNS_ERRORNO_OPTION "dnserror"
49 static struct key_acl dns_keyring_acl = {
50 .usage = REFCOUNT_INIT(1),
53 KEY_POSSESSOR_ACE(KEY_ACE_SEARCH | KEY_ACE_WRITE),
54 KEY_OWNER_ACE(KEY_ACE_VIEW | KEY_ACE_READ | KEY_ACE_CLEAR),
59 * Preparse instantiation data for a dns_resolver key.
61 * For normal hostname lookups, the data must be a NUL-terminated string, with
62 * the NUL char accounted in datalen.
64 * If the data contains a '#' characters, then we take the clause after each
65 * one to be an option of the form 'key=value'. The actual data of interest is
66 * the string leading up to the first '#'. For instance:
68 * "ip1,ip2,...#foo=bar"
70 * For server list requests, the data must begin with a NUL char and be
71 * followed by a byte indicating the version of the data format. Version 1
72 * looks something like (note this is packed):
74 * u8 Non-string marker (ie. 0)
75 * u8 Content (DNS_PAYLOAD_IS_*)
77 * u8 Source of server list
78 * u8 Lookup status of server list
79 * u8 Number of servers
82 * __le16 Priority (as per SRV record, low first)
83 * __le16 Weight (as per SRV record, higher first)
85 * u8 Source of address list
86 * u8 Lookup status of address list
87 * u8 Protocol (DNS_SERVER_PROTOCOL_*)
88 * u8 Number of addresses
89 * char[] Name (not NUL-terminated)
91 * u8 Family (DNS_ADDRESS_IS_*)
101 dns_resolver_preparse(struct key_preparsed_payload *prep)
103 const struct dns_payload_header *bin;
104 struct user_key_payload *upayload;
105 unsigned long derrno;
107 int datalen = prep->datalen, result_len = 0;
108 const char *data = prep->data, *end, *opt;
110 if (datalen <= 1 || !data)
114 /* It may be a server list. */
115 if (datalen <= sizeof(*bin))
118 bin = (const struct dns_payload_header *)data;
119 kenter("[%u,%u],%u", bin->content, bin->version, datalen);
120 if (bin->content != DNS_PAYLOAD_IS_SERVER_LIST) {
122 "dns_resolver: Unsupported content type (%u)\n",
127 if (bin->version != 1) {
129 "dns_resolver: Unsupported server list version (%u)\n",
134 result_len = datalen;
138 kenter("'%*.*s',%u", datalen, datalen, data, datalen);
140 if (!data || data[datalen - 1] != '\0')
144 /* deal with any options embedded in the data */
145 end = data + datalen;
146 opt = memchr(data, '#', datalen);
148 /* no options: the entire data is the result */
149 kdebug("no options");
150 result_len = datalen;
152 const char *next_opt;
154 result_len = opt - data;
156 kdebug("options: '%s'", opt);
158 int opt_len, opt_nlen;
162 next_opt = memchr(opt, '#', end - opt) ?: end;
163 opt_len = next_opt - opt;
164 if (opt_len <= 0 || opt_len > sizeof(optval)) {
165 pr_warn_ratelimited("Invalid option length (%d) for dns_resolver key\n",
170 eq = memchr(opt, '=', opt_len);
174 memcpy(optval, eq, next_opt - eq);
175 optval[next_opt - eq] = '\0';
181 kdebug("option '%*.*s' val '%s'",
182 opt_nlen, opt_nlen, opt, optval);
184 /* see if it's an error number representing a DNS error
185 * that's to be recorded as the result in this key */
186 if (opt_nlen == sizeof(DNS_ERRORNO_OPTION) - 1 &&
187 memcmp(opt, DNS_ERRORNO_OPTION, opt_nlen) == 0) {
188 kdebug("dns error number option");
190 ret = kstrtoul(optval, 10, &derrno);
192 goto bad_option_value;
194 if (derrno < 1 || derrno > 511)
195 goto bad_option_value;
197 kdebug("dns error no. = %lu", derrno);
198 prep->payload.data[dns_key_error] = ERR_PTR(-derrno);
203 pr_warn_ratelimited("Option '%*.*s' to dns_resolver key: bad/missing value\n",
204 opt_nlen, opt_nlen, opt);
206 } while (opt = next_opt + 1, opt < end);
209 /* don't cache the result if we're caching an error saying there's no
211 if (prep->payload.data[dns_key_error]) {
212 kleave(" = 0 [h_error %ld]", PTR_ERR(prep->payload.data[dns_key_error]));
217 kdebug("store result");
218 prep->quotalen = result_len;
220 upayload = kmalloc(sizeof(*upayload) + result_len + 1, GFP_KERNEL);
222 kleave(" = -ENOMEM");
226 upayload->datalen = result_len;
227 memcpy(upayload->data, data, result_len);
228 upayload->data[result_len] = '\0';
230 prep->payload.data[dns_key_data] = upayload;
236 * Clean up the preparse data
238 static void dns_resolver_free_preparse(struct key_preparsed_payload *prep)
240 pr_devel("==>%s()\n", __func__);
242 kfree(prep->payload.data[dns_key_data]);
246 * The description is of the form "[<type>:]<domain_name>"
248 * The domain name may be a simple name or an absolute domain name (which
249 * should end with a period). The domain name is case-independent.
251 static bool dns_resolver_cmp(const struct key *key,
252 const struct key_match_data *match_data)
254 int slen, dlen, ret = 0;
255 const char *src = key->description, *dsp = match_data->raw_data;
257 kenter("%s,%s", src, dsp);
262 if (strcasecmp(src, dsp) == 0)
267 if (slen <= 0 || dlen <= 0)
269 if (src[slen - 1] == '.')
271 if (dsp[dlen - 1] == '.')
273 if (slen != dlen || strncasecmp(src, dsp, slen) != 0)
279 kleave(" = %d", ret);
284 * Preparse the match criterion.
286 static int dns_resolver_match_preparse(struct key_match_data *match_data)
288 match_data->lookup_type = KEYRING_SEARCH_LOOKUP_ITERATE;
289 match_data->cmp = dns_resolver_cmp;
296 static void dns_resolver_describe(const struct key *key, struct seq_file *m)
298 seq_puts(m, key->description);
299 if (key_is_positive(key)) {
300 int err = PTR_ERR(key->payload.data[dns_key_error]);
303 seq_printf(m, ": %d", err);
305 seq_printf(m, ": %u", key->datalen);
311 * - the key's semaphore is read-locked
313 static long dns_resolver_read(const struct key *key,
314 char __user *buffer, size_t buflen)
316 int err = PTR_ERR(key->payload.data[dns_key_error]);
321 return user_read(key, buffer, buflen);
324 struct key_type key_type_dns_resolver = {
325 .name = "dns_resolver",
326 .flags = KEY_TYPE_NET_DOMAIN,
327 .preparse = dns_resolver_preparse,
328 .free_preparse = dns_resolver_free_preparse,
329 .instantiate = generic_key_instantiate,
330 .match_preparse = dns_resolver_match_preparse,
331 .revoke = user_revoke,
332 .destroy = user_destroy,
333 .describe = dns_resolver_describe,
334 .read = dns_resolver_read,
337 static int __init init_dns_resolver(void)
343 /* create an override credential set with a special thread keyring in
344 * which DNS requests are cached
346 * this is used to prevent malicious redirections from being installed
349 cred = prepare_kernel_cred(NULL);
353 keyring = keyring_alloc(".dns_resolver",
354 GLOBAL_ROOT_UID, GLOBAL_ROOT_GID, cred,
356 KEY_ALLOC_NOT_IN_QUOTA, NULL, NULL);
357 if (IS_ERR(keyring)) {
358 ret = PTR_ERR(keyring);
359 goto failed_put_cred;
362 ret = register_key_type(&key_type_dns_resolver);
366 /* instruct request_key() to use this special keyring as a cache for
367 * the results it looks up */
368 set_bit(KEY_FLAG_ROOT_CAN_CLEAR, &keyring->flags);
369 cred->thread_keyring = keyring;
370 cred->jit_keyring = KEY_REQKEY_DEFL_THREAD_KEYRING;
371 dns_resolver_cache = cred;
373 kdebug("DNS resolver keyring: %d\n", key_serial(keyring));
383 static void __exit exit_dns_resolver(void)
385 key_revoke(dns_resolver_cache->thread_keyring);
386 unregister_key_type(&key_type_dns_resolver);
387 put_cred(dns_resolver_cache);
390 module_init(init_dns_resolver)
391 module_exit(exit_dns_resolver)
392 MODULE_LICENSE("GPL");