1 /* Upcall routine, designed to work as a key type and working through
2 * /sbin/request-key to contact userspace when handling DNS queries.
4 * See Documentation/networking/dns_resolver.txt
6 * Copyright (c) 2007 Igor Mammedov
7 * Author(s): Igor Mammedov (niallain@gmail.com)
8 * Steve French (sfrench@us.ibm.com)
9 * Wang Lei (wang840925@gmail.com)
10 * David Howells (dhowells@redhat.com)
12 * The upcall wrapper used to make an arbitrary DNS query.
14 * This function requires the appropriate userspace tool dns.upcall to be
15 * installed and something like the following lines should be added to the
16 * /etc/request-key.conf file:
18 * create dns_resolver * * /sbin/dns.upcall %k
20 * For example to use this module to query AFSDB RR:
22 * create dns_resolver afsdb:* * /sbin/dns.afsdb %k
24 * This library is free software; you can redistribute it and/or modify
25 * it under the terms of the GNU Lesser General Public License as published
26 * by the Free Software Foundation; either version 2.1 of the License, or
27 * (at your option) any later version.
29 * This library is distributed in the hope that it will be useful,
30 * but WITHOUT ANY WARRANTY; without even the implied warranty of
31 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
32 * the GNU Lesser General Public License for more details.
34 * You should have received a copy of the GNU Lesser General Public License
35 * along with this library; if not, see <http://www.gnu.org/licenses/>.
38 #include <linux/module.h>
39 #include <linux/slab.h>
40 #include <linux/cred.h>
41 #include <linux/dns_resolver.h>
42 #include <linux/err.h>
43 #include <net/net_namespace.h>
45 #include <keys/dns_resolver-type.h>
46 #include <keys/user-type.h>
51 * dns_query - Query the DNS
52 * @net: The network namespace to operate in.
53 * @type: Query type (or NULL for straight host->IP lookup)
54 * @name: Name to look up
55 * @namelen: Length of name
56 * @options: Request options (or NULL if no options)
57 * @_result: Where to place the returned data (or NULL)
58 * @_expiry: Where to store the result expiry time (or NULL)
59 * @invalidate: Always invalidate the key after use
61 * The data will be returned in the pointer at *result, if provided, and the
62 * caller is responsible for freeing it.
64 * The description should be of the form "[<query_type>:]<domain_name>", and
65 * the options need to be appropriate for the query type requested. If no
66 * query_type is given, then the query is a straight hostname to IP address
69 * The DNS resolution lookup is performed by upcalling to userspace by way of
70 * requesting a key of type dns_resolver.
72 * Returns the size of the result on success, -ve error code otherwise.
74 int dns_query(struct net
*net
,
75 const char *type
, const char *name
, size_t namelen
,
76 const char *options
, char **_result
, time64_t
*_expiry
,
80 struct user_key_payload
*upayload
;
81 const struct cred
*saved_cred
;
82 size_t typelen
, desclen
;
86 kenter("%s,%*.*s,%zu,%s",
87 type
, (int)namelen
, (int)namelen
, name
, namelen
, options
);
89 if (!name
|| namelen
== 0)
92 /* construct the query key description as "[<type>:]<name>" */
96 typelen
= strlen(type
);
99 desclen
+= typelen
+ 1;
102 if (namelen
< 3 || namelen
> 255)
104 desclen
+= namelen
+ 1;
106 desc
= kmalloc(desclen
, GFP_KERNEL
);
112 memcpy(cp
, type
, typelen
);
116 memcpy(cp
, name
, namelen
);
122 kdebug("call request_key(,%s,%s)", desc
, options
);
124 /* make the upcall, using special credentials to prevent the use of
125 * add_key() to preinstall malicious redirections
127 saved_cred
= override_creds(dns_resolver_cache
);
128 rkey
= request_key_net(&key_type_dns_resolver
, desc
, net
, options
);
129 revert_creds(saved_cred
);
136 down_read(&rkey
->sem
);
137 set_bit(KEY_FLAG_ROOT_CAN_INVAL
, &rkey
->flags
);
138 rkey
->perm
|= KEY_USR_VIEW
;
140 ret
= key_validate(rkey
);
144 /* If the DNS server gave an error, return that to the caller */
145 ret
= PTR_ERR(rkey
->payload
.data
[dns_key_error
]);
149 upayload
= user_key_payload_locked(rkey
);
150 len
= upayload
->datalen
;
154 *_result
= kmemdup_nul(upayload
->data
, len
, GFP_KERNEL
);
160 *_expiry
= rkey
->expiry
;
166 key_invalidate(rkey
);
169 kleave(" = %d", ret
);
172 EXPORT_SYMBOL(dns_query
);