src/transport/transport_api_address_to_string.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2009, 2010 Christian Grothoff (and other contributing authors)
   4
   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 3, or (at your
   8      option) any later version.
   9
  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.
  14
  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.
  19 */
  20 #include "platform.h"
  21 #include "gnunet_util_lib.h"
  22 #include "gnunet_arm_service.h"
  23 #include "gnunet_hello_lib.h"
  24 #include "gnunet_protocols.h"
  25 #include "gnunet_transport_service.h"
  26 #include "transport.h"
  27
  28 /**
  29  * Context for the address lookup.
  30  */
  31 struct GNUNET_TRANSPORT_AddressToStringContext
  32 {
  33   /**
  34    * Function to call with the human-readable address.
  35    */
  36   GNUNET_TRANSPORT_AddressToStringCallback cb;
  37
  38   /**
  39    * Closure for cb.
  40    */
  41   void *cb_cls;
  42
  43   /**
  44    * Connection to the service.
  45    */
  46   struct GNUNET_CLIENT_Connection *client;
  47
  48   /**
  49    * When should this operation time out?
  50    */
  51   struct GNUNET_TIME_Absolute timeout;
  52 };
  53
  54
  55 /**
  56  * Function called with responses from the service.
  57  *
  58  * @param cls our 'struct GNUNET_TRANSPORT_AddressToStringContext*'
  59  * @param msg NULL on timeout or error, otherwise presumably a
  60  *        message with the human-readable address
  61  */
  62 static void
  63 address_response_processor (void *cls, const struct GNUNET_MessageHeader *msg)
  64 {
  65   struct GNUNET_TRANSPORT_AddressToStringContext *alucb = cls;
  66   struct AddressToStringResultMessage *atsm;
  67   const char *address;
  68   uint16_t size;
  69   uint32_t result;
  70   uint32_t addr_len;
  71   char *empty_str = "";
  72
  73   if (msg == NULL)
  74   {
  75     alucb->cb (alucb->cb_cls, NULL, GNUNET_OK);
  76     GNUNET_CLIENT_disconnect (alucb->client);
  77     GNUNET_free (alucb);
  78     return;
  79   }
  80   GNUNET_break (ntohs (msg->type) ==
  81                 GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_TO_STRING_REPLY);
  82
  83   size = ntohs (msg->size);
  84   if (size < sizeof (struct AddressToStringResultMessage))
  85   {
  86     alucb->cb (alucb->cb_cls, NULL, GNUNET_OK);
  87     GNUNET_CLIENT_disconnect (alucb->client);
  88     GNUNET_free (alucb);
  89     return;
  90   }
  91   atsm = (struct AddressToStringResultMessage *) msg;
  92
  93   result = ntohl (atsm->res);
  94   addr_len = ntohl (atsm->addr_len);
  95
  96   if (size == (sizeof (struct AddressToStringResultMessage)))
  97   {
  98     /* done, success depends on result */
  99     alucb->cb (alucb->cb_cls, NULL, result);
 100     GNUNET_CLIENT_disconnect (alucb->client);
 101     GNUNET_free (alucb);
 102     return;
 103   }
 104
 105   if (GNUNET_NO == result)
 106   {
 107     alucb->cb (alucb->cb_cls, NULL, GNUNET_SYSERR);
 108
 109     /* expect more replies */
 110     GNUNET_CLIENT_receive (alucb->client, &address_response_processor, alucb,
 111                            GNUNET_TIME_absolute_get_remaining (alucb->timeout));
 112     return;
 113   }
 114
 115
 116   address = (const char *) &atsm[1];
 117   if ( (addr_len > (size - (sizeof (struct AddressToStringResultMessage)))) ||
 118        (address[addr_len -1] != '\0') )
 119   {
 120     /* invalid reply */
 121     GNUNET_break (0);
 122     alucb->cb (alucb->cb_cls, NULL, GNUNET_SYSERR);
 123     GNUNET_CLIENT_disconnect (alucb->client);
 124     GNUNET_free (alucb);
 125     return;
 126   }
 127
 128   result = GNUNET_NO;
 129
 130   /* expect more replies */
 131   GNUNET_CLIENT_receive (alucb->client, &address_response_processor, alucb,
 132                          GNUNET_TIME_absolute_get_remaining (alucb->timeout));
 133
 134   if (GNUNET_NO == result)
 135   {
 136     alucb->cb (alucb->cb_cls, empty_str, GNUNET_SYSERR);
 137   }
 138   else
 139   {
 140     alucb->cb (alucb->cb_cls, address, GNUNET_OK);
 141   }
 142 }
 143
 144
 145 /**
 146  * Convert a binary address into a human readable address.
 147  *
 148  * @param cfg configuration to use
 149  * @param address address to convert (binary format)
 150  * @param numeric should (IP) addresses be displayed in numeric form
 151  *                (otherwise do reverse DNS lookup)
 152  * @param timeout how long is the lookup allowed to take at most
 153  * @param aluc function to call with the results
 154  * @param aluc_cls closure for aluc
 155  * @return handle to cancel the operation, NULL on error
 156  */
 157 struct GNUNET_TRANSPORT_AddressToStringContext *
 158 GNUNET_TRANSPORT_address_to_string (const struct GNUNET_CONFIGURATION_Handle
 159                                     *cfg,
 160                                     const struct GNUNET_HELLO_Address *address,
 161                                     int numeric,
 162                                     struct GNUNET_TIME_Relative timeout,
 163                                     GNUNET_TRANSPORT_AddressToStringCallback
 164                                     aluc, void *aluc_cls)
 165 {
 166   size_t len;
 167   size_t alen;
 168   size_t slen;
 169   struct AddressLookupMessage *msg;
 170   struct GNUNET_TRANSPORT_AddressToStringContext *alc;
 171   struct GNUNET_CLIENT_Connection *client;
 172   char *addrbuf;
 173
 174   GNUNET_assert (address != NULL);
 175   alen = address->address_length;
 176   slen = strlen (address->transport_name) + 1;
 177   len = sizeof (struct AddressLookupMessage) + alen + slen;
 178   if (len >= GNUNET_SERVER_MAX_MESSAGE_SIZE)
 179   {
 180     GNUNET_break (0);
 181     return NULL;
 182   }
 183   client = GNUNET_CLIENT_connect ("transport", cfg);
 184   if (NULL == client)
 185     return NULL;
 186   msg = GNUNET_malloc (len);
 187   msg->header.size = htons (len);
 188   msg->header.type = htons (GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_TO_STRING);
 189   msg->numeric_only = htons ((int16_t) numeric);
 190   msg->addrlen = htons ((uint16_t) alen);
 191   msg->timeout = GNUNET_TIME_relative_hton (timeout);
 192   addrbuf = (char *) &msg[1];
 193   memcpy (addrbuf, address->address, alen);
 194   memcpy (&addrbuf[alen], address->transport_name, slen);
 195
 196   alc = GNUNET_new (struct GNUNET_TRANSPORT_AddressToStringContext);
 197   alc->cb = aluc;
 198   alc->cb_cls = aluc_cls;
 199   alc->timeout = GNUNET_TIME_relative_to_absolute (timeout);
 200   alc->client = client;
 201   GNUNET_assert (GNUNET_OK ==
 202                  GNUNET_CLIENT_transmit_and_get_response (client, &msg->header,
 203                                                           timeout, GNUNET_YES,
 204                                                           &address_response_processor,
 205                                                           alc));
 206   GNUNET_free (msg);
 207   return alc;
 208 }
 209
 210
 211 /**
 212  * Cancel request for address conversion.
 213  *
 214  * @param pic the context handle
 215  */
 216 void
 217 GNUNET_TRANSPORT_address_to_string_cancel (struct
 218                                            GNUNET_TRANSPORT_AddressToStringContext
 219                                            *pic)
 220 {
 221   GNUNET_CLIENT_disconnect (pic->client);
 222   GNUNET_free (pic);
 223 }
 224
 225
 226
 227 /* end of transport_api_address_to_string.c */