1a268f952c1adbbcdef200f09f5c84480b56b7f6
[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, GNUNET_NO);
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 cls the 'struct GNUNET_GNS_ClientResultMessage'
346  * @param key query of the request
347  * @param value the 'struct GNUNET_GNS_LookupHandle' of a request matching the same key
348  */
349 static void
350 process_shorten_reply (struct GNUNET_GNS_QueueEntry *qe,
351                        const struct GNUNET_GNS_ClientShortenResultMessage *msg)
352 {
353   struct GNUNET_GNS_Handle *h = qe->gns_handle;
354   const char *short_name;
355
356   GNUNET_CONTAINER_DLL_remove(h->shorten_head, h->shorten_tail, qe);
357
358   short_name = (char*)(&msg[1]);
359
360   if (ntohs (((struct GNUNET_MessageHeader*)msg)->size) <
361       sizeof (struct GNUNET_GNS_ClientShortenResultMessage))
362   {
363     GNUNET_break (0);
364     force_reconnect (h);
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
376 }
377
378
379 /**
380  * Process a given reply that might match the given
381  * request.
382  *
383  * @param qe the handle to the request
384  * @param msg the message to process
385  */
386 static void
387 process_get_auth_reply (struct GNUNET_GNS_QueueEntry *qe,
388                        const struct GNUNET_GNS_ClientGetAuthResultMessage *msg)
389 {
390   struct GNUNET_GNS_Handle *h = qe->gns_handle;
391   const char *auth_name;
392
393   GNUNET_CONTAINER_DLL_remove(h->get_auth_head, h->get_auth_tail, qe);
394
395   auth_name = (char*)(&msg[1]);
396
397   if (ntohs (((struct GNUNET_MessageHeader*)msg)->size) <
398       sizeof (struct GNUNET_GNS_ClientGetAuthResultMessage))
399   {
400     GNUNET_break (0);
401     force_reconnect (h);
402     return;
403   }
404   
405   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
406               "Received GET_AUTH reply `%s' from GNS service\n",
407               auth_name);
408   
409   GNUNET_CLIENT_receive (h->client, &process_message, h,
410                          GNUNET_TIME_UNIT_FOREVER_REL);
411   qe->auth_proc(qe->proc_cls, auth_name);
412
413 }
414 /**
415  * Process a given reply to the lookup request
416  *
417  * @param cls the 'struct GNUNET_GNS_ClientResultMessage'
418  * @param key query of the request
419  * @param value the 'struct GNUNET_GNS_LookupHandle' of a request matching the same key
420  * @return GNUNET_YES to continue to iterate over all results,
421  *         GNUNET_NO if the reply is malformed
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_break (0);
437     force_reconnect (h);
438     return;
439   }
440
441   len -= sizeof(struct GNUNET_GNS_ClientLookupResultMessage);
442
443   GNUNET_NAMESTORE_records_deserialize (len, (char*)&msg[1],
444                                         rd_count,
445                                         rd);
446   
447   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
448               "Received lookup reply from GNS service (count=%d)\n",
449               ntohl(msg->rd_count));
450   
451   GNUNET_CLIENT_receive (h->client, &process_message, h,
452                          GNUNET_TIME_UNIT_FOREVER_REL);
453   qe->lookup_proc(qe->proc_cls, rd_count, rd);
454 }
455
456 /**
457  * Handler for messages received from the GNS service
458  *
459  * @param cls the 'struct GNUNET_GNS_Handle'
460  * @param msg the incoming message
461  */
462 static void
463 process_message (void *cls, const struct GNUNET_MessageHeader *msg)
464 {
465   struct GNUNET_GNS_Handle *handle = cls;
466   struct GNUNET_GNS_QueueEntry *qe;
467   const struct GNUNET_GNS_ClientLookupResultMessage *lookup_msg;
468   const struct GNUNET_GNS_ClientShortenResultMessage *shorten_msg;
469   const struct GNUNET_GNS_ClientGetAuthResultMessage *get_auth_msg;
470   uint16_t type;
471   uint32_t r_id;
472   
473   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
474               "Got message\n");
475   if (msg == NULL)
476   {
477     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
478          "Error receiving data from GNS service, reconnecting\n");
479     force_reconnect (handle);
480     return;
481   }
482
483   type = ntohs (msg->type);
484
485   if (type == GNUNET_MESSAGE_TYPE_GNS_LOOKUP_RESULT)
486   {
487     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
488                 "Got lookup msg\n");
489     lookup_msg = (const struct GNUNET_GNS_ClientLookupResultMessage *) msg;
490     r_id = ntohl (lookup_msg->id);
491     
492     if (r_id > handle->r_id)
493     {
494       /** no request found */
495       GNUNET_break_op (0);
496       GNUNET_CLIENT_receive (handle->client, &process_message, handle,
497                              GNUNET_TIME_UNIT_FOREVER_REL);
498       return;
499     }
500
501     for (qe = handle->lookup_head; qe != NULL; qe = qe->next)
502     {
503       if (qe->r_id == r_id)
504         break;
505     }
506     if (qe)
507       process_lookup_reply(qe, lookup_msg);
508     
509     return;
510
511   }
512   else if (type == GNUNET_MESSAGE_TYPE_GNS_SHORTEN_RESULT)
513   {
514     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
515                 "Got SHORTEN_RESULT msg\n");
516     shorten_msg = (struct GNUNET_GNS_ClientShortenResultMessage *) msg;
517     
518     r_id = ntohl (shorten_msg->id);
519     
520     if (r_id > handle->r_id)
521     {
522       /** no request found */
523       GNUNET_break_op (0);
524       GNUNET_CLIENT_receive (handle->client, &process_message, handle,
525                              GNUNET_TIME_UNIT_FOREVER_REL);
526       return;
527     }
528
529     for (qe = handle->shorten_head; qe != NULL; qe = qe->next)
530     {
531       if (qe->r_id == r_id)
532         break;
533     }
534     if (qe)
535       process_shorten_reply(qe, shorten_msg);
536     return;
537   }
538   else if (type == GNUNET_MESSAGE_TYPE_GNS_GET_AUTH_RESULT)
539   {
540     GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
541                 "Got GET_AUTH_RESULT msg\n");
542     get_auth_msg = (struct GNUNET_GNS_ClientGetAuthResultMessage *) msg;
543
544     r_id = ntohl (get_auth_msg->id);
545
546     if (r_id > handle->r_id)
547     {
548       /** no request found */
549       GNUNET_break_op (0);
550       GNUNET_CLIENT_receive (handle->client, &process_message, handle,
551                              GNUNET_TIME_UNIT_FOREVER_REL);
552       return;
553     }
554
555     for (qe = handle->get_auth_head; qe != NULL; qe = qe->next)
556     {
557       if (qe->r_id == r_id)
558         break;
559     }
560     if (qe)
561       process_get_auth_reply(qe, get_auth_msg);
562     return;
563   }
564
565
566   if (GNUNET_YES == handle->reconnect)
567     force_reconnect (handle);
568   
569 }
570
571
572 /**
573  * Initialize the connection with the GNS service.
574  *
575  * @param cfg configuration to use
576  * @param ht_len size of the internal hash table to use for parallel requests
577  * @return handle to the GNS service, or NULL on error
578  */
579 struct GNUNET_GNS_Handle *
580 GNUNET_GNS_connect (const struct GNUNET_CONFIGURATION_Handle *cfg)
581 {
582   struct GNUNET_GNS_Handle *handle;
583
584   handle = GNUNET_malloc (sizeof (struct GNUNET_GNS_Handle));
585   handle->reconnect = GNUNET_NO;
586   handle->cfg = cfg;
587   reconnect (handle);
588   //handle->reconnect_task = GNUNET_SCHEDULER_add_now (&reconnect_task, handle);
589   handle->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
590   handle->r_id = 0;
591   handle->in_receive = GNUNET_NO;
592   return handle;
593 }
594
595
596 /**
597  * Shutdown connection with the GNS service.
598  *
599  * @param handle handle of the GNS connection to stop
600  */
601 void
602 GNUNET_GNS_disconnect (struct GNUNET_GNS_Handle *h)
603 {
604   GNUNET_CLIENT_disconnect (h->client, GNUNET_NO);
605   if (GNUNET_SCHEDULER_NO_TASK != h->reconnect_task)
606   {
607     GNUNET_SCHEDULER_cancel (h->reconnect_task);
608     h->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
609   }
610   GNUNET_free(h);
611   /* disco from GNS */
612 }
613
614 /*
615  * Helper function to generate request ids
616  * 
617  * @param h handle
618  * @return a new id
619  */
620 static uint32_t
621 get_request_id (struct GNUNET_GNS_Handle *h)
622 {
623   uint32_t r_id = h->r_id;
624   h->r_id++;
625   return r_id;
626 }
627
628 /**
629  * Perform an asynchronous Lookup operation on the GNS.
630  *
631  * @param handle handle to the GNS service
632  * @param name the name to look up
633  * @param iter function to call on each result
634  * @param iter_cls closure for iter
635  * @return handle to stop the async get
636  */
637 struct GNUNET_GNS_QueueEntry *
638 GNUNET_GNS_lookup (struct GNUNET_GNS_Handle *handle,
639                    const char * name,
640                    enum GNUNET_GNS_RecordType type,
641                    GNUNET_GNS_LookupResultProcessor proc,
642                    void *proc_cls)
643 {
644   /* IPC to shorten gns names, return shorten_handle */
645   struct GNUNET_GNS_ClientLookupMessage *lookup_msg;
646   struct GNUNET_GNS_QueueEntry *qe;
647   size_t msize;
648   struct PendingMessage *pending;
649
650   if (NULL == name)
651   {
652     return NULL;
653   }
654
655   msize = sizeof (struct GNUNET_GNS_ClientLookupMessage) + strlen(name) + 1;
656   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Trying to lookup %s in GNS\n", name);
657
658   qe = GNUNET_malloc(sizeof (struct GNUNET_GNS_QueueEntry));
659   qe->gns_handle = handle;
660   qe->lookup_proc = proc;
661   qe->proc_cls = proc_cls;
662   qe->r_id = get_request_id(handle);
663   GNUNET_CONTAINER_DLL_insert_tail(handle->lookup_head,
664                                    handle->lookup_tail, qe);
665
666   pending = GNUNET_malloc (sizeof (struct PendingMessage) + msize);
667   memset(pending, 0, (sizeof (struct PendingMessage) + msize));
668   
669   pending->size = msize;
670
671   lookup_msg = (struct GNUNET_GNS_ClientLookupMessage *) &pending[1];
672   lookup_msg->header.type = htons (GNUNET_MESSAGE_TYPE_GNS_LOOKUP);
673   lookup_msg->header.size = htons (msize);
674   lookup_msg->id = htonl(qe->r_id);
675   lookup_msg->type = htonl(type);
676
677   memcpy(&lookup_msg[1], name, strlen(name));
678
679   GNUNET_CONTAINER_DLL_insert (handle->pending_head, handle->pending_tail,
680                                pending);
681   
682   process_pending_messages (handle);
683   return qe;
684 }
685
686
687 /**
688  * Perform a name shortening operation on the GNS.
689  *
690  * @param handle handle to the GNS service
691  * @param name the name to look up
692  * @param proc function to call on result
693  * @param proc_cls closure for processor
694  * @return handle to the operation
695  */
696 struct GNUNET_GNS_QueueEntry *
697 GNUNET_GNS_shorten (struct GNUNET_GNS_Handle *handle,
698                     const char * name,
699                     GNUNET_GNS_ShortenResultProcessor proc,
700                     void *proc_cls)
701 {
702   /* IPC to shorten gns names, return shorten_handle */
703   struct GNUNET_GNS_ClientShortenMessage *shorten_msg;
704   struct GNUNET_GNS_QueueEntry *qe;
705   size_t msize;
706   struct PendingMessage *pending;
707
708   if (NULL == name)
709   {
710     return NULL;
711   }
712
713   msize = sizeof (struct GNUNET_GNS_ClientShortenMessage) + strlen(name) + 1;
714   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Trying to shorten %s in GNS\n", name);
715
716   qe = GNUNET_malloc(sizeof (struct GNUNET_GNS_QueueEntry));
717   qe->gns_handle = handle;
718   qe->shorten_proc = proc;
719   qe->proc_cls = proc_cls;
720   qe->r_id = get_request_id(handle);
721   GNUNET_CONTAINER_DLL_insert_tail(handle->shorten_head,
722                                    handle->shorten_tail, qe);
723
724   pending = GNUNET_malloc (sizeof (struct PendingMessage) + msize);
725   memset(pending, 0, (sizeof (struct PendingMessage) + msize));
726   
727   pending->size = msize;
728
729   shorten_msg = (struct GNUNET_GNS_ClientShortenMessage *) &pending[1];
730   shorten_msg->header.type = htons (GNUNET_MESSAGE_TYPE_GNS_SHORTEN);
731   shorten_msg->header.size = htons (msize);
732   shorten_msg->id = htonl(qe->r_id);
733
734   memcpy(&shorten_msg[1], name, strlen(name));
735
736   GNUNET_CONTAINER_DLL_insert (handle->pending_head, handle->pending_tail,
737                                pending);
738   
739   process_pending_messages (handle);
740   return qe;
741 }
742
743
744 /**
745  * Perform an authority lookup for a given name.
746  *
747  * @param handle handle to the GNS service
748  * @param name the name to look up authority for
749  * @param proc function to call on result
750  * @param proc_cls closure for processor
751  * @return handle to the operation
752  */
753 struct GNUNET_GNS_QueueEntry *
754 GNUNET_GNS_get_authority (struct GNUNET_GNS_Handle *handle,
755                     const char * name,
756                     GNUNET_GNS_GetAuthResultProcessor proc,
757                     void *proc_cls)
758 {
759   struct GNUNET_GNS_ClientGetAuthMessage *get_auth_msg;
760   struct GNUNET_GNS_QueueEntry *qe;
761   size_t msize;
762   struct PendingMessage *pending;
763
764   if (NULL == name)
765   {
766     return NULL;
767   }
768
769   msize = sizeof (struct GNUNET_GNS_ClientGetAuthMessage) + strlen(name) + 1;
770   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
771               "Trying to look up authority for %s in GNS\n", name);
772
773   qe = GNUNET_malloc(sizeof (struct GNUNET_GNS_QueueEntry));
774   qe->gns_handle = handle;
775   qe->auth_proc = proc;
776   qe->proc_cls = proc_cls;
777   qe->r_id = get_request_id(handle);
778   GNUNET_CONTAINER_DLL_insert_tail(handle->get_auth_head,
779                                    handle->get_auth_tail, qe);
780
781   pending = GNUNET_malloc (sizeof (struct PendingMessage) + msize);
782   memset(pending, 0, (sizeof (struct PendingMessage) + msize));
783   
784   pending->size = msize;
785
786   get_auth_msg = (struct GNUNET_GNS_ClientGetAuthMessage *) &pending[1];
787   get_auth_msg->header.type = htons (GNUNET_MESSAGE_TYPE_GNS_GET_AUTH);
788   get_auth_msg->header.size = htons (msize);
789   get_auth_msg->id = htonl(qe->r_id);
790
791   memcpy(&get_auth_msg[1], name, strlen(name));
792
793   GNUNET_CONTAINER_DLL_insert (handle->pending_head, handle->pending_tail,
794                                pending);
795   
796   process_pending_messages (handle);
797   return qe;
798 }
799
800
801 /* end of gns_api.c */