2 This file is part of GNUnet.
3 (C) 2009, 2010, 2011 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 statistics/statistics_api.c
23 * @brief API of the statistics service
24 * @author Christian Grothoff
27 #include "gnunet_client_lib.h"
28 #include "gnunet_constants.h"
29 #include "gnunet_container_lib.h"
30 #include "gnunet_protocols.h"
31 #include "gnunet_server_lib.h"
32 #include "gnunet_statistics_service.h"
33 #include "gnunet_strings_lib.h"
34 #include "statistics.h"
37 * How long do we wait until a statistics request for setting
38 * a value times out? (The update will be lost if the
39 * service does not react within this timeframe).
41 #define SET_TRANSMIT_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 2)
43 #define LOG(kind,...) GNUNET_log_from (kind, "statistics-api",__VA_ARGS__)
73 * Entry kept for each value we are watching.
75 struct GNUNET_STATISTICS_WatchEntry
79 * What subsystem is this action about? (never NULL)
84 * What value is this action about? (never NULL)
91 GNUNET_STATISTICS_Iterator proc;
102 * Linked list of things we still need to do.
104 struct GNUNET_STATISTICS_GetHandle
108 * This is a doubly linked list.
110 struct GNUNET_STATISTICS_GetHandle *next;
113 * This is a doubly linked list.
115 struct GNUNET_STATISTICS_GetHandle *prev;
118 * Main statistics handle.
120 struct GNUNET_STATISTICS_Handle *sh;
123 * What subsystem is this action about? (can be NULL)
128 * What value is this action about? (can be NULL)
133 * Continuation to call once action is complete.
135 GNUNET_STATISTICS_Callback cont;
138 * Function to call (for GET actions only).
140 GNUNET_STATISTICS_Iterator proc;
143 * Closure for proc and cont.
148 * Timeout for this action.
150 struct GNUNET_TIME_Absolute timeout;
158 * Flag for SET/UPDATE actions.
163 * Has the current iteration been aborted; for GET actions.
168 * Is this a GET, SET, UPDATE or WATCH?
170 enum ActionType type;
173 * Size of the message that we will be transmitting.
181 * Handle for the service.
183 struct GNUNET_STATISTICS_Handle
186 * Name of our subsystem.
191 * Configuration to use.
193 const struct GNUNET_CONFIGURATION_Handle *cfg;
196 * Socket (if available).
198 struct GNUNET_CLIENT_Connection *client;
201 * Currently pending transmission request.
203 struct GNUNET_CLIENT_TransmitHandle *th;
206 * Head of the linked list of pending actions (first action
209 struct GNUNET_STATISTICS_GetHandle *action_head;
212 * Tail of the linked list of actions (for fast append).
214 struct GNUNET_STATISTICS_GetHandle *action_tail;
217 * Action we are currently busy with (action request has been
218 * transmitted, we're now receiving the response from the
221 struct GNUNET_STATISTICS_GetHandle *current;
224 * Array of watch entries.
226 struct GNUNET_STATISTICS_WatchEntry **watches;
229 * Task doing exponential back-off trying to reconnect.
231 GNUNET_SCHEDULER_TaskIdentifier backoff_task;
234 * Time for next connect retry.
236 struct GNUNET_TIME_Relative backoff;
239 * Size of the 'watches' array.
241 unsigned int watches_size;
244 * Should this handle auto-destruct once all actions have
250 * Are we currently receiving from the service?
258 * Schedule the next action to be performed.
260 * @param h statistics handle to reconnect
263 schedule_action (struct GNUNET_STATISTICS_Handle *h);
267 * Transmit request to service that we want to watch
268 * the development of a particular value.
270 * @param h statistics handle
271 * @param watch watch entry of the value to watch
274 schedule_watch_request (struct GNUNET_STATISTICS_Handle *h,
275 struct GNUNET_STATISTICS_WatchEntry *watch)
278 struct GNUNET_STATISTICS_GetHandle *ai;
283 GNUNET_assert (h != NULL);
284 slen = strlen (watch->subsystem) + 1;
285 nlen = strlen (watch->name) + 1;
286 nsize = sizeof (struct GNUNET_MessageHeader) + slen + nlen;
287 if (nsize >= GNUNET_SERVER_MAX_MESSAGE_SIZE)
292 ai = GNUNET_malloc (sizeof (struct GNUNET_STATISTICS_GetHandle));
294 ai->subsystem = GNUNET_strdup (watch->subsystem);
295 ai->name = GNUNET_strdup (watch->name);
296 ai->timeout = GNUNET_TIME_UNIT_FOREVER_ABS;
298 ai->type = ACTION_WATCH;
299 ai->proc = watch->proc;
300 ai->cls = watch->proc_cls;
301 GNUNET_CONTAINER_DLL_insert_tail (h->action_head, h->action_tail,
308 * Free memory associated with the given action item.
310 * @param gh action item to free
313 free_action_item (struct GNUNET_STATISTICS_GetHandle *gh)
315 GNUNET_free_non_null (gh->subsystem);
316 GNUNET_free_non_null (gh->name);
322 * Disconnect from the statistics service.
324 * @param h statistics handle to disconnect from
327 do_disconnect (struct GNUNET_STATISTICS_Handle *h)
329 struct GNUNET_STATISTICS_GetHandle *c;
333 GNUNET_CLIENT_notify_transmit_ready_cancel (h->th);
336 if (NULL != h->client)
338 GNUNET_CLIENT_disconnect (h->client, GNUNET_NO);
341 h->receiving = GNUNET_NO;
342 if (NULL != (c = h->current))
346 c->cont (c->cls, GNUNET_SYSERR);
347 free_action_item (c);
353 * Try to (re)connect to the statistics service.
355 * @param h statistics handle to reconnect
356 * @return GNUNET_YES on success, GNUNET_NO on failure.
359 try_connect (struct GNUNET_STATISTICS_Handle *h)
361 struct GNUNET_STATISTICS_GetHandle *gh;
362 struct GNUNET_STATISTICS_GetHandle *gn;
365 if (h->backoff_task != GNUNET_SCHEDULER_NO_TASK)
367 if (h->client != NULL)
369 h->client = GNUNET_CLIENT_connect ("statistics", h->cfg);
370 if (h->client != NULL)
373 while (NULL != (gh = gn))
376 if (gh->type == ACTION_WATCH)
378 GNUNET_CONTAINER_DLL_remove (h->action_head,
381 free_action_item (gh);
384 for (i = 0; i < h->watches_size; i++)
385 schedule_watch_request (h, h->watches[i]);
388 LOG (GNUNET_ERROR_TYPE_DEBUG,
389 "Failed to connect to statistics service!\n");
395 * We've waited long enough, reconnect now.
397 * @param cls the 'struct GNUNET_STATISTICS_Handle' to reconnect
398 * @param tc scheduler context (unused)
401 reconnect_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
403 struct GNUNET_STATISTICS_Handle *h = cls;
405 h->backoff_task = GNUNET_SCHEDULER_NO_TASK;
411 * Reconnect at a later time, respecting back-off.
413 * @param h statistics handle
416 reconnect_later (struct GNUNET_STATISTICS_Handle *h)
418 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == h->backoff_task);
421 /* So we are shutting down and the service is not reachable.
422 * Chances are that it's down for good and we are not going to connect to
424 * Give up and don't sync the rest of the data.
427 h->do_destroy = GNUNET_NO;
428 GNUNET_STATISTICS_destroy (h, GNUNET_NO);
432 GNUNET_SCHEDULER_add_delayed (h->backoff, &reconnect_task, h);
433 h->backoff = GNUNET_TIME_relative_multiply (h->backoff, 2);
435 GNUNET_TIME_relative_min (h->backoff, GNUNET_CONSTANTS_SERVICE_TIMEOUT);
440 * Process a 'GNUNET_MESSAGE_TYPE_STATISTICS_VALUE' message.
442 * @param h statistics handle
443 * @param msg message received from the service, never NULL
444 * @return GNUNET_OK if the message was well-formed
447 process_statistics_value_message (struct GNUNET_STATISTICS_Handle *h,
448 const struct GNUNET_MessageHeader *msg)
452 const struct GNUNET_STATISTICS_ReplyMessage *smsg;
455 if (h->current->aborted)
457 LOG (GNUNET_ERROR_TYPE_DEBUG, "Iteration was aborted, ignoring VALUE\n");
458 return GNUNET_OK; /* don't bother */
460 size = ntohs (msg->size);
461 if (size < sizeof (struct GNUNET_STATISTICS_ReplyMessage))
464 return GNUNET_SYSERR;
466 smsg = (const struct GNUNET_STATISTICS_ReplyMessage *) msg;
467 size -= sizeof (struct GNUNET_STATISTICS_ReplyMessage);
469 GNUNET_STRINGS_buffer_tokenize ((const char *) &smsg[1], size, 2,
473 return GNUNET_SYSERR;
475 LOG (GNUNET_ERROR_TYPE_DEBUG, "Received valid statistic on `%s:%s': %llu\n",
476 service, name, GNUNET_ntohll (smsg->value));
478 h->current->proc (h->current->cls, service, name,
479 GNUNET_ntohll (smsg->value),
481 (ntohl (smsg->uid) & GNUNET_STATISTICS_PERSIST_BIT)))
483 LOG (GNUNET_ERROR_TYPE_DEBUG,
484 "Processing of remaining statistics aborted by client.\n");
485 h->current->aborted = GNUNET_YES;
487 LOG (GNUNET_ERROR_TYPE_DEBUG, "VALUE processed successfully\n");
493 * We have received a watch value from the service. Process it.
495 * @param h statistics handle
496 * @param msg the watch value message
497 * @return GNUNET_OK if the message was well-formed, GNUNET_SYSERR if not,
498 * GNUNET_NO if this watch has been cancelled
501 process_watch_value (struct GNUNET_STATISTICS_Handle *h,
502 const struct GNUNET_MessageHeader *msg)
504 const struct GNUNET_STATISTICS_WatchValueMessage *wvm;
505 struct GNUNET_STATISTICS_WatchEntry *w;
508 if (sizeof (struct GNUNET_STATISTICS_WatchValueMessage) != ntohs (msg->size))
511 return GNUNET_SYSERR;
513 wvm = (const struct GNUNET_STATISTICS_WatchValueMessage *) msg;
514 GNUNET_break (0 == ntohl (wvm->reserved));
515 wid = ntohl (wvm->wid);
516 if (wid >= h->watches_size)
519 return GNUNET_SYSERR;
524 (void) w->proc (w->proc_cls, w->subsystem, w->name,
525 GNUNET_ntohll (wvm->value),
526 0 != (ntohl (wvm->flags) & GNUNET_STATISTICS_PERSIST_BIT));
532 * Function called with messages from stats service.
535 * @param msg message received, NULL on timeout or fatal error
538 receive_stats (void *cls, const struct GNUNET_MessageHeader *msg)
540 struct GNUNET_STATISTICS_Handle *h = cls;
541 struct GNUNET_STATISTICS_GetHandle *c;
546 LOG (GNUNET_ERROR_TYPE_DEBUG | GNUNET_ERROR_TYPE_BULK,
547 "Error receiving statistics from service, is the service running?\n");
552 switch (ntohs (msg->type))
554 case GNUNET_MESSAGE_TYPE_STATISTICS_END:
555 LOG (GNUNET_ERROR_TYPE_DEBUG, "Received end of statistics marker\n");
556 if (NULL == (c = h->current))
563 h->backoff = GNUNET_TIME_UNIT_MILLISECONDS;
564 if (h->watches_size > 0)
566 GNUNET_CLIENT_receive (h->client, &receive_stats, h,
567 GNUNET_TIME_UNIT_FOREVER_REL);
571 h->receiving = GNUNET_NO;
576 c->cont (c->cls, GNUNET_OK);
577 free_action_item (c);
579 case GNUNET_MESSAGE_TYPE_STATISTICS_VALUE:
580 if (GNUNET_OK != process_statistics_value_message (h, msg))
586 /* finally, look for more! */
587 LOG (GNUNET_ERROR_TYPE_DEBUG,
588 "Processing VALUE done, now reading more\n");
589 GNUNET_CLIENT_receive (h->client, &receive_stats, h,
590 GNUNET_TIME_absolute_get_remaining (h->
592 h->backoff = GNUNET_TIME_UNIT_MILLISECONDS;
594 case GNUNET_MESSAGE_TYPE_STATISTICS_WATCH_VALUE:
596 (ret = process_watch_value (h, msg)))
599 if (GNUNET_NO == ret)
600 h->backoff = GNUNET_TIME_UNIT_MILLISECONDS;
604 h->backoff = GNUNET_TIME_UNIT_MILLISECONDS;
605 GNUNET_assert (h->watches_size > 0);
606 GNUNET_CLIENT_receive (h->client, &receive_stats, h,
607 GNUNET_TIME_UNIT_FOREVER_REL);
619 * Transmit a GET request (and if successful, start to receive
622 * @param handle statistics handle
623 * @param size how many bytes can we write to buf
624 * @param buf where to write requests to the service
625 * @return number of bytes written to buf
628 transmit_get (struct GNUNET_STATISTICS_Handle *handle, size_t size, void *buf)
630 struct GNUNET_STATISTICS_GetHandle *c;
631 struct GNUNET_MessageHeader *hdr;
636 GNUNET_assert (NULL != (c = handle->current));
639 /* timeout / error */
640 LOG (GNUNET_ERROR_TYPE_DEBUG,
641 "Transmission of request for statistics failed!\n");
642 do_disconnect (handle);
643 reconnect_later (handle);
646 slen1 = strlen (c->subsystem) + 1;
647 slen2 = strlen (c->name) + 1;
648 msize = slen1 + slen2 + sizeof (struct GNUNET_MessageHeader);
649 GNUNET_assert (msize <= size);
650 hdr = (struct GNUNET_MessageHeader *) buf;
651 hdr->size = htons (msize);
652 hdr->type = htons (GNUNET_MESSAGE_TYPE_STATISTICS_GET);
653 GNUNET_assert (slen1 + slen2 ==
654 GNUNET_STRINGS_buffer_fill ((char *) &hdr[1], slen1 + slen2, 2,
657 if (GNUNET_YES != handle->receiving)
659 LOG (GNUNET_ERROR_TYPE_DEBUG,
660 "Transmission of GET done, now reading response\n");
661 handle->receiving = GNUNET_YES;
662 GNUNET_CLIENT_receive (handle->client, &receive_stats, handle,
663 GNUNET_TIME_absolute_get_remaining (c->timeout));
670 * Transmit a WATCH request (and if successful, start to receive
673 * @param handle statistics handle
674 * @param size how many bytes can we write to buf
675 * @param buf where to write requests to the service
676 * @return number of bytes written to buf
679 transmit_watch (struct GNUNET_STATISTICS_Handle *handle, size_t size, void *buf)
681 struct GNUNET_MessageHeader *hdr;
688 /* timeout / error */
689 LOG (GNUNET_ERROR_TYPE_DEBUG,
690 "Transmission of request for statistics failed!\n");
691 do_disconnect (handle);
692 reconnect_later (handle);
695 LOG (GNUNET_ERROR_TYPE_DEBUG, "Transmitting watch request for `%s'\n",
696 handle->current->name);
697 slen1 = strlen (handle->current->subsystem) + 1;
698 slen2 = strlen (handle->current->name) + 1;
699 msize = slen1 + slen2 + sizeof (struct GNUNET_MessageHeader);
700 GNUNET_assert (msize <= size);
701 hdr = (struct GNUNET_MessageHeader *) buf;
702 hdr->size = htons (msize);
703 hdr->type = htons (GNUNET_MESSAGE_TYPE_STATISTICS_WATCH);
704 GNUNET_assert (slen1 + slen2 ==
705 GNUNET_STRINGS_buffer_fill ((char *) &hdr[1], slen1 + slen2, 2,
706 handle->current->subsystem,
707 handle->current->name));
708 if (GNUNET_YES != handle->receiving)
710 handle->receiving = GNUNET_YES;
711 GNUNET_CLIENT_receive (handle->client, &receive_stats, handle,
712 GNUNET_TIME_UNIT_FOREVER_REL);
714 GNUNET_assert (NULL == handle->current->cont);
715 free_action_item (handle->current);
716 handle->current = NULL;
722 * Transmit a SET/UPDATE request.
724 * @param handle statistics handle
725 * @param size how many bytes can we write to buf
726 * @param buf where to write requests to the service
727 * @return number of bytes written to buf
730 transmit_set (struct GNUNET_STATISTICS_Handle *handle, size_t size, void *buf)
732 struct GNUNET_STATISTICS_SetMessage *r;
739 do_disconnect (handle);
740 reconnect_later (handle);
743 slen = strlen (handle->current->subsystem) + 1;
744 nlen = strlen (handle->current->name) + 1;
745 nsize = sizeof (struct GNUNET_STATISTICS_SetMessage) + slen + nlen;
749 do_disconnect (handle);
750 reconnect_later (handle);
754 r->header.size = htons (nsize);
755 r->header.type = htons (GNUNET_MESSAGE_TYPE_STATISTICS_SET);
757 r->value = GNUNET_htonll (handle->current->value);
758 if (handle->current->make_persistent)
759 r->flags |= htonl (GNUNET_STATISTICS_SETFLAG_PERSISTENT);
760 if (handle->current->type == ACTION_UPDATE)
761 r->flags |= htonl (GNUNET_STATISTICS_SETFLAG_RELATIVE);
762 GNUNET_assert (slen + nlen ==
763 GNUNET_STRINGS_buffer_fill ((char *) &r[1], slen + nlen, 2,
764 handle->current->subsystem,
765 handle->current->name));
766 GNUNET_assert (NULL == handle->current->cont);
767 free_action_item (handle->current);
768 handle->current = NULL;
774 * Function called when we are ready to transmit a request to the service.
776 * @param cls the 'struct GNUNET_STATISTICS_Handle'
777 * @param size how many bytes can we write to buf
778 * @param buf where to write requests to the service
779 * @return number of bytes written to buf
782 transmit_action (void *cls, size_t size, void *buf)
784 struct GNUNET_STATISTICS_Handle *h = cls;
789 if (NULL != h->current)
790 switch (h->current->type)
793 ret = transmit_get (h, size, buf);
797 ret = transmit_set (h, size, buf);
800 ret = transmit_watch (h, size, buf);
812 * Get handle for the statistics service.
814 * @param subsystem name of subsystem using the service
815 * @param cfg services configuration in use
816 * @return handle to use
818 struct GNUNET_STATISTICS_Handle *
819 GNUNET_STATISTICS_create (const char *subsystem,
820 const struct GNUNET_CONFIGURATION_Handle *cfg)
822 struct GNUNET_STATISTICS_Handle *ret;
824 GNUNET_assert (subsystem != NULL);
825 GNUNET_assert (cfg != NULL);
826 ret = GNUNET_malloc (sizeof (struct GNUNET_STATISTICS_Handle));
828 ret->subsystem = GNUNET_strdup (subsystem);
829 ret->backoff = GNUNET_TIME_UNIT_MILLISECONDS;
835 * Destroy a handle (free all state associated with
838 * @param h statistics handle to destroy
839 * @param sync_first set to GNUNET_YES if pending SET requests should
843 GNUNET_STATISTICS_destroy (struct GNUNET_STATISTICS_Handle *h, int sync_first)
845 struct GNUNET_STATISTICS_GetHandle *pos;
846 struct GNUNET_STATISTICS_GetHandle *next;
847 struct GNUNET_TIME_Relative timeout;
852 GNUNET_assert (GNUNET_NO == h->do_destroy); // Don't call twice.
853 if (GNUNET_SCHEDULER_NO_TASK != h->backoff_task)
855 GNUNET_SCHEDULER_cancel (h->backoff_task);
856 h->backoff_task = GNUNET_SCHEDULER_NO_TASK;
860 if (h->current != NULL)
862 if (h->current->type == ACTION_GET)
864 GNUNET_CLIENT_notify_transmit_ready_cancel (h->th);
866 free_action_item (h->current);
870 next = h->action_head;
871 while (NULL != (pos = next))
874 if (pos->type == ACTION_GET)
876 GNUNET_CONTAINER_DLL_remove (h->action_head,
879 free_action_item (pos);
882 if ( (NULL == h->current) &&
883 (NULL != (h->current = h->action_head)) )
884 GNUNET_CONTAINER_DLL_remove (h->action_head,
887 h->do_destroy = GNUNET_YES;
888 if ((h->current != NULL) && (h->th == NULL))
890 if (NULL == h->client)
892 /* instant-connect (regardless of back-off) to submit final value */
893 h->client = GNUNET_CLIENT_connect ("statistics", h->cfg);
895 if (NULL != h->client)
897 timeout = GNUNET_TIME_absolute_get_remaining (h->current->timeout);
899 GNUNET_CLIENT_notify_transmit_ready (h->client, h->current->msize,
901 &transmit_action, h);
902 GNUNET_assert (NULL != h->th);
906 return; /* do not finish destruction just yet */
908 while (NULL != (pos = h->action_head))
910 GNUNET_CONTAINER_DLL_remove (h->action_head,
913 free_action_item (pos);
916 for (i = 0; i < h->watches_size; i++)
918 if (NULL == h->watches[i])
920 GNUNET_free (h->watches[i]->subsystem);
921 GNUNET_free (h->watches[i]->name);
922 GNUNET_free (h->watches[i]);
924 GNUNET_array_grow (h->watches, h->watches_size, 0);
925 GNUNET_free (h->subsystem);
931 * Schedule the next action to be performed.
933 * @param h statistics handle
936 schedule_action (struct GNUNET_STATISTICS_Handle *h)
938 struct GNUNET_TIME_Relative timeout;
940 if ( (h->th != NULL) ||
941 (h->backoff_task != GNUNET_SCHEDULER_NO_TASK) )
942 return; /* action already pending */
943 if (GNUNET_YES != try_connect (h))
948 if (NULL != h->current)
949 return; /* action already pending */
950 /* schedule next action */
951 h->current = h->action_head;
952 if (NULL == h->current)
956 h->do_destroy = GNUNET_NO;
957 GNUNET_STATISTICS_destroy (h, GNUNET_YES);
961 GNUNET_CONTAINER_DLL_remove (h->action_head, h->action_tail, h->current);
962 timeout = GNUNET_TIME_absolute_get_remaining (h->current->timeout);
965 GNUNET_CLIENT_notify_transmit_ready (h->client, h->current->msize,
967 &transmit_action, h)))
969 LOG (GNUNET_ERROR_TYPE_DEBUG,
970 "Failed to transmit request to statistics service.\n");
978 * Get statistic from the peer.
980 * @param handle identification of the statistics service
981 * @param subsystem limit to the specified subsystem, NULL for our subsystem
982 * @param name name of the statistic value, NULL for all values
983 * @param timeout after how long should we give up (and call
984 * cont with an error code)?
985 * @param cont continuation to call when done (can be NULL)
986 * @param proc function to call on each value
987 * @param cls closure for cont and proc
988 * @return NULL on error
990 struct GNUNET_STATISTICS_GetHandle *
991 GNUNET_STATISTICS_get (struct GNUNET_STATISTICS_Handle *handle,
992 const char *subsystem, const char *name,
993 struct GNUNET_TIME_Relative timeout,
994 GNUNET_STATISTICS_Callback cont,
995 GNUNET_STATISTICS_Iterator proc, void *cls)
999 struct GNUNET_STATISTICS_GetHandle *ai;
1003 GNUNET_assert (proc != NULL);
1004 GNUNET_assert (GNUNET_NO == handle->do_destroy);
1005 if (subsystem == NULL)
1009 slen1 = strlen (subsystem) + 1;
1010 slen2 = strlen (name) + 1;
1011 GNUNET_assert (slen1 + slen2 + sizeof (struct GNUNET_MessageHeader) <
1012 GNUNET_SERVER_MAX_MESSAGE_SIZE);
1013 ai = GNUNET_malloc (sizeof (struct GNUNET_STATISTICS_GetHandle));
1015 ai->subsystem = GNUNET_strdup (subsystem);
1016 ai->name = GNUNET_strdup (name);
1020 ai->timeout = GNUNET_TIME_relative_to_absolute (timeout);
1021 ai->type = ACTION_GET;
1022 ai->msize = slen1 + slen2 + sizeof (struct GNUNET_MessageHeader);
1023 GNUNET_CONTAINER_DLL_insert_tail (handle->action_head, handle->action_tail,
1025 schedule_action (handle);
1031 * Cancel a 'get' request. Must be called before the 'cont'
1032 * function is called.
1034 * @param gh handle of the request to cancel
1037 GNUNET_STATISTICS_get_cancel (struct GNUNET_STATISTICS_GetHandle *gh)
1041 if (gh->sh->current == gh)
1043 gh->aborted = GNUNET_YES;
1047 GNUNET_CONTAINER_DLL_remove (gh->sh->action_head, gh->sh->action_tail, gh);
1048 GNUNET_free (gh->name);
1049 GNUNET_free (gh->subsystem);
1056 * Watch statistics from the peer (be notified whenever they change).
1058 * @param handle identification of the statistics service
1059 * @param subsystem limit to the specified subsystem, never NULL
1060 * @param name name of the statistic value, never NULL
1061 * @param proc function to call on each value
1062 * @param proc_cls closure for proc
1063 * @return GNUNET_OK on success, GNUNET_SYSERR on error
1066 GNUNET_STATISTICS_watch (struct GNUNET_STATISTICS_Handle *handle,
1067 const char *subsystem, const char *name,
1068 GNUNET_STATISTICS_Iterator proc, void *proc_cls)
1070 struct GNUNET_STATISTICS_WatchEntry *w;
1073 return GNUNET_SYSERR;
1074 w = GNUNET_malloc (sizeof (struct GNUNET_STATISTICS_WatchEntry));
1075 w->subsystem = GNUNET_strdup (subsystem);
1076 w->name = GNUNET_strdup (name);
1078 w->proc_cls = proc_cls;
1079 GNUNET_array_append (handle->watches, handle->watches_size, w);
1080 schedule_watch_request (handle, w);
1086 * Stop watching statistics from the peer.
1088 * @param handle identification of the statistics service
1089 * @param subsystem limit to the specified subsystem, never NULL
1090 * @param name name of the statistic value, never NULL
1091 * @param proc function to call on each value
1092 * @param proc_cls closure for proc
1093 * @return GNUNET_OK on success, GNUNET_SYSERR on error (no such watch)
1096 GNUNET_STATISTICS_watch_cancel (struct GNUNET_STATISTICS_Handle *handle,
1097 const char *subsystem, const char *name,
1098 GNUNET_STATISTICS_Iterator proc, void *proc_cls)
1100 struct GNUNET_STATISTICS_WatchEntry *w;
1104 return GNUNET_SYSERR;
1105 for (i=0;i<handle->watches_size;i++)
1107 w = handle->watches[i];
1108 if ( (w->proc == proc) &&
1109 (w->proc_cls == proc_cls) &&
1110 (0 == strcmp (w->name, name)) &&
1111 (0 == strcmp (w->subsystem, subsystem)) )
1113 GNUNET_free (w->name);
1114 GNUNET_free (w->subsystem);
1116 handle->watches[i] = NULL;
1120 return GNUNET_SYSERR;
1126 * Queue a request to change a statistic.
1128 * @param h statistics handle
1129 * @param name name of the value
1130 * @param make_persistent should the value be kept across restarts?
1131 * @param value new value or change
1132 * @param type type of the action (ACTION_SET or ACTION_UPDATE)
1135 add_setter_action (struct GNUNET_STATISTICS_Handle *h, const char *name,
1136 int make_persistent, uint64_t value, enum ActionType type)
1138 struct GNUNET_STATISTICS_GetHandle *ai;
1144 GNUNET_assert (h != NULL);
1145 GNUNET_assert (name != NULL);
1146 slen = strlen (h->subsystem) + 1;
1147 nlen = strlen (name) + 1;
1148 nsize = sizeof (struct GNUNET_STATISTICS_SetMessage) + slen + nlen;
1149 if (nsize >= GNUNET_SERVER_MAX_MESSAGE_SIZE)
1154 for (ai = h->action_head; ai != NULL; ai = ai->next)
1156 if (! ( (0 == strcmp (ai->subsystem, h->subsystem)) &&
1157 (0 == strcmp (ai->name, name)) &&
1158 ( (ai->type == ACTION_UPDATE) ||
1159 (ai->type == ACTION_SET) ) ) )
1161 if (ai->type == ACTION_SET)
1163 if (type == ACTION_UPDATE)
1165 delta = (int64_t) value;
1168 /* update old set by new delta */
1173 /* update old set by new delta, but never go negative */
1174 if (ai->value < -delta)
1182 /* new set overrides old set */
1188 if (type == ACTION_UPDATE)
1190 /* make delta cummulative */
1191 delta = (int64_t) value;
1196 /* drop old 'update', use new 'set' instead */
1201 ai->timeout = GNUNET_TIME_relative_to_absolute (SET_TRANSMIT_TIMEOUT);
1202 ai->make_persistent = make_persistent;
1205 /* no existing entry matches, create a fresh one */
1206 ai = GNUNET_malloc (sizeof (struct GNUNET_STATISTICS_GetHandle));
1208 ai->subsystem = GNUNET_strdup (h->subsystem);
1209 ai->name = GNUNET_strdup (name);
1210 ai->timeout = GNUNET_TIME_relative_to_absolute (SET_TRANSMIT_TIMEOUT);
1211 ai->make_persistent = make_persistent;
1215 GNUNET_CONTAINER_DLL_insert_tail (h->action_head, h->action_tail,
1217 schedule_action (h);
1222 * Set statistic value for the peer. Will always use our
1223 * subsystem (the argument used when "handle" was created).
1225 * @param handle identification of the statistics service
1226 * @param name name of the statistic value
1227 * @param value new value to set
1228 * @param make_persistent should the value be kept across restarts?
1231 GNUNET_STATISTICS_set (struct GNUNET_STATISTICS_Handle *handle,
1232 const char *name, uint64_t value, int make_persistent)
1236 GNUNET_assert (GNUNET_NO == handle->do_destroy);
1237 add_setter_action (handle, name, make_persistent, value, ACTION_SET);
1242 * Set statistic value for the peer. Will always use our
1243 * subsystem (the argument used when "handle" was created).
1245 * @param handle identification of the statistics service
1246 * @param name name of the statistic value
1247 * @param delta change in value (added to existing value)
1248 * @param make_persistent should the value be kept across restarts?
1251 GNUNET_STATISTICS_update (struct GNUNET_STATISTICS_Handle *handle,
1252 const char *name, int64_t delta, int make_persistent)
1258 GNUNET_assert (GNUNET_NO == handle->do_destroy);
1259 add_setter_action (handle, name, make_persistent, (uint64_t) delta,
1264 /* end of statistics_api.c */