2 This file is part of GNUnet.
3 (C) 2009, 2010 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 3, 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 gns/namestore_api.c
23 * @brief API to access the NAMESTORE service
24 * @author Martin Schanzenbach
25 * @author Matthias Wachs
29 #include "gnunet_util_lib.h"
30 #include "gnunet_constants.h"
31 #include "gnunet_arm_service.h"
32 #include "gnunet_namestore_service.h"
33 #include "namestore.h"
34 #define DEBUG_GNS_API GNUNET_EXTRA_LOGGING
36 #define LOG(kind,...) GNUNET_log_from (kind, "gns-api",__VA_ARGS__)
41 struct GNUNET_NAMESTORE_QueueEntry
43 struct GNUNET_NAMESTORE_QueueEntry *next;
44 struct GNUNET_NAMESTORE_QueueEntry *prev;
46 struct GNUNET_NAMESTORE_Handle *nsh;
50 GNUNET_NAMESTORE_ContinuationWithStatus cont;
53 GNUNET_NAMESTORE_RecordProcessor proc;
56 char *data; /*stub data pointer*/
63 struct GNUNET_NAMESTORE_ZoneIterator
65 struct GNUNET_NAMESTORE_ZoneIterator *next;
66 struct GNUNET_NAMESTORE_ZoneIterator *prev;
68 struct GNUNET_NAMESTORE_Handle *h;
69 GNUNET_NAMESTORE_RecordProcessor proc;
71 const GNUNET_HashCode * zone;
78 * Message in linked list we should send to the service. The
79 * actual binary message follows this struct.
87 struct PendingMessage *next;
92 struct PendingMessage *prev;
95 * Size of the message.
100 * Is this the 'START' message?
107 * Connection to the NAMESTORE service.
109 struct GNUNET_NAMESTORE_Handle
113 * Configuration to use.
115 const struct GNUNET_CONFIGURATION_Handle *cfg;
118 * Socket (if available).
120 struct GNUNET_CLIENT_Connection *client;
123 * Currently pending transmission request (or NULL).
125 struct GNUNET_CLIENT_TransmitHandle *th;
130 GNUNET_SCHEDULER_TaskIdentifier reconnect_task;
133 * Pending messages to send to the service
136 struct PendingMessage * pending_head;
137 struct PendingMessage * pending_tail;
140 * Should we reconnect to service due to some serious error?
146 * Pending namestore queue entries
148 struct GNUNET_NAMESTORE_QueueEntry * op_head;
149 struct GNUNET_NAMESTORE_QueueEntry * op_tail;
154 * Pending namestore zone iterator entries
156 struct GNUNET_NAMESTORE_ZoneIterator * z_head;
157 struct GNUNET_NAMESTORE_ZoneIterator * z_tail;
160 struct GNUNET_NAMESTORE_SimpleRecord
165 struct GNUNET_NAMESTORE_SimpleRecord *next;
170 struct GNUNET_NAMESTORE_SimpleRecord *prev;
173 const GNUNET_HashCode *zone;
174 uint32_t record_type;
175 struct GNUNET_TIME_Absolute expiration;
176 enum GNUNET_NAMESTORE_RecordFlags flags;
183 * Disconnect from service and then reconnect.
185 * @param nsh our handle
188 force_reconnect (struct GNUNET_NAMESTORE_Handle *nsh);
191 handle_lookup_name_response (struct GNUNET_NAMESTORE_QueueEntry *qe,
192 struct LookupNameResponseMessage * msg,
195 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Received `%s' \n",
196 "LOOKUP_NAME_RESPONSE");
198 struct GNUNET_NAMESTORE_Handle *nsh = qe->nsh;
199 struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded *zone_key;
201 struct GNUNET_NAMESTORE_RecordData *rd = NULL;
202 struct GNUNET_CRYPTO_RsaSignature *signature = NULL;
203 struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded dummy;
204 struct GNUNET_TIME_Absolute expire;
205 unsigned int rd_count = 0;
208 int contains_sig = GNUNET_NO;
210 rd_count = ntohl (msg->rc_count);
211 msg_len = ntohs (msg->header.size);
212 name_len = ntohs (msg->name_len);
213 contains_sig = ntohs (msg->contains_sig);
214 expire = GNUNET_TIME_absolute_ntoh(msg->expire);
216 if (msg_len != sizeof (struct LookupNameResponseMessage) +
217 sizeof (struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded) +
219 rd_count * sizeof (struct GNUNET_NAMESTORE_RecordData) +
220 contains_sig * sizeof (struct GNUNET_CRYPTO_RsaSignature))
226 zone_key = (struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded *) &msg[1];
227 name = (char *) &zone_key[1];
228 rd = (struct GNUNET_NAMESTORE_RecordData *) &name[name_len];
230 /* reset values if values not contained */
231 if (contains_sig == GNUNET_NO)
234 signature = (struct GNUNET_CRYPTO_RsaSignature *) &rd[rd_count];
240 memset (&dummy, '0', sizeof(struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded));
241 if (0 == memcmp (zone_key, &dummy, sizeof(struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded)))
244 if (qe->proc != NULL)
246 qe->proc (qe->proc_cls, zone_key, expire, name, rd_count, rd, signature);
250 /* Operation done, remove */
251 GNUNET_CONTAINER_DLL_remove(nsh->op_head, nsh->op_tail, qe);
258 * Type of a function to call when we receive a message
261 * @param cls the 'struct GNUNET_NAMESTORE_SchedulingHandle'
262 * @param msg message received, NULL on timeout or fatal error
265 process_namestore_message (void *cls, const struct GNUNET_MessageHeader *msg)
267 struct GNUNET_NAMESTORE_Handle *nsh = cls;
268 struct GenericMessage * gm;
269 struct GNUNET_NAMESTORE_QueueEntry *qe;
272 uint32_t op_id = UINT32_MAX;
276 force_reconnect (nsh);
280 size = ntohs (msg->size);
281 type = ntohs (msg->type);
283 if (size < sizeof (struct GenericMessage))
286 GNUNET_CLIENT_receive (nsh->client, &process_namestore_message, nsh,
287 GNUNET_TIME_UNIT_FOREVER_REL);
291 gm = (struct GenericMessage *) msg;
292 op_id = ntohl (gm->op_id);
294 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Received message type %i size %i op %u\n", type, size, op_id);
296 /* Find matching operation */
297 if (op_id > nsh->op_id)
299 /* No matching pending operation found */
301 GNUNET_CLIENT_receive (nsh->client, &process_namestore_message, nsh,
302 GNUNET_TIME_UNIT_FOREVER_REL);
305 for (qe = nsh->op_head; qe != NULL; qe = qe->next)
307 if (qe->op_id == op_id)
312 /* No matching pending operation found */
314 GNUNET_CLIENT_receive (nsh->client, &process_namestore_message, nsh,
315 GNUNET_TIME_UNIT_FOREVER_REL);
319 /* handle different message type */
321 case GNUNET_MESSAGE_TYPE_NAMESTORE_LOOKUP_NAME_RESPONSE:
322 if (size < sizeof (struct LookupNameResponseMessage))
327 handle_lookup_name_response (qe, (struct LookupNameResponseMessage *) msg, size);
334 GNUNET_CLIENT_receive (nsh->client, &process_namestore_message, nsh,
335 GNUNET_TIME_UNIT_FOREVER_REL);
337 if (GNUNET_YES == nsh->reconnect)
338 force_reconnect (nsh);
343 * Transmit messages from the message queue to the service
344 * (if there are any, and if we are not already trying).
346 * @param nsh handle to use
349 do_transmit (struct GNUNET_NAMESTORE_Handle *nsh);
353 * We can now transmit a message to NAMESTORE. Do it.
355 * @param cls the 'struct GNUNET_NAMESTORE_Handle'
356 * @param size number of bytes we can transmit
357 * @param buf where to copy the messages
358 * @return number of bytes copied into buf
361 transmit_message_to_namestore (void *cls, size_t size, void *buf)
363 struct GNUNET_NAMESTORE_Handle *nsh = cls;
364 struct PendingMessage *p;
369 if ((size == 0) || (buf == NULL))
371 force_reconnect (nsh);
376 while ((NULL != (p = nsh->pending_head)) && (p->size <= size))
378 memcpy (&cbuf[ret], &p[1], p->size);
381 GNUNET_CONTAINER_DLL_remove (nsh->pending_head, nsh->pending_tail, p);
382 if (GNUNET_YES == p->is_init)
383 GNUNET_CLIENT_receive (nsh->client, &process_namestore_message, nsh,
384 GNUNET_TIME_UNIT_FOREVER_REL);
393 * Transmit messages from the message queue to the service
394 * (if there are any, and if we are not already trying).
396 * @param nsh handle to use
399 do_transmit (struct GNUNET_NAMESTORE_Handle *nsh)
401 struct PendingMessage *p;
405 if (NULL == (p = nsh->pending_head))
407 if (NULL == nsh->client)
408 return; /* currently reconnecting */
410 nsh->th = GNUNET_CLIENT_notify_transmit_ready (nsh->client, p->size,
411 GNUNET_TIME_UNIT_FOREVER_REL,
412 GNUNET_NO, &transmit_message_to_namestore,
418 * Try again to connect to namestore service.
420 * @param cls the handle to the namestore service
421 * @param tc scheduler context
424 reconnect (struct GNUNET_NAMESTORE_Handle *nsh)
426 struct PendingMessage *p;
427 struct StartMessage *init;
429 GNUNET_assert (NULL == nsh->client);
430 nsh->client = GNUNET_CLIENT_connect ("namestore", nsh->cfg);
431 GNUNET_assert (NULL != nsh->client);
433 if ((NULL == (p = nsh->pending_head)) || (GNUNET_YES != p->is_init))
435 p = GNUNET_malloc (sizeof (struct PendingMessage) +
436 sizeof (struct StartMessage));
437 p->size = sizeof (struct StartMessage);
438 p->is_init = GNUNET_YES;
439 init = (struct StartMessage *) &p[1];
440 init->header.type = htons (GNUNET_MESSAGE_TYPE_NAMESTORE_START);
441 init->header.size = htons (sizeof (struct StartMessage));
442 GNUNET_CONTAINER_DLL_insert (nsh->pending_head, nsh->pending_tail, p);
448 * Re-establish the connection to the service.
450 * @param cls handle to use to re-connect.
451 * @param tc scheduler context
454 reconnect_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
456 struct GNUNET_NAMESTORE_Handle *nsh = cls;
458 nsh->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
464 * Disconnect from service and then reconnect.
466 * @param nsh our handle
469 force_reconnect (struct GNUNET_NAMESTORE_Handle *nsh)
471 nsh->reconnect = GNUNET_NO;
472 GNUNET_CLIENT_disconnect (nsh->client, GNUNET_NO);
474 nsh->reconnect_task = GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_SECONDS,
480 get_op_id (struct GNUNET_NAMESTORE_Handle *nsh)
482 uint32_t op_id = nsh->op_id;
488 * Initialize the connection with the NAMESTORE service.
490 * @param cfg configuration to use
491 * @return handle to the GNS service, or NULL on error
493 struct GNUNET_NAMESTORE_Handle *
494 GNUNET_NAMESTORE_connect (const struct GNUNET_CONFIGURATION_Handle *cfg)
496 struct GNUNET_NAMESTORE_Handle *nsh;
498 nsh = GNUNET_malloc (sizeof (struct GNUNET_NAMESTORE_Handle));
500 nsh->reconnect_task = GNUNET_SCHEDULER_add_now (&reconnect_task, nsh);
506 * Shutdown connection with the NAMESTORE service.
508 * @param handle handle of the NAMESTORE connection to stop
511 GNUNET_NAMESTORE_disconnect (struct GNUNET_NAMESTORE_Handle *nsh, int drop)
513 struct PendingMessage *p;
514 struct GNUNET_NAMESTORE_QueueEntry *q;
515 struct GNUNET_NAMESTORE_ZoneIterator *z;
517 GNUNET_assert (nsh != NULL);
519 while (NULL != (p = nsh->pending_head))
521 GNUNET_CONTAINER_DLL_remove (nsh->pending_head, nsh->pending_tail, p);
525 while (NULL != (q = nsh->op_head))
527 GNUNET_CONTAINER_DLL_remove (nsh->op_head, nsh->op_tail, q);
531 while (NULL != (z = nsh->z_head))
533 GNUNET_CONTAINER_DLL_remove (nsh->z_head, nsh->z_tail, z);
537 if (NULL != nsh->client)
539 GNUNET_CLIENT_disconnect (nsh->client, GNUNET_NO);
542 if (GNUNET_SCHEDULER_NO_TASK != nsh->reconnect_task)
544 GNUNET_SCHEDULER_cancel (nsh->reconnect_task);
545 nsh->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
553 * Store an item in the namestore. If the item is already present,
554 * the expiration time is updated to the max of the existing time and
555 * the new time. This API is used when we cache signatures from other
558 * @param h handle to the namestore
559 * @param zone_key public key of the zone
560 * @param name name that is being mapped (at most 255 characters long)
561 * @param expire when does the corresponding block in the DHT expire (until
562 * when should we never do a DHT lookup for the same name again)?
563 * @param rd_count number of entries in 'rd' array
564 * @param rd array of records with data to store
565 * @param signature signature for all the records in the zone under the given name
566 * @param cont continuation to call when done
567 * @param cont_cls closure for cont
568 * @return handle to abort the request
570 struct GNUNET_NAMESTORE_QueueEntry *
571 GNUNET_NAMESTORE_record_put (struct GNUNET_NAMESTORE_Handle *h,
572 const struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded *zone_key,
574 struct GNUNET_TIME_Absolute expire,
575 unsigned int rd_count,
576 const struct GNUNET_NAMESTORE_RecordData *rd,
577 const struct GNUNET_CRYPTO_RsaSignature *signature,
578 GNUNET_NAMESTORE_ContinuationWithStatus cont,
581 struct GNUNET_NAMESTORE_QueueEntry *qe;
582 struct PendingMessage *pe;
586 GNUNET_assert (NULL != h);
588 qe = GNUNET_malloc(sizeof (struct GNUNET_NAMESTORE_QueueEntry));
591 qe->cont_cls = cont_cls;
593 GNUNET_CONTAINER_DLL_insert(h->op_head, h->op_tail, qe);
596 pe = GNUNET_malloc(sizeof (struct PendingMessage) + msg_size);
598 /* create msg here */
600 GNUNET_CONTAINER_DLL_insert (h->pending_head, h->pending_tail, pe);
604 struct GNUNET_NAMESTORE_SimpleRecord *sr;
605 sr = GNUNET_malloc(sizeof(struct GNUNET_NAMESTORE_SimpleRecord));
607 sr->record_type = record_type;
608 sr->expiration = expiration;
610 sr->data_size = data_size;
612 GNUNET_CONTAINER_DLL_insert(h->records_head, h->records_tail, sr);
619 * Check if a signature is valid. This API is used by the GNS Block
620 * to validate signatures received from the network.
622 * @param public_key public key of the zone
623 * @param name name that is being mapped (at most 255 characters long)
624 * @param rd_count number of entries in 'rd' array
625 * @param rd array of records with data to store
626 * @param signature signature for all the records in the zone under the given name
627 * @return GNUNET_OK if the signature is valid
630 GNUNET_NAMESTORE_verify_signature (const struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded *public_key,
632 unsigned int rd_count,
633 const struct GNUNET_NAMESTORE_RecordData *rd,
634 const struct GNUNET_CRYPTO_RsaSignature *signature)
636 return GNUNET_SYSERR;
640 * Store an item in the namestore. If the item is already present,
641 * the expiration time is updated to the max of the existing time and
642 * the new time. This API is used by the authority of a zone.
644 * @param h handle to the namestore
645 * @param pkey private key of the zone
646 * @param name name that is being mapped (at most 255 characters long)
647 * @param rd record data to store
648 * @param cont continuation to call when done
649 * @param cont_cls closure for cont
650 * @return handle to abort the request
652 struct GNUNET_NAMESTORE_QueueEntry *
653 GNUNET_NAMESTORE_record_create (struct GNUNET_NAMESTORE_Handle *h,
654 const struct GNUNET_CRYPTO_RsaPrivateKey *pkey,
656 const struct GNUNET_NAMESTORE_RecordData *rd,
657 GNUNET_NAMESTORE_ContinuationWithStatus cont,
660 struct GNUNET_NAMESTORE_QueueEntry *qe;
661 struct PendingMessage *pe;
664 GNUNET_assert (NULL != h);
666 qe = GNUNET_malloc(sizeof (struct GNUNET_NAMESTORE_QueueEntry));
669 qe->cont_cls = cont_cls;
673 pe = GNUNET_malloc(sizeof (struct PendingMessage) + msg_size);
675 /* create msg here */
677 GNUNET_CONTAINER_DLL_insert (h->pending_head, h->pending_tail, pe);
684 * Explicitly remove some content from the database. The
685 * "cont"inuation will be called with status "GNUNET_OK" if content
686 * was removed, "GNUNET_NO" if no matching entry was found and
687 * "GNUNET_SYSERR" on all other types of errors.
688 * This API is used by the authority of a zone.
690 * @param h handle to the namestore
691 * @param pkey private key of the zone
692 * @param name name that is being mapped (at most 255 characters long)
693 * @param rd record data
694 * @param cont continuation to call when done
695 * @param cont_cls closure for cont
696 * @return handle to abort the request
698 struct GNUNET_NAMESTORE_QueueEntry *
699 GNUNET_NAMESTORE_record_remove (struct GNUNET_NAMESTORE_Handle *h,
700 const struct GNUNET_CRYPTO_RsaPrivateKey *pkey,
702 const struct GNUNET_NAMESTORE_RecordData *rd,
703 GNUNET_NAMESTORE_ContinuationWithStatus cont,
706 struct GNUNET_NAMESTORE_QueueEntry *qe;
707 struct PendingMessage *pe;
710 GNUNET_assert (NULL != h);
712 qe = GNUNET_malloc(sizeof (struct GNUNET_NAMESTORE_QueueEntry));
715 qe->cont_cls = cont_cls;
719 pe = GNUNET_malloc(sizeof (struct PendingMessage) + msg_size);
721 /* create msg here */
723 GNUNET_CONTAINER_DLL_insert (h->pending_head, h->pending_tail, pe);
727 struct GNUNET_NAMESTORE_SimpleRecord *iter;
728 for (iter=h->records_head; iter != NULL; iter=iter->next)
730 if (strcmp ( iter->name, name ) &&
731 iter->record_type == record_type &&
732 GNUNET_CRYPTO_hash_cmp (iter->zone, zone))
736 GNUNET_CONTAINER_DLL_remove(h->records_head,
745 * Get a result for a particular key from the namestore. The processor
746 * will only be called once.
748 * @param h handle to the namestore
749 * @param zone zone to look up a record from
750 * @param name name to look up
751 * @param record_type desired record type, 0 for all
752 * @param proc function to call on the matching records, or with
753 * NULL (rd_count == 0) if there are no matching records
754 * @param proc_cls closure for proc
755 * @return a handle that can be used to
758 struct GNUNET_NAMESTORE_QueueEntry *
759 GNUNET_NAMESTORE_lookup_record (struct GNUNET_NAMESTORE_Handle *h,
760 const GNUNET_HashCode *zone,
762 uint32_t record_type,
763 GNUNET_NAMESTORE_RecordProcessor proc, void *proc_cls)
765 struct GNUNET_NAMESTORE_QueueEntry *qe;
766 struct PendingMessage *pe;
771 GNUNET_assert (NULL != h);
772 GNUNET_assert (NULL != zone);
773 GNUNET_assert (NULL != name);
775 name_len = strlen (name) + 1;
776 if ((name_len == 0) || (name_len > 256))
783 qe = GNUNET_malloc(sizeof (struct GNUNET_NAMESTORE_QueueEntry));
786 qe->proc_cls = proc_cls;
788 GNUNET_CONTAINER_DLL_insert(h->op_head, h->op_tail, qe);
791 msg_size = sizeof (struct LookupNameMessage) + name_len;
792 pe = GNUNET_malloc(sizeof (struct PendingMessage) + msg_size);
794 /* create msg here */
795 struct LookupNameMessage * msg;
797 pe->is_init = GNUNET_NO;
798 msg = (struct LookupNameMessage *) &pe[1];
799 msg->header.type = htons (GNUNET_MESSAGE_TYPE_NAMESTORE_LOOKUP_NAME);
800 msg->header.size = htons (msg_size);
801 msg->op_id = htonl (id);
802 msg->record_type = htonl (record_type);
804 msg->name_len = htonl (name_len);
805 memcpy (&msg[1], name, name_len);
807 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Sending `%s' message for name `%s'\n", "NAMESTORE_LOOKUP_NAME", name);
809 /* transmit message */
810 GNUNET_CONTAINER_DLL_insert (h->pending_head, h->pending_tail, pe);
819 * Starts a new zone iteration (used to periodically PUT all of our
820 * records into our DHT). This MUST lock the GNUNET_NAMESTORE_Handle
821 * for any other calls than GNUNET_NAMESTORE_zone_iterator_next and
822 * GNUNET_NAMESTORE_zone_iteration_stop. "proc" will be called once
823 * immediately, and then again after
824 * "GNUNET_NAMESTORE_zone_iterator_next" is invoked.
826 * @param h handle to the namestore
827 * @param zone zone to access, NULL for all zones
828 * @param must_have_flags flags that must be set for the record to be returned
829 * @param must_not_have_flags flags that must NOT be set for the record to be returned
830 * @param proc function to call on each name from the zone; it
831 * will be called repeatedly with a value (if available)
832 * and always once at the end with a name of NULL.
833 * @param proc_cls closure for proc
834 * @return an iterator handle to use for iteration
836 struct GNUNET_NAMESTORE_ZoneIterator *
837 GNUNET_NAMESTORE_zone_iteration_start (struct GNUNET_NAMESTORE_Handle *h,
838 const GNUNET_HashCode *zone,
839 enum GNUNET_NAMESTORE_RecordFlags must_have_flags,
840 enum GNUNET_NAMESTORE_RecordFlags must_not_have_flags,
841 GNUNET_NAMESTORE_RecordProcessor proc,
844 struct GNUNET_NAMESTORE_ZoneIterator *it;
846 GNUNET_assert (h != NULL);
848 it = GNUNET_malloc (sizeof (struct GNUNET_NAMESTORE_ZoneIterator));
852 GNUNET_CONTAINER_DLL_insert(h->z_head, h->z_tail, it);
859 * Calls the record processor specified in GNUNET_NAMESTORE_zone_iteration_start
860 * for the next record.
862 * @param it the iterator
865 GNUNET_NAMESTORE_zone_iterator_next (struct GNUNET_NAMESTORE_ZoneIterator *it)
872 * Stops iteration and releases the namestore handle for further calls.
874 * @param it the iterator
877 GNUNET_NAMESTORE_zone_iteration_stop (struct GNUNET_NAMESTORE_ZoneIterator *it)
879 struct GNUNET_NAMESTORE_Handle * nsh;
880 GNUNET_assert (it != NULL);
883 GNUNET_CONTAINER_DLL_remove (nsh->z_head, nsh->z_tail, it);
890 * Cancel a namestore operation. The final callback from the
891 * operation must not have been done yet.
893 * @param qe operation to cancel
896 GNUNET_NAMESTORE_cancel (struct GNUNET_NAMESTORE_QueueEntry *qe)
898 struct GNUNET_NAMESTORE_Handle *nsh = qe->nsh;
900 GNUNET_assert (qe != NULL);
902 GNUNET_CONTAINER_DLL_remove(nsh->op_head, nsh->op_tail, qe);
907 /* end of namestore_api.c */