[GNUnet-SVN] r27303 - gnunet/src/experimentation

[gnunet]

Author: wachs
Date: 2013-05-27 10:09:35 +0200 (Mon, 27 May 2013)
New Revision: 27303

Modified:
   gnunet/src/experimentation/gnunet-daemon-experimentation.c
   gnunet/src/experimentation/gnunet-daemon-experimentation.h
   gnunet/src/experimentation/gnunet-daemon-experimentation_capabilities.c
Log:
documentation


Modified: gnunet/src/experimentation/gnunet-daemon-experimentation.c
===================================================================
--- gnunet/src/experimentation/gnunet-daemon-experimentation.c  2013-05-27 
07:40:13 UTC (rev 27302)
+++ gnunet/src/experimentation/gnunet-daemon-experimentation.c  2013-05-27 
08:09:35 UTC (rev 27303)
@@ -31,12 +31,21 @@
 #include "gnunet_statistics_service.h"
 #include "gnunet-daemon-experimentation.h"
 
+
+/**
+ * Statistics handle shared between components
+ */
 struct GNUNET_STATISTICS_Handle *GSE_stats;
 
+
+/**
+ * Configuration handle shared between components
+ */
 struct GNUNET_CONFIGURATION_Handle *GSE_cfg;
 
+
 /**
- * Task run during shutdown.
+ * Task run during shutdown to stop all submodules of the experimentation 
daemon.
  *
  * @param cls unused
  * @param tc unused
@@ -51,7 +60,6 @@
 }
 
 
-
 /**
  * Function starting all submodules of the experimentation daemon.
  *

Modified: gnunet/src/experimentation/gnunet-daemon-experimentation.h
===================================================================
--- gnunet/src/experimentation/gnunet-daemon-experimentation.h  2013-05-27 
07:40:13 UTC (rev 27302)
+++ gnunet/src/experimentation/gnunet-daemon-experimentation.h  2013-05-27 
08:09:35 UTC (rev 27303)
@@ -36,12 +36,25 @@
  */
 #define EXP_RESPONSE_TIMEOUT GNUNET_TIME_relative_multiply 
(GNUNET_TIME_UNIT_SECONDS, 10)
 
+
+/**
+ * Statistics handle shared between components
+ */
 extern struct GNUNET_STATISTICS_Handle *GSE_stats;
 
+
+/**
+ * Configuration handle shared between components
+ */
 extern struct GNUNET_CONFIGURATION_Handle *GSE_cfg;
 
+
+/**
+ * Capability value shared between components
+ */
 extern uint32_t GSE_node_capabilities;
 
+
 /**
  * Capabilities a node has or an experiment requires
  */
@@ -120,21 +133,35 @@
 void
 GNUNET_EXPERIMENTATION_nodes_stop ();
 
+
 /**
+ * Print a single capability value
+ *
+ * @param cap capability value
+ * @return the string to print
+ */
+const char *
+GNUNET_EXPERIMENTATION_capability_to_str (uint32_t cap);
+
+
+/**
  * Are the capabilities provided?
  *
  * @param have bitstring containing the provided capabilities
- * @param have bitstring containing the desired capabilities
+ * @param desired bitstring containing the desired capabilities\
+ * @return GNUNET_YES or GNUNET_NO
  */
 int
 GNUNET_EXPERIMENTATION_capabilities_have (uint32_t have, uint32_t desired);
 
+
 /**
  * Start the detecting capabilities
  */
 void
 GNUNET_EXPERIMENTATION_capabilities_start ();
 
+
 /**
  * Stop the detecting capabilities
  */
@@ -159,6 +186,7 @@
 int
 GNUNET_EXPERIMENTATION_experiments_start ();
 
+
 /**
  * Stop experiments management
  */

Modified: 
gnunet/src/experimentation/gnunet-daemon-experimentation_capabilities.c
===================================================================
--- gnunet/src/experimentation/gnunet-daemon-experimentation_capabilities.c     
2013-05-27 07:40:13 UTC (rev 27302)
+++ gnunet/src/experimentation/gnunet-daemon-experimentation_capabilities.c     
2013-05-27 08:09:35 UTC (rev 27303)
@@ -41,6 +41,13 @@
  */
 #define GNUNET_EXPERIMENTATION_capabilities_string {"NONE", "PLUGIN_TCP", 
"PLUGIN_UDP", "PLUGIN_UNIX", "PLUGIN_HTTP_CLIENT", "PLUGIN_HTTP_SERVER", 
"PLUGIN_HTTPS_CLIENT", "PLUGIN_HTTPS_SERVER", "PLUGIN_WLAN", "HAVE_IPV6", 
"BEHIND_NAT"}
 
+
+/**
+ * Print a single capability value
+ *
+ * @param cap capability value
+ * @return the string to print
+ */
 const char *
 GNUNET_EXPERIMENTATION_capability_to_str (uint32_t cap)
 {
@@ -65,11 +72,13 @@
 
 }
 
+
 /**
  * Are the capabilities provided?
  *
  * @param have bitstring containing the provided capabilities
- * @param have bitstring containing the desired capabilities
+ * @param desired bitstring containing the desired capabilities\
+ * @return GNUNET_YES or GNUNET_NO
  */
 int
 GNUNET_EXPERIMENTATION_capabilities_have (uint32_t have, uint32_t desired)
@@ -83,8 +92,6 @@
 
 /**
  * Start the detecting capabilities
- *
- * @param cfg configuration handle
  */
 void
 GNUNET_EXPERIMENTATION_capabilities_start ()