new API for shorten key
[oweals/gnunet.git] / src / gns / gns_api.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
21 /**
22  *
23  * @file gns/gns_api.c
24  * @brief library to access the GNS service
25  * @author Martin Schanzenbach
26  */
27
28 #include "platform.h"
29 #include "gnunet_util_lib.h"
30 #include "gnunet_constants.h"
31 #include "gnunet_arm_service.h"
32 #include "gnunet_hello_lib.h"
33 #include "gnunet_protocols.h"
34 #include "gnunet_dht_service.h"
35 #include "gns.h"
36 #include "gnunet_gns_service.h"
37
38 /* TODO into gnunet_protocols */
39 #define GNUNET_MESSAGE_TYPE_GNS_LOOKUP 23
40 #define GNUNET_MESSAGE_TYPE_GNS_LOOKUP_RESULT 24
41 #define GNUNET_MESSAGE_TYPE_GNS_SHORTEN 25
42 #define GNUNET_MESSAGE_TYPE_GNS_SHORTEN_RESULT 26
43 #define GNUNET_MESSAGE_TYPE_GNS_GET_AUTH 27
44 #define GNUNET_MESSAGE_TYPE_GNS_GET_AUTH_RESULT 28
45
46 /**
47  * A QueueEntry.
48  */
49 struct GNUNET_GNS_QueueEntry
50 {
51   /**
52    * DLL
53    */
54   struct GNUNET_GNS_QueueEntry *next;
55   
56   /**
57    * DLL
58    */
59   struct GNUNET_GNS_QueueEntry *prev;
60
61   /* request id */
62   uint32_t r_id;
63   
64   /* handle to gns */
65   struct GNUNET_GNS_Handle *gns_handle;
66   
67   /* processor to call on shorten result */
68   GNUNET_GNS_ShortenResultProcessor shorten_proc;
69   
70   /* processor to call on lookup result */
71   GNUNET_GNS_LookupResultProcessor lookup_proc;
72
73   /* processor to call on authority lookup result */
74   GNUNET_GNS_GetAuthResultProcessor auth_proc;
75   
76   /* processor closure */
77   void *proc_cls;
78   
79 };
80
81
82 /**
83  * Entry in our list of messages to be (re-)transmitted.
84  */
85 struct PendingMessage
86 {
87   /**
88    * This is a doubly-linked list.
89    */
90   struct PendingMessage *prev;
91
92   /**
93    * This is a doubly-linked list.
94    */
95   struct PendingMessage *next;
96
97   /**
98    * Size of the message.
99    */
100   size_t size;
101
102 };
103
104
105 /**
106  * Connection to the GNS service.
107  */
108 struct GNUNET_GNS_Handle
109 {
110
111   /**
112    * Configuration to use.
113    */
114   const struct GNUNET_CONFIGURATION_Handle *cfg;
115
116   /**
117    * Socket (if available).
118    */
119   struct GNUNET_CLIENT_Connection *client;
120
121   /**
122    * Currently pending transmission request (or NULL).
123    */
124   struct GNUNET_CLIENT_TransmitHandle *th;
125   
126   uint32_t r_id;
127   
128   /**
129    * Head of linked list of shorten messages we would like to transmit.
130    */
131   struct PendingMessage *pending_head;
132
133   /**
134    * Tail of linked list of shorten messages we would like to transmit.
135    */
136   struct PendingMessage *pending_tail;
137   
138   /**
139    * Head of linked list of shorten messages we would like to transmit.
140    */
141   struct GNUNET_GNS_QueueEntry *shorten_head;
142
143   /**
144    * Tail of linked list of shorten messages we would like to transmit.
145    */
146   struct GNUNET_GNS_QueueEntry *shorten_tail;
147   
148   /**
149    * Head of linked list of lookup messages we would like to transmit.
150    */
151   struct GNUNET_GNS_QueueEntry *lookup_head;
152
153   /**
154    * Tail of linked list of lookup messages we would like to transmit.
155    */
156   struct GNUNET_GNS_QueueEntry *lookup_tail;
157   
158   /**
159    * Head of linked list of authority lookup messages we would like to transmit.
160    */
161   struct GNUNET_GNS_QueueEntry *get_auth_head;
162
163   /**
164    * Tail of linked list of authority lookup messages we would like to transmit.
165    */
166   struct GNUNET_GNS_QueueEntry *get_auth_tail;
167
168   /**
169    * Reconnect task
170    */
171   GNUNET_SCHEDULER_TaskIdentifier reconnect_task;
172
173   /**
174    * Did we start our receive loop yet?
175    */
176   int in_receive;
177
178   /**
179    * Reconnect necessary
180    */
181   int reconnect;
182 };
183
184 /**
185  * Try to send messages from list of messages to send
186  * @param handle GNS_Handle
187  */
188 static void
189 process_pending_messages (struct GNUNET_GNS_Handle *handle);
190
191
192 /**
193  * Reconnect to GNS service.
194  *
195  * @param h the handle to the namestore service
196  */
197 static void
198 reconnect (struct GNUNET_GNS_Handle *h)
199 {
200   GNUNET_assert (NULL == h->client);
201   GNUNET_log(GNUNET_ERROR_TYPE_DEBUG,
202              "Trying to connect to GNS...\n");
203   h->client = GNUNET_CLIENT_connect ("gns", h->cfg);
204   GNUNET_assert (NULL != h->client);
205 }
206
207 /**
208  * Reconnect to GNS
209  *
210  * @param cls the handle
211  * @param tc task context
212  */
213 static void
214 reconnect_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
215 {
216   struct GNUNET_GNS_Handle *h = cls;
217
218   h->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
219   reconnect (h);
220 }
221
222
223 /**
224  * Disconnect from service and then reconnect.
225  *
226  * @param h our handle
227  */
228 static void
229 force_reconnect (struct GNUNET_GNS_Handle *h)
230 {
231   h->reconnect = GNUNET_NO;
232   GNUNET_CLIENT_disconnect (h->client);
233   h->client = NULL;
234   h->reconnect_task = GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_SECONDS,
235                                                     &reconnect_task,
236                                                     h);
237 }
238
239 /**
240  * Transmit the next pending message, called by notify_transmit_ready
241  */
242 static size_t
243 transmit_pending (void *cls, size_t size, void *buf);
244
245 /**
246  * Handler for messages received from the GNS service
247  *
248  * @param cls the 'struct GNUNET_GNS_Handle'
249  * @param msg the incoming message
250  */
251 static void
252 process_message (void *cls, const struct GNUNET_MessageHeader *msg);
253
254 /**
255  * Try to send messages from list of messages to send
256  */
257 static void
258 process_pending_messages (struct GNUNET_GNS_Handle *handle)
259 {
260   struct PendingMessage *p;
261
262   if (handle->client == NULL)
263   {
264     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
265          "process_pending_messages called, but client is null\n");
266     return;
267   }
268   
269   if (handle->th != NULL)
270     return;
271   
272   if (NULL == (p = handle->pending_head))
273     return;
274   
275   GNUNET_log(GNUNET_ERROR_TYPE_DEBUG,
276              "Trying to transmit %d bytes...\n", p->size);
277
278   handle->th =
279     GNUNET_CLIENT_notify_transmit_ready (handle->client,
280                                          p->size,
281                                          GNUNET_TIME_UNIT_FOREVER_REL,
282                                          GNUNET_NO, &transmit_pending,
283                                          handle);
284   if (NULL != handle->th)
285     return;
286
287   GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
288               "notify_transmit_ready returned NULL!\n");
289 }
290
291
292 /**
293  * Transmit the next pending message, called by notify_transmit_ready
294  */
295 static size_t
296 transmit_pending (void *cls, size_t size, void *buf)
297 {
298   struct GNUNET_GNS_Handle *handle = cls;
299   struct PendingMessage *p;
300   size_t tsize;
301   char *cbuf;
302
303   handle->th = NULL;
304   
305   if ((size == 0) || (buf == NULL))
306   {
307     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
308          "Transmission to GNS service failed!\n");
309     force_reconnect(handle);
310     return 0;
311   }
312   
313   tsize = 0;
314   cbuf = buf;
315
316   if (NULL == (p = handle->pending_head))
317     return 0;
318
319   while ((NULL != (p = handle->pending_head)) && (p->size <= size))
320   {
321     memcpy (&cbuf[tsize], &p[1], p->size);
322     tsize += p->size;
323     size -= p->size;
324     GNUNET_CONTAINER_DLL_remove (handle->pending_head, handle->pending_tail, p);
325     if (GNUNET_YES != handle->in_receive)
326     {
327       GNUNET_CLIENT_receive (handle->client, &process_message, handle,
328                              GNUNET_TIME_UNIT_FOREVER_REL);
329       handle->in_receive = GNUNET_YES;
330     }
331     GNUNET_free(p);
332   }
333
334   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
335               "Sending %d bytes\n", tsize);
336
337   process_pending_messages(handle);
338   return tsize;
339 }
340
341 /**
342  * Process a given reply that might match the given
343  * request.
344  *
345  * @param qe a queue entry
346  * @param msg the shorten msg received
347  */
348 static void
349 process_shorten_reply (struct GNUNET_GNS_QueueEntry *qe,
350                        const struct GNUNET_GNS_ClientShortenResultMessage *msg)
351 {
352   struct GNUNET_GNS_Handle *h = qe->gns_handle;
353   const char *short_name;
354
355   GNUNET_CONTAINER_DLL_remove(h->shorten_head, h->shorten_tail, qe);
356
357   short_name = (char*)(&msg[1]);
358
359   if (ntohs (((struct GNUNET_MessageHeader*)msg)->size) <
360       sizeof (struct GNUNET_GNS_ClientShortenResultMessage))
361   {
362     GNUNET_break (0);
363     force_reconnect (h);
364     GNUNET_free(qe);
365     return;
366   }
367   
368   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
369               "Received shortened reply `%s' from GNS service\n",
370               short_name);
371   
372   GNUNET_CLIENT_receive (h->client, &process_message, h,
373                          GNUNET_TIME_UNIT_FOREVER_REL);
374   qe->shorten_proc(qe->proc_cls, short_name);
375   GNUNET_free(qe);
376
377 }
378
379
380 /**
381  * Process a given reply that might match the given
382  * request.
383  *
384  * @param qe the handle to the request
385  * @param msg the message to process
386  */
387 static void
388 process_get_auth_reply (struct GNUNET_GNS_QueueEntry *qe,
389                        const struct GNUNET_GNS_ClientGetAuthResultMessage *msg)
390 {
391   struct GNUNET_GNS_Handle *h = qe->gns_handle;
392   const char *auth_name;
393
394   GNUNET_CONTAINER_DLL_remove(h->get_auth_head, h->get_auth_tail, qe);
395
396   auth_name = (char*)(&msg[1]);
397
398   if (ntohs (((struct GNUNET_MessageHeader*)msg)->size) <
399       sizeof (struct GNUNET_GNS_ClientGetAuthResultMessage))
400   {
401     GNUNET_free(qe);
402     GNUNET_break (0);
403     force_reconnect (h);
404     return;
405   }
406   
407   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
408               "Received GET_AUTH reply `%s' from GNS service\n",
409               auth_name);
410   
411   GNUNET_CLIENT_receive (h->client, &process_message, h,
412                          GNUNET_TIME_UNIT_FOREVER_REL);
413   qe->auth_proc(qe->proc_cls, auth_name);
414   GNUNET_free(qe);
415
416 }
417 /**
418  * Process a given reply to the lookup request
419  *
420  * @param qe a queue entry
421  * @param msg the lookup message received
422  */
423 static void
424 process_lookup_reply (struct GNUNET_GNS_QueueEntry *qe,
425                       const struct GNUNET_GNS_ClientLookupResultMessage *msg)
426 {
427   struct GNUNET_GNS_Handle *h = qe->gns_handle;
428   int rd_count = ntohl(msg->rd_count);
429   size_t len = ntohs (((struct GNUNET_MessageHeader*)msg)->size);
430   struct GNUNET_NAMESTORE_RecordData rd[rd_count];
431
432   GNUNET_CONTAINER_DLL_remove(h->lookup_head, h->lookup_tail, qe);
433
434   if (len < sizeof (struct GNUNET_GNS_ClientLookupResultMessage))
435   {
436     GNUNET_free(qe);
437     GNUNET_break (0);
438     force_reconnect (h);
439     return;
440   }
441
442   len -= sizeof(struct GNUNET_GNS_ClientLookupResultMessage);
443
444   GNUNET_CLIENT_receive (h->client, &process_message, h,
445                          GNUNET_TIME_UNIT_FOREVER_REL);
446   if (GNUNET_SYSERR == GNUNET_NAMESTORE_records_deserialize (len,
447                                                              (char*)&msg[1],
448                                                              rd_count,
449                                                              rd))
450   {
451     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
452                 "Failed to serialize lookup reply from GNS service!\n");
453     qe->lookup_proc(qe->proc_cls, 0, NULL);
454   }
455   else
456   {
457   
458     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
459                 "Received lookup reply from GNS service (count=%d)\n",
460                 ntohl(msg->rd_count));
461     qe->lookup_proc(qe->proc_cls, rd_count, rd);
462   }
463   GNUNET_free(qe);
464 }
465
466 /**
467  * Handler for messages received from the GNS service
468  *
469  * @param cls the 'struct GNUNET_GNS_Handle'
470  * @param msg the incoming message
471  */
472 static void
473 process_message (void *cls, const struct GNUNET_MessageHeader *msg)
474 {
475   struct GNUNET_GNS_Handle *handle = cls;
476   struct GNUNET_GNS_QueueEntry *qe;
477   const struct GNUNET_GNS_ClientLookupResultMessage *lookup_msg;
478   const struct GNUNET_GNS_ClientShortenResultMessage *shorten_msg;
479   const struct GNUNET_GNS_ClientGetAuthResultMessage *get_auth_msg;
480   uint16_t type;
481   uint32_t r_id;
482   
483   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
484               "Got message\n");
485   if (msg == NULL)
486   {
487     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
488          "Error receiving data from GNS service, reconnecting\n");
489     force_reconnect (handle);
490     return;
491   }
492
493   type = ntohs (msg->type);
494
495   if (type == GNUNET_MESSAGE_TYPE_GNS_LOOKUP_RESULT)
496   {
497     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
498                 "Got lookup msg\n");
499     lookup_msg = (const struct GNUNET_GNS_ClientLookupResultMessage *) msg;
500     r_id = ntohl (lookup_msg->id);
501     
502     if (r_id > handle->r_id)
503     {
504       /** no request found */
505       GNUNET_break_op (0);
506       GNUNET_CLIENT_receive (handle->client, &process_message, handle,
507                              GNUNET_TIME_UNIT_FOREVER_REL);
508       return;
509     }
510
511     for (qe = handle->lookup_head; qe != NULL; qe = qe->next)
512     {
513       if (qe->r_id == r_id)
514         break;
515     }
516     if (qe)
517       process_lookup_reply(qe, lookup_msg);
518     
519     return;
520
521   }
522   else if (type == GNUNET_MESSAGE_TYPE_GNS_SHORTEN_RESULT)
523   {
524     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
525                 "Got SHORTEN_RESULT msg\n");
526     shorten_msg = (struct GNUNET_GNS_ClientShortenResultMessage *) msg;
527     
528     r_id = ntohl (shorten_msg->id);
529     
530     if (r_id > handle->r_id)
531     {
532       /** no request found */
533       GNUNET_break_op (0);
534       GNUNET_CLIENT_receive (handle->client, &process_message, handle,
535                              GNUNET_TIME_UNIT_FOREVER_REL);
536       return;
537     }
538
539     for (qe = handle->shorten_head; qe != NULL; qe = qe->next)
540     {
541       if (qe->r_id == r_id)
542         break;
543     }
544     if (qe)
545       process_shorten_reply(qe, shorten_msg);
546     return;
547   }
548   else if (type == GNUNET_MESSAGE_TYPE_GNS_GET_AUTH_RESULT)
549   {
550     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
551                 "Got GET_AUTH_RESULT msg\n");
552     get_auth_msg = (struct GNUNET_GNS_ClientGetAuthResultMessage *) msg;
553
554     r_id = ntohl (get_auth_msg->id);
555
556     if (r_id > handle->r_id)
557     {
558       /** no request found */
559       GNUNET_break_op (0);
560       GNUNET_CLIENT_receive (handle->client, &process_message, handle,
561                              GNUNET_TIME_UNIT_FOREVER_REL);
562       return;
563     }
564
565     for (qe = handle->get_auth_head; qe != NULL; qe = qe->next)
566     {
567       if (qe->r_id == r_id)
568         break;
569     }
570     if (qe)
571       process_get_auth_reply(qe, get_auth_msg);
572     return;
573   }
574
575
576   if (GNUNET_YES == handle->reconnect)
577     force_reconnect (handle);
578   
579 }
580
581
582 /**
583  * Initialize the connection with the GNS service.
584  *
585  * @param cfg configuration to use
586  * @return handle to the GNS service, or NULL on error
587  */
588 struct GNUNET_GNS_Handle *
589 GNUNET_GNS_connect (const struct GNUNET_CONFIGURATION_Handle *cfg)
590 {
591   struct GNUNET_GNS_Handle *handle;
592
593   handle = GNUNET_malloc (sizeof (struct GNUNET_GNS_Handle));
594   handle->reconnect = GNUNET_NO;
595   handle->cfg = cfg;
596   reconnect (handle);
597   //handle->reconnect_task = GNUNET_SCHEDULER_add_now (&reconnect_task, handle);
598   handle->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
599   handle->r_id = 0;
600   handle->in_receive = GNUNET_NO;
601   return handle;
602 }
603
604
605 /**
606  * Shutdown connection with the GNS service.
607  *
608  * @param handle handle of the GNS connection to stop
609  */
610 void
611 GNUNET_GNS_disconnect (struct GNUNET_GNS_Handle *handle)
612 {
613   GNUNET_CLIENT_disconnect (handle->client);
614   if (GNUNET_SCHEDULER_NO_TASK != handle->reconnect_task)
615   {
616     GNUNET_SCHEDULER_cancel (handle->reconnect_task);
617     handle->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
618   }
619   GNUNET_free(handle);
620   /* disco from GNS */
621 }
622
623 /*
624  * Helper function to generate request ids
625  * 
626  * @param h handle
627  * @return a new id
628  */
629 static uint32_t
630 get_request_id (struct GNUNET_GNS_Handle *h)
631 {
632   uint32_t r_id = h->r_id;
633   h->r_id++;
634   return r_id;
635 }
636
637 /**
638  * Perform an asynchronous Lookup operation on the GNS.
639  *
640  * @param handle handle to the GNS service
641  * @param name the name to look up
642  * @param zone the zone to start the resolution in
643  * @param shorten_zone the zone where to shorten names into
644  * @param type the record type to look up
645  * @param proc processor to call on result
646  * @param proc_cls closure for processor
647  * @return handle to the get
648  */
649 struct GNUNET_GNS_QueueEntry *
650 GNUNET_GNS_lookup_zone (struct GNUNET_GNS_Handle *handle,
651                    const char * name,
652                    struct GNUNET_CRYPTO_ShortHashCode *zone,
653                    struct GNUNET_CRYPTO_ShortHashCode *shorten_zone,
654                    enum GNUNET_GNS_RecordType type,
655                    GNUNET_GNS_LookupResultProcessor proc,
656                    void *proc_cls)
657 {
658   /* IPC to shorten gns names, return shorten_handle */
659   struct GNUNET_GNS_ClientLookupMessage *lookup_msg;
660   struct GNUNET_GNS_QueueEntry *qe;
661   size_t msize;
662   struct PendingMessage *pending;
663
664   if (NULL == name)
665   {
666     return NULL;
667   }
668
669   msize = sizeof (struct GNUNET_GNS_ClientLookupMessage) + strlen(name) + 1;
670   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Trying to lookup %s in GNS\n", name);
671
672   qe = GNUNET_malloc(sizeof (struct GNUNET_GNS_QueueEntry));
673   qe->gns_handle = handle;
674   qe->lookup_proc = proc;
675   qe->proc_cls = proc_cls;
676   qe->r_id = get_request_id(handle);
677   GNUNET_CONTAINER_DLL_insert_tail(handle->lookup_head,
678                                    handle->lookup_tail, qe);
679
680   pending = GNUNET_malloc (sizeof (struct PendingMessage) + msize);
681   memset(pending, 0, (sizeof (struct PendingMessage) + msize));
682   
683   pending->size = msize;
684
685   lookup_msg = (struct GNUNET_GNS_ClientLookupMessage *) &pending[1];
686   lookup_msg->header.type = htons (GNUNET_MESSAGE_TYPE_GNS_LOOKUP);
687   lookup_msg->header.size = htons (msize);
688   lookup_msg->id = htonl(qe->r_id);
689
690   if (NULL != zone)
691   {
692     lookup_msg->use_default_zone = htonl(0);
693     memcpy(&lookup_msg->zone, zone, sizeof(struct GNUNET_CRYPTO_ShortHashCode));
694   }
695   else
696   {
697     lookup_msg->use_default_zone = htonl(1);
698     memset(&lookup_msg->zone, 0, sizeof(struct GNUNET_CRYPTO_ShortHashCode));
699   }
700   
701   if (NULL != shorten_zone)
702   {
703     lookup_msg->use_shorten_zone = htonl(1);
704     memcpy(&lookup_msg->shorten_zone, shorten_zone,
705            sizeof(struct GNUNET_CRYPTO_ShortHashCode));
706   }
707   else
708   {
709     lookup_msg->use_shorten_zone = htonl(0);
710     memset(&lookup_msg->shorten_zone, 0,
711            sizeof(struct GNUNET_CRYPTO_ShortHashCode));
712   }
713   
714   lookup_msg->type = htonl(type);
715
716   memcpy(&lookup_msg[1], name, strlen(name));
717
718   GNUNET_CONTAINER_DLL_insert_tail (handle->pending_head, handle->pending_tail,
719                                pending);
720   
721   process_pending_messages (handle);
722   return qe;
723 }
724
725 /**
726  * Perform an asynchronous Lookup operation on the GNS.
727  *
728  * @param handle handle to the GNS service
729  * @param name the name to look up
730  * @param type the record type to look up
731  * @param proc processor to call on result
732  * @param proc_cls closure for processor
733  * @return handle to the get
734  */
735 struct GNUNET_GNS_QueueEntry *
736 GNUNET_GNS_lookup (struct GNUNET_GNS_Handle *handle,
737                    const char * name,
738                    enum GNUNET_GNS_RecordType type,
739                    GNUNET_GNS_LookupResultProcessor proc,
740                    void *proc_cls)
741 {
742   return GNUNET_GNS_lookup_zone (handle, name,
743                                  NULL, NULL,
744                                  type, proc, proc_cls);
745 }
746
747 /**
748  * Perform a name shortening operation on the GNS.
749  *
750  * @param handle handle to the GNS service
751  * @param name the name to look up
752  * @param zone the zone to start the resolution in
753  * @param shorten_zone the zone where to shorten names into
754  * @param proc function to call on result
755  * @param proc_cls closure for processor
756  * @return handle to the operation
757  */
758 struct GNUNET_GNS_QueueEntry *
759 GNUNET_GNS_shorten_zone (struct GNUNET_GNS_Handle *handle,
760                     const char * name,
761                     struct GNUNET_CRYPTO_ShortHashCode *zone,
762                     struct GNUNET_CRYPTO_ShortHashCode *shorten_zone,
763                     GNUNET_GNS_ShortenResultProcessor proc,
764                     void *proc_cls)
765 {
766   /* IPC to shorten gns names, return shorten_handle */
767   struct GNUNET_GNS_ClientShortenMessage *shorten_msg;
768   struct GNUNET_GNS_QueueEntry *qe;
769   size_t msize;
770   struct PendingMessage *pending;
771
772   if (NULL == name)
773   {
774     return NULL;
775   }
776
777   msize = sizeof (struct GNUNET_GNS_ClientShortenMessage) + strlen(name) + 1;
778   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Trying to shorten %s in GNS\n", name);
779
780   qe = GNUNET_malloc(sizeof (struct GNUNET_GNS_QueueEntry));
781   qe->gns_handle = handle;
782   qe->shorten_proc = proc;
783   qe->proc_cls = proc_cls;
784   qe->r_id = get_request_id(handle);
785   GNUNET_CONTAINER_DLL_insert_tail(handle->shorten_head,
786                                    handle->shorten_tail, qe);
787
788   pending = GNUNET_malloc (sizeof (struct PendingMessage) + msize);
789   memset(pending, 0, (sizeof (struct PendingMessage) + msize));
790   
791   pending->size = msize;
792
793   shorten_msg = (struct GNUNET_GNS_ClientShortenMessage *) &pending[1];
794   shorten_msg->header.type = htons (GNUNET_MESSAGE_TYPE_GNS_SHORTEN);
795   shorten_msg->header.size = htons (msize);
796   shorten_msg->id = htonl(qe->r_id);
797   
798   if (NULL != zone)
799   {
800     shorten_msg->use_default_zone = htonl(0);
801     memcpy(&shorten_msg->zone, zone,
802            sizeof(struct GNUNET_CRYPTO_ShortHashCode));
803   }
804   else
805   {
806     shorten_msg->use_default_zone = htonl(1);
807     memset(&shorten_msg->zone, 0, sizeof(struct GNUNET_CRYPTO_ShortHashCode));
808   }
809   
810   if (NULL != shorten_zone)
811   {
812     shorten_msg->use_shorten_zone = htonl(1);
813     memcpy(&shorten_msg->shorten_zone, shorten_zone,
814            sizeof(struct GNUNET_CRYPTO_ShortHashCode));
815   }
816   else
817   {
818     shorten_msg->use_shorten_zone = htonl(0);
819     memset(&shorten_msg->shorten_zone, 0,
820            sizeof(struct GNUNET_CRYPTO_ShortHashCode));
821   }
822   
823   memcpy(&shorten_msg[1], name, strlen(name));
824
825   GNUNET_CONTAINER_DLL_insert_tail (handle->pending_head, handle->pending_tail,
826                                pending);
827   
828   process_pending_messages (handle);
829   return qe;
830 }
831
832 /**
833  * Perform a name shortening operation on the GNS.
834  *
835  * @param handle handle to the GNS service
836  * @param name the name to look up
837  * @param proc function to call on result
838  * @param proc_cls closure for processor
839  * @return handle to the operation
840  */
841 struct GNUNET_GNS_QueueEntry *
842 GNUNET_GNS_shorten (struct GNUNET_GNS_Handle *handle,
843                     const char * name,
844                     GNUNET_GNS_ShortenResultProcessor proc,
845                     void *proc_cls)
846 {
847   return GNUNET_GNS_shorten_zone (handle, name, NULL, NULL, proc, proc_cls);
848 }
849 /**
850  * Perform an authority lookup for a given name.
851  *
852  * @param handle handle to the GNS service
853  * @param name the name to look up authority for
854  * @param proc function to call on result
855  * @param proc_cls closure for processor
856  * @return handle to the operation
857  */
858 struct GNUNET_GNS_QueueEntry *
859 GNUNET_GNS_get_authority (struct GNUNET_GNS_Handle *handle,
860                     const char * name,
861                     GNUNET_GNS_GetAuthResultProcessor proc,
862                     void *proc_cls)
863 {
864   struct GNUNET_GNS_ClientGetAuthMessage *get_auth_msg;
865   struct GNUNET_GNS_QueueEntry *qe;
866   size_t msize;
867   struct PendingMessage *pending;
868
869   if (NULL == name)
870   {
871     return NULL;
872   }
873
874   msize = sizeof (struct GNUNET_GNS_ClientGetAuthMessage) + strlen(name) + 1;
875   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
876               "Trying to look up authority for %s in GNS\n", name);
877
878   qe = GNUNET_malloc(sizeof (struct GNUNET_GNS_QueueEntry));
879   qe->gns_handle = handle;
880   qe->auth_proc = proc;
881   qe->proc_cls = proc_cls;
882   qe->r_id = get_request_id(handle);
883   GNUNET_CONTAINER_DLL_insert_tail(handle->get_auth_head,
884                                    handle->get_auth_tail, qe);
885
886   pending = GNUNET_malloc (sizeof (struct PendingMessage) + msize);
887   memset(pending, 0, (sizeof (struct PendingMessage) + msize));
888   
889   pending->size = msize;
890
891   get_auth_msg = (struct GNUNET_GNS_ClientGetAuthMessage *) &pending[1];
892   get_auth_msg->header.type = htons (GNUNET_MESSAGE_TYPE_GNS_GET_AUTH);
893   get_auth_msg->header.size = htons (msize);
894   get_auth_msg->id = htonl(qe->r_id);
895
896   memcpy(&get_auth_msg[1], name, strlen(name));
897
898   GNUNET_CONTAINER_DLL_insert_tail (handle->pending_head, handle->pending_tail,
899                                pending);
900   
901   process_pending_messages (handle);
902   return qe;
903 }
904
905
906 /* end of gns_api.c */