Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
ChangeLog: spell checking, and whitespace cleanup.
[simgrid.git] / ChangeLog
index bc77f6c..bad8650 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
-SimGrid (3.7) NOT RELEASED; urgency=low 
+SimGrid (3.7) NOT RELEASED; urgency=low
+
+  The "sprint cleanups (before spring)" release.
 
   Models:
+  * We can specify the smpi latency/bandwidth factor with command line
+    add --cfg=smpi/bw_factor:"threshold0:value0;...;thresholdN:valueN"
+    or add --cfg=smpi/lat_factor:"threshold0:value0;...;thresholdN:valueN"
+    You can also use the "config tag" from platform file by adding this line
+    <prop id="smpi/bw_factor" value="threshold0:value0;...;thresholdN:valueN"></prop>
+    (see "example/platforms/tag_config.xml" to use "config tag").
+    Note that the command line supersedes the platform file configuration.
+  * Change the correction factors used in LMM model, according to
+    the latest experiments described in INRIA RR-7821.
+    Accuracy should be improved this way.
+    (TODO: this is not true in the code, yet)
   * Use the partial invalidation optimization by default for the
     network too. Should produce the exact same results, only faster.
+  * Major cleanup in surf to merge models and split some optimization
+    mechanisms from the core of the models. As a result you can now
+    specify which model to use (e.g., --cfg=network/model:LV08
+    --cfg=cpu/model:Cas01) and which optimization mode to use
+    (e.g., --cfg=network/optim:lazy --cfg=cpu/optim:TI).
+    Incompatible combinations should err at initialization. See
+    --help-models for the list of all models and optimization modes.
+  * The CLM03 workstation model were dropped for simplicity because it
+    used the deprecated CM02 network model. Use default instead.
+  * Rename the TCP_gamma configuration option to network/TCP_gamma
+  * Rename the coordinates configuration option to
+    network/coordinates, and document it
+  * Use now crosstraffic keyword instead of the terribly misleading
+    fullduplex keyword. It is activated by default now in the current
+    default model, use --cfg=network/crosstraffic:0 to turn it off.
+  * Experimental: new configuration option --cfg=surf/nthreads:N to run
+    analytical models in parallel with N threads (default is 1).
+  * Ongoing refactoring the model parsing to make XML files optional
+    (more work is needed here to fully achieve this goal)
+
+  MSG:
+  * Deprecate the MSG_task_{get,put} functions and friends.
+    This interface were considered as deprecated since over 2 years,
+     it's time to inform our users that it is.
+    Switch to MSG_task_{send,recv} instead, or declare
+     SIMGRID_DEPRECATED before loading the msg.h if you really need to
+     use these (crappy) functions in your code.
+    These functions will be removed at some point. Stop using them now.
+
+  Simix:
+  * Stabilize the parallel execution mode of user contexts
+  * Introduce configuration variables to control parallel execution:
+    - contexts/synchro: Synchronization mode to use when running
+      contexts in parallel (either futex, posix or busy_wait)
+    - contexts/parallel_threshold: Minimal number of user contexts
+      to be run in parallel (raw contexts only)
+
+  SURF:
+  * Introduce a parallel mode for the models (see surf/nthreads
+     configuration item). In our tests, running the models in parallel
+     never lead to any speedups because they are so fast that the gain
+     of computing each model in parallel does not amortizes the
+     synchronization costs, even when ultra fast futexes are used.
+    This is released anyway because YMMV.
 
   SimDag:
   * Performance boost by using a swag internally to compute the set of
     tasks that are finished and should constitute the return value of
     SD_simulate.
 
+  SMPI:
+  * Enable it by default now that it is considered rather stable.
+
+  XBT:
+  * Mallocators: allow value NULL for the reset function.
+  * Dicts: new function xbt_dict_new_homogeneous(void(*)(void*)) to
+    create homogeneous dictionaries, where all the elements share the
+    same free function. Non homogeneous dictionaries will be
+    deprecated in the next release.
+  * mmalloc module:
+    - cleanups and simplifications to make it maintainable again
+    - exotic features (such as memalign and valloc) were removed
+    - The metadata were extended and improved so that the
+      model-checker becomes able to explore and inspect the heaps.
+    - This may induce a performance drop when enable_model-checking is
+      ON in cmake (even if it's not used in the simulation), but it is
+      necessary at this point to get MC working.
+
+      Turn model-checking OFF if simulation performance matters to you.
+
   -- $date Da SimGrid team <simgrid-devel@lists.gforge.inria.fr>
 
-SimGrid (3.6.2) stable; urgency=low 
+SimGrid (3.6.2) stable; urgency=low
 
  The "Not coding new stuff allows to polish old things" release.
 
  General
  * New bindings to the NS3 packet level simulator (experimental)
- * Use the raw (efficient) execution contextes instead of the sysv
+ * Use the raw (efficient) execution contexts instead of the sysv
    (portable) ones when possible.
  * libpcre is now mandatory in any cases since not using it led to
     severe performance loss and possibly other issues
  * Update the XML platforms:
-   - G5K: include the lastest machine in Nancy 
+   - G5K: include the latest machine in Nancy
    - GridPP and LCG: new platforms
  * Documentation was partially updated, at least (more to come)
-   
+
  Bug fixes, cosmetics and small improvements
  * Free terminated processes before the end of the simulation to avoid
    exhausting the memory of users having very dynamic amount of
@@ -36,11 +113,11 @@ SimGrid (3.6.2) stable; urgency=low
  Portability
  * Create an installer for windows with nsis (amd64 and win32)
    - Add an hello world project to illustrate simgrid project creation.
-   - Embed libpcre into the Simgrid installer to avoid 
-     its compilation burden 
- * The raw execution contextes should work on Apple now
+   - Embed libpcre into the Simgrid installer to avoid
+     its compilation burden
+ * The raw execution contexts should work on Apple now
  * Port to Windows 64 bits
-    - Sysv contextes now have an implementation for this arch
+    - Sysv contexts now have an implementation for this arch
     - GRAS communication features now support this arch
  * Drop support for borland compiler on windows
     - this code was not maintained, and we kinda depend on gcc nowadays
@@ -51,16 +128,16 @@ SimGrid (3.6.2) stable; urgency=low
  -- Wed Oct  5 15:51:01 CEST 2011 Da SimGrid team <simgrid-devel@lists.gforge.inria.fr>
 
 
-SimGrid (3.6.1) stable; urgency=low 
+SimGrid (3.6.1) stable; urgency=low
 
  The "Oops, we broke Macs too" release
 
  Portability
- * Fixed contextes detection so that raw ones are used when possible   
- * On Mac, do not use Posix Ucontextes with gcc v4.[1-5] since this
+ * Fixed contexts detection so that raw ones are used when possible
+ * On Mac, do not use Posix Ucontexts with gcc v4.[1-5] since this
    leads to a strange error, with user code segfaulting sometimes when
    the generated code is not perfectly aligned (which is not
-   controlable from the user side, depends on the amount of code)
+   controllable from the user side, depends on the amount of code)
 
  XBT
  * New macro: CATCH_ANONYMOUS, which is like CATCH(e) but without argument.
@@ -71,14 +148,14 @@ SimGrid (3.6) stable; urgency=medium
 
  The Summer Release, also known as the "OMG! They Killed Kenny!" version
 
- Java and Ruby: 
+ Java and Ruby:
  * Bindings now constitute their own package, separated from the main one.
-   Rationale: reduce our maintainance nightmare by reducing the module coupling
-   They will soon be released on their own on gforge. 
+   Rationale: reduce our maintenance nightmare by reducing the module coupling
+   They will soon be released on their own on gforge.
  * In the meanwhile:
    svn co svn://scm.gforge.inria.fr/svn/simgrid/contrib/trunk/simgrid-java
    svn co svn://scm.gforge.inria.fr/svn/simgrid/contrib/trunk/simgrid-ruby
+
  GRAS: It is not considered as stable anymore, but experimental. Sorry.
  * It's not quite deprecated for now because we have no replacement,
    but it may soon become the case.
@@ -87,7 +164,7 @@ SimGrid (3.6) stable; urgency=medium
  * New MPI functions supported: MPI_Comm_disconnect, MPI_Comm_get_name
  * Fortran: New user-level cache variable to store the rank of the running
    process. This improves performance by an order of magnitude.
- * C: New coccinelle script to automatically locate and modifiy global and
+ * C: New coccinelle script to automatically locate and modify global and
    local static variables.
  * Improved SMPI network model with a sender-side gap to account for multiple
    parallel sends.
@@ -128,13 +205,15 @@ SimGrid (3.6) stable; urgency=medium
    combine Vivaldi based latencies with last-mile platforms.
 
  SIMIX
+ * Added a check for NaN of IEEE754 infinite in the double entries of
+   the smx_user.c file
  * Introduce a new context factory "raw", highly inspirated from the
    ucontext factory, but using manually crafted functions in assembly to
    do the work in an efficient manner.
  * Allow to change the used context factory at run time, not only at
    compilation time. Use --cfg=contexts/factory:raw for maximal speed.
  * Add an option --cfg=contexts/stacksize:N to set the stack size of the user
-   contextes at runtime (only with raw contexts or ucontexts).
+   contexts at runtime (only with raw contexts or ucontexts).
  * Completely rewrote this module to allow parallel execution of user
    processes. Use --cfg=contexts/nthreads:N to execute user processes
    with N parallel threads (the default is 1, meaning no parallelism).
@@ -142,7 +221,7 @@ SimGrid (3.6) stable; urgency=medium
    When nthreads > 1, you can use --cfg=contexts/threshold:P to run the user
    processes in parallel only when their number is greater than or equal to P
    (the default is 2).
- * Added a check for NaN of IEEE754 infinite in the double entries of 
+ * Added a check for NaN of IEEE754 infinite in the double entries of
    the smx_user.c file
 
  XBT
@@ -188,9 +267,9 @@ SimGrid (3.6) stable; urgency=medium
    at the tools directory (fix-paje-trace.sh) can be used to put the events
    in order. We have changed the tracing so it can generate ordered timestamped
    events in the final trace, but depending on the simulator (and how much time
-   is simulated) that can lead to a huge memory utilization. It is desactivated 
+   is simulated) that can lead to a huge memory utilization. It is deactivated
    by default, but it can be activated using the --cfg=tracing/buffer:1 switch.
-   
+
  Build Infrastructure
  * Define a SIMGRID_VERSION macro in simgrid_config.h.
    - We are trying hard to keep the API stable, but it may happen that
@@ -292,7 +371,7 @@ SimGrid (3.5) stable; urgency=medium
    set of realistic platforms exploiting these properties (have a
    look at examples/platforms/ for the moment).
  * Take the opportunity of the XML format change to be a good XML citizen:
-   rename link:ctn to link_ctn and similar changes (also dealed with by
+   rename link:ctn to link_ctn and similar changes (also dealt with by
    simgrid_update_xml)
  * Add a new routing scheme (rule-based) using regular expressions. It
    enables to have an extremely low memory footprint when the
@@ -1136,7 +1215,7 @@ SimGrid (3.2) stable; urgency=high
     and (2) msg_size. This was changed to (1) msg_size and (2) amount of
     messages. This was need for the fool willing to send more than MAXINT
     bytes on quite fat pipes.
-       
+
   AMOK:
   * Do really rename the hostmanagement module to peermanagement. [Mt]
     Ie, rename functions from amok_hm_* to amok_pm_*. This breaks the API,
@@ -1190,10 +1269,10 @@ SimGrid (3.2) stable; urgency=high
          . Lesson 6: Logging informations properly
          . Lesson 7: Using internal timers
          . Lesson 8: Handling errors through exceptions
-         . Lesson 9: Exchanging simple data
-        . Lesson 10: Remote Procedure Calling (RPC)
-        . Lesson 11: Explicitely waiting for messages
-        . Recapping of message passing features in GRAS
+         . Lesson 9: Exchanging simple data
+         . Lesson 10: Remote Procedure Calling (RPC)
+         . Lesson 11: Explicitely waiting for messages
+         . Recapping of message passing features in GRAS
      - A HOWTO section containing:
        o HOWTO design a GRAS application
        More are due, of course. They will come latter. In the meanwhile, you can
@@ -1214,7 +1293,7 @@ SimGrid (3.1) stable; urgency=high
     directly on top of SURF and provides an API rather close to the old
     SG. Some old codes using SG are currently under rewrite to check that
     all needful functions are provided. [Christophe Thiery]
-       
+
   SURF:
   * Complete rewrite of the KCCFLN05 workstation model. It is now an
     extension of the classical CLM03 model that gracefully handles
@@ -1328,7 +1407,7 @@ SimGrid (3.0.1) stable; urgency=low
   SURF:
   * Add additionnal checkings on communications. Assert that two
     communicating hosts are connected by a set of links... [AL]
-       
+
   MSG:
   * Add additionnal checkings on channel values in communication [AL]
   * New: MSG_task_get_source to see on which host a task was generated [HC]
@@ -1337,7 +1416,7 @@ SimGrid (3.0.1) stable; urgency=low
     by host. [AL]
   * New: MSG_error_t MSG_task_get_from_host(m_task_t * task, int channel, m_host_t host);
     waits for the first task coming from a given host.. [AL]
-       
+
   GRAS new functionnalities: [MQ]
   * Enhance the parsing macro to allow the size of multidimentional objects
     to be given thru annotations.
@@ -1400,7 +1479,7 @@ SimGrid (3.00) stable; urgency=high
   * New! Give the possibility to hijack the surf parser and thus bypass
     MSG_create_environment and MSG_launch_application. Have a look at
     examples/msg/msg_test_surfxml_bypassed.c to see how it can be done.
-       
+
  -- Arnaud Legrand <simgrid-devel@lists.gforge.inria.fr>  Sat, 20 Aug 2005 23:25:25 -0700
 
 SimGrid (2.96) unstable; urgency=low
@@ -1738,7 +1817,7 @@ SimGrid (2.90) unstable; urgency=low
   - Main loop and datastructures of SURF. A cpu resource object is
     functional. Surf can thus be used to create cpu's with variable
     performance on which you can execute some actions.
-       
+
 2004-11-15 Martin Quinson
   - Port to ARM. Simply added the alignment and size descriptions. Should
     work, but the ARM machines are so slow that I didn't had the opportunity