2 This file is part of GNUnet.
3 (C) 2009 Christian Grothoff (and other contributing authors)
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 2, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
22 * @file util/resolver_api.c
23 * @brief resolver for writing a tool
24 * @author Christian Grothoff
27 #include "gnunet_getopt_lib.h"
28 #include "gnunet_client_lib.h"
29 #include "gnunet_protocols.h"
30 #include "gnunet_resolver_service.h"
31 #include "gnunet_server_lib.h"
36 * Maximum supported length for a hostname
38 #define MAX_HOSTNAME 1024
42 * Possible hostnames for "loopback".
44 static const char *loopback[] = {
52 * Handle to a request given to the resolver. Can be used to cancel
53 * the request prior to the timeout or successful execution. Also
54 * used to track our internal state for the request.
56 struct GNUNET_RESOLVER_RequestHandle
60 * Callback if this is an name resolution request,
63 GNUNET_RESOLVER_AddressCallback addr_callback;
66 * Callback if this is a reverse lookup request,
69 GNUNET_RESOLVER_HostnameCallback name_callback;
72 * Closure for the respective "callback".
77 * Our connection to the resolver service.
79 struct GNUNET_CLIENT_Connection *client;
84 struct GNUNET_SCHEDULER_Handle *sched;
87 * Name of the host that we are resolving.
92 * When should this request time out?
94 struct GNUNET_TIME_Absolute timeout;
97 * Task handle for numeric lookups.
99 GNUNET_SCHEDULER_TaskIdentifier task;
102 * Desired address family.
107 * Length of the "struct sockaddr" that follows this
108 * struct (only for reverse lookup).
115 * Check that the resolver service runs on localhost
119 check_config (const struct GNUNET_CONFIGURATION_Handle *cfg)
123 struct sockaddr_in v4;
124 struct sockaddr_in6 v6;
126 memset (&v4, 0, sizeof (v4));
127 v4.sin_addr.s_addr = htonl (INADDR_LOOPBACK);
128 v4.sin_family = AF_INET;
129 #if HAVE_SOCKADDR_IN_SIN_LEN
130 v4.sin_len = sizeof (v4);
132 memset (&v6, 0, sizeof (v6));
133 v6.sin6_family = AF_INET6;
134 #if HAVE_SOCKADDR_IN_SIN_LEN
135 v6.sin6_len = sizeof (v6);
138 GNUNET_CONFIGURATION_get_value_string (cfg,
140 "HOSTNAME", &hostname))
142 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
143 _("Must specify `%s' for `%s' in configuration!\n"),
144 "HOSTNAME", "resolver");
147 if ((1 != inet_pton (AF_INET,
149 &v4)) || (1 != inet_pton (AF_INET6, hostname, &v6)))
151 GNUNET_free (hostname);
155 while (loopback[i] != NULL)
156 if (0 == strcasecmp (loopback[i++], hostname))
158 GNUNET_free (hostname);
161 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
163 ("Must specify `%s' or numeric IP address for `%s' of `%s' in configuration!\n"),
164 "localhost", "HOSTNAME", "resolver");
165 GNUNET_free (hostname);
171 * Convert IP address to string without DNS resolution.
173 * @param sa the address
174 * @param salen number of bytes in sa
175 * @return address as a string, NULL on error
178 no_resolve (const struct sockaddr *sa, socklen_t salen)
181 char inet4[INET_ADDRSTRLEN];
182 char inet6[INET6_ADDRSTRLEN];
184 if (salen < sizeof (struct sockaddr))
186 switch (sa->sa_family)
189 if (salen != sizeof (struct sockaddr_in))
192 &((struct sockaddr_in *) sa)->sin_addr,
193 inet4, INET_ADDRSTRLEN);
194 ret = GNUNET_strdup (inet4);
197 if (salen != sizeof (struct sockaddr_in6))
200 &((struct sockaddr_in6 *) sa)->sin6_addr,
201 inet6, INET6_ADDRSTRLEN);
202 ret = GNUNET_strdup (inet6);
213 * Process the reply from the resolver (which is presumably
214 * the numeric IP address for a name resolution request).
216 * @param cls the "GNUNET_RESOLVER_RequestHandle" for which this is a reply
217 * @param msg reply from the resolver or NULL on error
220 handle_address_response (void *cls, const struct GNUNET_MessageHeader *msg)
222 struct GNUNET_RESOLVER_RequestHandle *rh = cls;
224 const struct sockaddr *sa;
230 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
231 _("Timeout trying to resolve hostname.\n"));
232 rh->addr_callback (rh->cls, NULL, 0);
233 GNUNET_CLIENT_disconnect (rh->client);
237 if (GNUNET_MESSAGE_TYPE_RESOLVER_RESPONSE != ntohs (msg->type))
240 rh->addr_callback (rh->cls, NULL, 0);
241 GNUNET_CLIENT_disconnect (rh->client);
246 size = ntohs (msg->size);
247 if (size == sizeof (struct GNUNET_MessageHeader))
250 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
251 _("Received end message resolving hostname.\n"));
253 rh->addr_callback (rh->cls, NULL, 0);
254 GNUNET_CLIENT_disconnect (rh->client);
258 sa = (const struct sockaddr *) &msg[1];
259 salen = size - sizeof (struct GNUNET_MessageHeader);
260 if (salen < sizeof (struct sockaddr))
263 rh->addr_callback (rh->cls, NULL, 0);
264 GNUNET_CLIENT_disconnect (rh->client);
270 char *ips = no_resolve (sa, salen);
271 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Resolver returns `%s'.\n", ips);
275 rh->addr_callback (rh->cls, sa, salen);
276 GNUNET_CLIENT_receive (rh->client,
277 &handle_address_response,
279 GNUNET_TIME_absolute_get_remaining (rh->timeout));
284 * We've been asked to lookup the address for a hostname and were
285 * given a valid numeric string. Perform the callbacks for the
288 * @param cls struct GNUNET_RESOLVER_RequestHandle for the request
289 * @param tc unused scheduler context
292 numeric_resolution (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
294 struct GNUNET_RESOLVER_RequestHandle *rh = cls;
295 struct sockaddr_in v4;
296 struct sockaddr_in6 v6;
298 memset (&v4, 0, sizeof (v4));
299 v4.sin_family = AF_INET;
300 #if HAVE_SOCKADDR_IN_SIN_LEN
301 v4.sin_len = sizeof (v4);
303 memset (&v6, 0, sizeof (v6));
304 v6.sin6_family = AF_INET6;
305 #if HAVE_SOCKADDR_IN_SIN_LEN
306 v6.sin6_len = sizeof (v6);
309 if (((rh->domain == AF_UNSPEC) || (rh->domain == AF_INET)) &&
310 (1 == inet_pton (AF_INET, rh->hostname, &v4.sin_addr)))
312 rh->addr_callback (rh->cls, (const struct sockaddr *) &v4, sizeof (v4));
313 if ((rh->domain == AF_UNSPEC) &&
314 (1 == inet_pton (AF_INET6, rh->hostname, &v6.sin6_addr)))
316 /* this can happen on some systems IF "hostname" is "localhost" */
317 rh->addr_callback (rh->cls,
318 (const struct sockaddr *) &v6, sizeof (v6));
320 rh->addr_callback (rh->cls, NULL, 0);
324 if (((rh->domain == AF_UNSPEC) || (rh->domain == AF_INET6)) &&
325 (1 == inet_pton (AF_INET6, rh->hostname, &v6.sin6_addr)))
327 rh->addr_callback (rh->cls, (const struct sockaddr *) &v6, sizeof (v6));
328 rh->addr_callback (rh->cls, NULL, 0);
332 /* why are we here? this task should not have been scheduled! */
340 * We've been asked to lookup the address for a hostname and were
341 * given a variant of "loopback". Perform the callbacks for the
342 * respective loopback numeric addresses.
344 * @param cls struct GNUNET_RESOLVER_RequestHandle for the request
345 * @param tc unused scheduler context
348 loopback_resolution (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
350 struct GNUNET_RESOLVER_RequestHandle *rh = cls;
351 struct sockaddr_in v4;
352 struct sockaddr_in6 v6;
354 memset (&v4, 0, sizeof (v4));
355 v4.sin_addr.s_addr = htonl (INADDR_LOOPBACK);
356 v4.sin_family = AF_INET;
357 #if HAVE_SOCKADDR_IN_SIN_LEN
358 v4.sin_len = sizeof (v4);
360 memset (&v6, 0, sizeof (v6));
361 v6.sin6_family = AF_INET6;
362 #if HAVE_SOCKADDR_IN_SIN_LEN
363 v6.sin6_len = sizeof (v6);
365 v6.sin6_addr = in6addr_loopback;
369 rh->addr_callback (rh->cls, (const struct sockaddr *) &v4, sizeof (v4));
372 rh->addr_callback (rh->cls, (const struct sockaddr *) &v6, sizeof (v6));
375 rh->addr_callback (rh->cls, (const struct sockaddr *) &v6, sizeof (v6));
376 rh->addr_callback (rh->cls, (const struct sockaddr *) &v4, sizeof (v4));
382 rh->addr_callback (rh->cls, NULL, 0);
388 * Convert a string to one or more IP addresses.
390 * @param sched scheduler to use
391 * @param cfg configuration to use
392 * @param hostname the hostname to resolve
393 * @param domain AF_INET or AF_INET6; use AF_UNSPEC for "any"
394 * @param callback function to call with addresses
395 * @param callback_cls closure for callback
396 * @param timeout how long to try resolving
397 * @return handle that can be used to cancel the request, NULL on error
399 struct GNUNET_RESOLVER_RequestHandle *
400 GNUNET_RESOLVER_ip_get (struct GNUNET_SCHEDULER_Handle *sched,
401 const struct GNUNET_CONFIGURATION_Handle *cfg,
402 const char *hostname,
404 struct GNUNET_TIME_Relative timeout,
405 GNUNET_RESOLVER_AddressCallback callback,
408 struct GNUNET_CLIENT_Connection *client;
409 struct GNUNET_RESOLVER_GetMessage *msg;
410 struct GNUNET_RESOLVER_RequestHandle *rh;
415 char buf[GNUNET_SERVER_MAX_MESSAGE_SIZE];
418 slen = strlen (hostname) + 1;
419 if (slen + sizeof (struct GNUNET_RESOLVER_GetMessage) >
420 GNUNET_SERVER_MAX_MESSAGE_SIZE)
425 rh = GNUNET_malloc (sizeof (struct GNUNET_RESOLVER_RequestHandle) + slen);
428 rh->addr_callback = callback;
429 rh->cls = callback_cls;
430 memcpy (&rh[1], hostname, slen);
431 rh->hostname = (const char *) &rh[1];
432 rh->timeout = GNUNET_TIME_relative_to_absolute (timeout);
434 /* first, check if this is a numeric address */
435 if (((1 == inet_pton (AF_INET,
438 ((domain == AF_INET) || (domain == AF_UNSPEC))) ||
439 ((1 == inet_pton (AF_INET6,
442 ((domain == AF_INET6) || (domain == AF_UNSPEC))))
444 rh->task = GNUNET_SCHEDULER_add_delayed (sched,
445 GNUNET_TIME_UNIT_ZERO,
446 &numeric_resolution, rh);
449 /* then, check if this is a loopback address */
451 while (loopback[i] != NULL)
452 if (0 == strcasecmp (loopback[i++], hostname))
454 rh->task = GNUNET_SCHEDULER_add_delayed (sched,
455 GNUNET_TIME_UNIT_ZERO,
456 &loopback_resolution, rh);
460 client = GNUNET_CLIENT_connect (sched, "resolver", cfg);
468 msg = (struct GNUNET_RESOLVER_GetMessage *) buf;
470 htons (sizeof (struct GNUNET_RESOLVER_GetMessage) + slen);
471 msg->header.type = htons (GNUNET_MESSAGE_TYPE_RESOLVER_REQUEST);
472 msg->direction = htonl (GNUNET_NO);
473 msg->domain = htonl (domain);
474 memcpy (&msg[1], hostname, slen);
477 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
478 _("Resolver requests DNS resolution of hostname `%s'.\n"),
482 GNUNET_CLIENT_transmit_and_get_response (client,
486 &handle_address_response, rh))
489 GNUNET_CLIENT_disconnect (client);
497 * Process response with a hostname for a reverse DNS lookup.
499 * @param cls our "struct GNUNET_RESOLVER_RequestHandle" context
500 * @param msg message with the hostname, NULL on error
503 handle_hostname_response (void *cls, const struct GNUNET_MessageHeader *msg)
505 struct GNUNET_RESOLVER_RequestHandle *rh = cls;
507 const char *hostname;
511 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
512 _("Timeout trying to resolve IP address.\n"));
513 rh->name_callback (rh->cls, NULL);
514 GNUNET_CLIENT_disconnect (rh->client);
518 size = ntohs (msg->size);
519 if (size == sizeof (struct GNUNET_MessageHeader))
522 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
523 _("Received end message resolving IP address.\n"));
525 rh->name_callback (rh->cls, NULL);
526 GNUNET_CLIENT_disconnect (rh->client);
530 hostname = (const char *) &msg[1];
531 if (hostname[size - sizeof (struct GNUNET_MessageHeader) - 1] != '\0')
534 rh->name_callback (rh->cls, NULL);
535 GNUNET_CLIENT_disconnect (rh->client);
540 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
541 _("Resolver returns `%s'.\n"), hostname);
543 rh->name_callback (rh->cls, hostname);
544 GNUNET_CLIENT_receive (rh->client,
545 &handle_hostname_response,
547 GNUNET_TIME_absolute_get_remaining (rh->timeout));
553 * We've been asked to convert an address to a string without
554 * a reverse lookup. Do it.
556 * @param cls struct GNUNET_RESOLVER_RequestHandle for the request
557 * @param tc unused scheduler context
560 numeric_reverse (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
562 struct GNUNET_RESOLVER_RequestHandle *rh = cls;
565 result = no_resolve ((const struct sockaddr *) &rh[1], rh->salen);
567 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, _("Resolver returns `%s'.\n"), result);
571 rh->name_callback (rh->cls, result);
572 GNUNET_free (result);
574 rh->name_callback (rh->cls, NULL);
581 * Get an IP address as a string.
583 * @param sched scheduler to use
584 * @param cfg configuration to use
585 * @param sa host address
586 * @param salen length of host address
587 * @param do_resolve use GNUNET_NO to return numeric hostname
588 * @param timeout how long to try resolving
589 * @param callback function to call with hostnames
590 * @param cls closure for callback
591 * @return handle that can be used to cancel the request
593 struct GNUNET_RESOLVER_RequestHandle *
594 GNUNET_RESOLVER_hostname_get (struct GNUNET_SCHEDULER_Handle *sched,
595 const struct GNUNET_CONFIGURATION_Handle *cfg,
596 const struct sockaddr *sa,
599 struct GNUNET_TIME_Relative timeout,
600 GNUNET_RESOLVER_HostnameCallback callback,
603 struct GNUNET_CLIENT_Connection *client;
604 struct GNUNET_RESOLVER_GetMessage *msg;
605 struct GNUNET_RESOLVER_RequestHandle *rh;
606 char buf[GNUNET_SERVER_MAX_MESSAGE_SIZE];
609 rh = GNUNET_malloc (sizeof (struct GNUNET_RESOLVER_RequestHandle) + salen);
610 rh->name_callback = callback;
612 rh->timeout = GNUNET_TIME_relative_to_absolute (timeout);
615 memcpy (&rh[1], sa, salen);
617 if (GNUNET_NO == do_resolve)
619 rh->task = GNUNET_SCHEDULER_add_delayed (sched,
620 GNUNET_TIME_UNIT_ZERO,
621 &numeric_reverse, rh);
624 if (salen + sizeof (struct GNUNET_RESOLVER_GetMessage) >
625 GNUNET_SERVER_MAX_MESSAGE_SIZE)
631 client = GNUNET_CLIENT_connect (sched, "resolver", cfg);
639 msg = (struct GNUNET_RESOLVER_GetMessage *) buf;
641 htons (sizeof (struct GNUNET_RESOLVER_GetMessage) + salen);
642 msg->header.type = htons (GNUNET_MESSAGE_TYPE_RESOLVER_REQUEST);
643 msg->direction = htonl (GNUNET_YES);
644 msg->domain = htonl (sa->sa_family);
645 memcpy (&msg[1], sa, salen);
647 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
648 _("Resolver requests DNS resolution of IP address.\n"));
651 GNUNET_CLIENT_transmit_and_get_response (client,
655 &handle_hostname_response, rh))
657 GNUNET_CLIENT_disconnect (client);
666 * Perform a reverse DNS lookup.
668 * @param sched scheduler to use
669 * @param cfg configuration to use
670 * @param domain AF_INET or AF_INET6; use AF_UNSPEC for "any"
671 * @param callback function to call with addresses
672 * @param cls closure for callback
673 * @param timeout how long to try resolving
674 * @return handle that can be used to cancel the request, NULL on error
676 struct GNUNET_RESOLVER_RequestHandle *
677 GNUNET_RESOLVER_hostname_resolve (struct GNUNET_SCHEDULER_Handle *sched,
678 const struct GNUNET_CONFIGURATION_Handle
680 struct GNUNET_TIME_Relative timeout,
681 GNUNET_RESOLVER_AddressCallback callback,
684 char hostname[MAX_HOSTNAME];
687 if (0 != gethostname (hostname, sizeof (hostname) - 1))
689 GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR |
690 GNUNET_ERROR_TYPE_BULK, "gethostname");
694 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
695 _("Resolving our hostname `%s'\n"), hostname);
697 return GNUNET_RESOLVER_ip_get (sched,
698 cfg, hostname, domain, timeout, callback,
704 * Cancel a request that is still pending with the resolver.
705 * Note that a client MUST NOT cancel a request that has
706 * been completed (i.e, the callback has been called to
707 * signal timeout or the final result).
709 * @param h handle of request to cancel
712 GNUNET_RESOLVER_request_cancel (struct GNUNET_RESOLVER_RequestHandle *h)
714 if (h->client != NULL)
715 GNUNET_CLIENT_disconnect (h->client);
716 if (h->task != GNUNET_SCHEDULER_NO_TASK)
717 GNUNET_SCHEDULER_cancel (h->sched, h->task);
723 /* end of resolver_api.c */