[GNUnet-SVN] r22003 - in gnunet/src: include mesh

[gnunet]

Author: bartpolot
Date: 2012-06-14 17:21:42 +0200 (Thu, 14 Jun 2012)
New Revision: 22003

Modified:
   gnunet/src/include/gnunet_mesh_service.h
   gnunet/src/mesh/mesh_api.c
Log:
- clarify doxygen

Modified: gnunet/src/include/gnunet_mesh_service.h
===================================================================
--- gnunet/src/include/gnunet_mesh_service.h    2012-06-14 15:19:35 UTC (rev 
22002)
+++ gnunet/src/include/gnunet_mesh_service.h    2012-06-14 15:21:42 UTC (rev 
22003)
@@ -224,7 +224,7 @@
 
 
 /**
- * Store the given regex (describing offered local services) in the DHT,
+ * Announce to ther peer the availability of services described by the regex,
  * in order to be reachable to other peers via connect_by_string.
  *
  * @param h handle to mesh.

Modified: gnunet/src/mesh/mesh_api.c
===================================================================
--- gnunet/src/mesh/mesh_api.c  2012-06-14 15:19:35 UTC (rev 22002)
+++ gnunet/src/mesh/mesh_api.c  2012-06-14 15:21:42 UTC (rev 22003)
@@ -1567,6 +1567,45 @@
 
 
 /**
+ * Request that the mesh should try to connect to a peer matching the
+ * description given in the service string.
+ *
+ * @param tunnel handle to existing tunnel
+ * @param description string describing the destination node requirements
+ */
+void
+GNUNET_MESH_peer_request_connect_by_string (struct GNUNET_MESH_Tunnel *tunnel,
+                                            const char *description);
+
+
+/**
+ * Request that the given peer isn't added to this tunnel in calls to
+ * connect_by_* calls, (due to misbehaviour, bad performance, ...).
+ *
+ * @param tunnel handle to existing tunnel.
+ * @param peer peer identity of the peer which should be blacklisted
+ *                  for the tunnel.
+ */
+void
+GNUNET_MESH_peer_blacklist (struct GNUNET_MESH_Tunnel *tunnel,
+                            const struct GNUNET_PeerIdentity *peer);
+
+
+/**
+ * Request that the given peer isn't blacklisted anymore from this tunnel,
+ * and therefore can be added in future calls to connect_by_*.
+ * The peer must have been previously blacklisted for this tunnel.
+ *
+ * @param tunnel handle to existing tunnel.
+ * @param peer peer identity of the peer which shouldn't be blacklisted
+ *                  for the tunnel anymore.
+ */
+void
+GNUNET_MESH_peer_unblacklist (struct GNUNET_MESH_Tunnel *tunnel,
+                              const struct GNUNET_PeerIdentity *peer);
+
+
+/**
  * Ask the mesh to call "notify" once it is ready to transmit the
  * given number of bytes to the specified "target".  If we are not yet
  * connected to the specified peer, a call to this function will cause