prototype of the new matrix bandwidth test

[simgrid.git] / include / amok / bandwidth.h

diff --git a/include/amok/bandwidth.h b/include/amok/bandwidth.h
index 271bb9a..9dc9e23 100644 (file)
--- a/include/amok/bandwidth.h
+++ b/include/amok/bandwidth.h
@@ -43,7 +43,7 @@
  *  get the BW between two remote hosts. The elapsed time, as long as the
  *  achieved bandwidth is returned in the last arguments of the functions.
  * 
- *  All sizes are in kilo bytes. The \a buf_size is the size of the buffer
+ *  All sizes are in bytes. The \a buf_size is the size of the buffer
  *   (this is a socket parameter set automatically). The \a exp_size is the
  *   amount of data to send during an experiment. \a msg_size is the size
  *   of each message sent. These values allow you to study phenomenon such
@@ -54,6 +54,10 @@
  *   messages of 16k will be sent (so that the total amount of data equals
  *   64k). Of course, you can use other values if you want to.
  * 
+ *  \htmlonly
+ * <img align=center src="amok_bw_test.png" alt="amok bandwidth measurement protocol"><br>
+ * \endhtmlonly
+ * 
  *  \todo Cleanup and implement the link saturation stuff.
  *
  *  @{
@@ -71,6 +75,9 @@ void amok_bw_request(const char* from_name,unsigned int from_port,
                     unsigned long int buf_size,unsigned long int exp_size,unsigned long int msg_size,
             /*OUT*/ double *sec, double*bw);
 
+double * amok_bw_matrix(xbt_dynar_t hosts, /* dynar of xbt_host_t */
+                        int buf_size_bw, int exp_size_bw, int msg_size_bw);
+
 /** @} */
 #if 0