[GNUnet-SVN] r27634 - gnunet/src/include

[gnunet]

Author: tg
Date: 2013-06-26 19:13:01 +0200 (Wed, 26 Jun 2013)
New Revision: 27634

Modified:
   gnunet/src/include/gnunet_multicast_service.h
   gnunet/src/include/gnunet_protocols.h
Log:
multicast message types and api docs

Modified: gnunet/src/include/gnunet_multicast_service.h
===================================================================
--- gnunet/src/include/gnunet_multicast_service.h       2013-06-26 17:12:59 UTC 
(rev 27633)
+++ gnunet/src/include/gnunet_multicast_service.h       2013-06-26 17:13:01 UTC 
(rev 27634)
@@ -22,6 +22,7 @@
  * @file include/gnunet_multicast_service.h
  * @brief multicast service; establish tunnels to distant peers
  * @author Christian Grothoff
+ * @author tg(x)
  */
 
 #ifndef GNUNET_MULTICAST_SERVICE_H
@@ -71,7 +72,7 @@
    * distributed to current group members.  This includes the group
    * state as well as transient messages.
    */
-  GNUNET_MULTICAST_JP_PRIVATE = 1
+  GNUNET_MULTICAST_JP_PRIVATE = 1,
 
 #if IDEAS_FOR_FUTURE
   /** 
@@ -82,7 +83,13 @@
    * guaranteed, the presistent group state can be synchronized freely
    * immediately, prior to origin confirmation.
    */
-  GNUNET_MULTICAST_JP_OPEN = 2
+  GNUNET_MULTICAST_JP_OPEN = 2,
+
+  /**
+   * Origin must approve membership to the group, but past messages can be
+   * freely distributed to members.
+   */
+  GNUNET_MULTICAST_JP_CLOSED = 3,
 #endif
 
 };
@@ -187,6 +194,11 @@
 
   /** 
    * Counter that monotonically increases whenever a member leaves the group.
+   *
+   * It has significance in case of replay requests: when a member has missed
+   * messages and gets a replay request: in this case if the @a 
group_generation
+   * is still the same before and after the missed messages, it means that no
+   * @e join or @a leave operations happened during the missed messages.
    */
   uint64_t group_generation GNUNET_PACKED;
 

Modified: gnunet/src/include/gnunet_protocols.h
===================================================================
--- gnunet/src/include/gnunet_protocols.h       2013-06-26 17:12:59 UTC (rev 
27633)
+++ gnunet/src/include/gnunet_protocols.h       2013-06-26 17:13:01 UTC (rev 
27634)
@@ -24,6 +24,13 @@
  * @author Christian Grothoff
  */
 
+/*******************************************************************************
+ * TODO: we need a way to register message types centrally (via some webpage).
+ * For now: unofficial extensions should start at 48k, internal extensions
+ * define here should leave some room (4-10 additional messages to the previous
+ * extension).
+ 
******************************************************************************/
+
 #ifndef GNUNET_PROTOCOLS_H
 #define GNUNET_PROTOCOLS_H
 
@@ -1872,13 +1879,6 @@
  */
 
 
/*******************************************************************************
- * TODO: we need a way to register message types centrally (via some webpage).
- * For now: unofficial extensions should start at 48k, internal extensions
- * define here should leave some room (4-10 additional messages to the previous
- * extension).
- 
******************************************************************************/
-
-/*******************************************************************************
  * EXPERIMENTATION message types
  
******************************************************************************/
 
@@ -1913,7 +1913,63 @@
  */
 
 
+
+
+/* WIP: no numbers assigned yet */
+
+/*******************************************************************************
+ * MULTICAST message types
+ 
******************************************************************************/
+
 /**
+ * Multicast message, from origin to all members
+ */
+#define GNUNET_MESSAGE_TYPE_MULTICAST_MESSAGE
+
+/**
+ * A peer joined the group.
+ */
+#define GNUNET_MESSAGE_TYPE_MULTICAST_JOIN
+
+/**
+ * A peer left the group.
+ */
+#define GNUNET_MESSAGE_TYPE_MULTICAST_LEAVE
+
+/**
+ * Message from a peer to origin.
+ */
+#define GNUNET_MESSAGE_TYPE_MULTICAST_PEER_MESSAGE
+
+/**
+ * A peer wants to join the group.
+ */
+#define GNUNET_MESSAGE_TYPE_MULTICAST_PEER_JOIN
+
+/**
+ * A peer wants to leave the group.
+ */
+#define GNUNET_MESSAGE_TYPE_MULTICAST_PEER_LEAVE
+
+/**
+ * Group terminated.
+ */
+#define GNUNET_MESSAGE_TYPE_MULTICAST_GROUP_END
+
+/*******************************************************************************
+ * PSYC message types
+ 
******************************************************************************/
+
+/*******************************************************************************
+ * PSYCSTORE message types
+ 
******************************************************************************/
+
+/*******************************************************************************
+ * SOCIAL message types
+ 
******************************************************************************/
+
+
+/**
  * Type used to match 'all' message types.
  */
 #define GNUNET_MESSAGE_TYPE_ALL 65535