/*
This file is part of GNUnet.
- (C) 2001, 2002, 2003, 2004, 2009 Christian Grothoff (and other contributing authors)
+ Copyright (C) 2001-2014 GNUnet e.V.
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
- by the Free Software Foundation; either version 2, or (at your
+ by the Free Software Foundation; either version 3, or (at your
option) any later version.
GNUnet is distributed in the hope that it will be useful, but
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
+ Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
*/
/**
#include "gnunet_common.h"
-#define DEBUG_STATISTICS 0
+
+GNUNET_NETWORK_STRUCT_BEGIN
/**
* Statistics message. Contains how long the system is up
/**
* Unique numerical identifier for the value (will
* not change during the same client-session). Highest
- * bit will be set for persistent values.
+ * bit will be set for persistent values (see
+ * #GNUNET_STATISTICS_PERSIST_BIT).
*/
uint32_t uid GNUNET_PACKED;
};
+/**
+ * Flag for the `struct GNUNET_STATISTICS_ReplyMessage` UID only.
+ * Note that other messages use #GNUNET_STATISTICS_SETFLAG_PERSISTENT.
+ */
#define GNUNET_STATISTICS_PERSIST_BIT (1<<31)
+/**
+ * The value being set is an absolute change.
+ */
#define GNUNET_STATISTICS_SETFLAG_ABSOLUTE 0
+/**
+ * The value being set is a relative change.
+ */
#define GNUNET_STATISTICS_SETFLAG_RELATIVE 1
+/**
+ * The value being set is to be persistent (note that
+ * this bit can be combined with #GNUNET_STATISTICS_SETFLAG_RELATIVE).
+ * This value must not be used for the `uid` member of
+ * `struct GNUNET_STATISTICS_ReplyMessage`!
+ */
#define GNUNET_STATISTICS_SETFLAG_PERSISTENT 2
+
/**
* Message to set a statistic. Followed
* by the subsystem name and the name of
struct GNUNET_STATISTICS_SetMessage
{
/**
- * Type: GNUNET_MESSAGE_TYPE_STATISTICS_SET
+ * Type: #GNUNET_MESSAGE_TYPE_STATISTICS_SET
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * 0 for absolute value, 1 for relative value; 2 to make persistent
+ * (see GNUNET_STATISTICS_SETFLAG_*).
+ */
+ uint32_t flags GNUNET_PACKED;
+
+ /**
+ * Value. Note that if this is a relative value, it will
+ * be signed even though the type given here is unsigned.
+ */
+ uint64_t value GNUNET_PACKED;
+
+};
+
+
+/**
+ * Message transmitted if a watched value changes.
+ */
+struct GNUNET_STATISTICS_WatchValueMessage
+{
+ /**
+ * Type: #GNUNET_MESSAGE_TYPE_STATISTICS_WATCH_VALUE
*/
struct GNUNET_MessageHeader header;
*/
uint32_t flags GNUNET_PACKED;
+ /**
+ * Unique watch identification number (watch
+ * requests are enumerated in the order they
+ * are received, the first request having
+ * a wid of zero).
+ */
+ uint32_t wid GNUNET_PACKED;
+
+ /**
+ * Reserved (always 0).
+ */
+ uint32_t reserved GNUNET_PACKED;
+
/**
* Value. Note that if this is a relative value, it will
* be signed even though the type given here is unsigned.
uint64_t value GNUNET_PACKED;
};
+GNUNET_NETWORK_STRUCT_END
#endif