Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
prepare the ChangeLog and NEWS files for the upcoming release
[simgrid.git] / ChangeLog
index 63e07ed..42f7d7a 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
-SimGrid (3.7) NOT RELEASED; urgency=low
+SimGrid (3.8) NOT RELEASED; urgency=low
+
+ The "SimGrid makes psssshiiiit and jumps into the cloud" release.
+ CMAKE:
+ * Remove option custom_flags. Now use environment variables CFLAGS 
+   and LDFLAGS.
+  
+ MSG:
+ * Add an experimental interface to manipulate VMs. They are mainly
+   process groups with very few intrinsic semantic, but they should
+   allow you to build the semantic you want easily.
+
+ Simix:
+ * Bug fixes around the resource failures: don't let the processes
+   survive the host they are running onto
+
+ SimDag:
+ * New type of typed tasks SD_TASK_COMP_PAR_AMDAHL that represents a
+   parallel task whose initial work is distributed among host according
+   to the Amdahl's law. Such tasks are created with a parameter alpha
+   that corresponds to the non-parallelizable part of the computation.
+
+   Before calling SD_task_schedulel or SD_task_schedulev, the
+   SD_task_distribute_comp_amdahl function has to be called with the
+   desired number of workstations. The filling of computation_amount and
+   communication_amount (actually empty) structures is then done
+   seamlessly.
+ * New function SD_workstation_dump to display various information
+
+ -- $date Da SimGrid team <simgrid-devel@lists.gforge.inria.fr>
 
-  The "Simplicity does not preceed complexity, but follows it" release.
+SimGrid (3.7.1) stable; urgency=low
+
+ MSG:
+ * Restore the prototype of MSG_process_create_with_environment() to
+   the pre-3.7 situation by removing the kill_time argument.
+ * Add a MSG_process_set_kill_time() function instead.
+
+ SURF:
+ * Fix weird behaviors when dealing with parallel tasks.
+
+ Build System:
+ * Fix compilation when using MSG_USE_DEPRECATED.
+ * Fix some compilation issues on Macs and Windows.
+ * Environment variables CFLAGS and LDFLAGS are now honored by cmake.
+ We discovered that the Lua console is broken, but we are missing the
+ manpower to fix it right now. The problem existed in 3.7 too, so we
+ are not blocking the release for that. Sorry if you depended on this
+ feature, any help would be really welcome.
+ -- Thu Jun 7 2012 Da SimGrid team <simgrid-devel@lists.gforge.inria.fr>
+
+SimGrid (3.7) stable; urgency=low
+
+  The "spring cleanups (before the next Big Project kicks in)" 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.
   * 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 was 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.
+  * Ongoing refactoring the model parsing to make XML files optional
+    See include/simgrid/platf.h for details (still to be completed)
+
+  MSG:
+  * Major overhaul of the documentation. Almost instructive now :/
+  * Deprecate the use of m_channel_t mechanism like MSG_task_{get,put}
+    functions and friends. This interface was 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 compile SimGrid command line
+    'cmake -Dcustom_flags="-DMSG_USE_DEPRECATED" .' if you really need to
+     use these (crappy) functions in your code.
+    These functions will be removed soon. Stop using them now.
+  * Deprecate MSG_get_host_{table,number}
+    Implement MSG_hosts_as_dynar() instead.
+  * Implement MSG_processes_as_dynar() (Closes gforge #13642)
+  * Remove the public field msg_host_t->name. Use MSG_host_get_name()
+
+  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
+      that must be part of a scheduling round to switch to parallel
+      execution mode (raw contexts only)
+  * Fix bugs that prevented to use suspend/resume along with
+    synchronization structures.
+  * Fix bugs in process termination that lead to invalid memory access
+    in very specific conditions.
+
+  SURF:
+  * Introduce a parallel mode for the models (controlled by 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.
+
+  TRACE:
+  * Documentation of the tracing functions.
+  * Performance gains when tracing categorized/uncategorized resource
+    utilization by avoiding calls to get route when updating resource
+    variables. LMM constraints are being used instead.
+  * API changed to set task categories. Use MSG_task_set_category instead
+    of TRACE_msg_set_task_category, and SD_task_set_category instead
+    of TRACE_sd_set_task_category. They only work if ENABLE_TRACING is ON.
+  * Bugfix for graphicator, routes not correctly obtained, memory leaks
+  * Examples for link user variables added (see at examples/msg/tracing/)
+  * Deprecated function TRACE_msg_set_process_category completely removed
+  * Trace header updated according to the latest Paje file format
+  * Tracing network lazy updates, no longer obligate users to use full updates
+  * --cfg=tracing/platform:1 also registers power/bandwidth variables
+  * Experimental: let user code declare/set/push/pop application states for hosts
+  * API changed to allow the manual creation of graph configuration files
+    for Triva. See TRACE_get_node_types() and TRACE_get_edge_types().
+
+  Lua:
+  * Improve the API of Lua MSG bindings, using the Lua spirit.
+  * Each simulated process now lives in its own Lua world (globals are
+    automatically duplicated). It helps writing simulators. Will allow
+    to run Splay programs within SimGrid in the future.
+  * Add a Chord example in Lua, equivalent to the MSG one.
+
+  MODEL-CHECKING:
+  * Start the implementation of a solution to express temporal
+    properties, not only local assertions. This is still an
+    experimental work in progress, stay clear from it to be safe.
+
   XBT:
+  * Logs:
+    - Add new runtime parameters --help-logs and --help-log-categories
+      to display informations about supported logging parameters and
+      categories.
+    - Old deprecated parameters --{gras,surf,msg.simix,xbt}-log=...
+      don't exists anymore.
   * 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.
-
-  -- $date Da SimGrid team <simgrid-devel@lists.gforge.inria.fr>
+  * 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.
+    - Dicts of scalar elements (xbt_dicti_*) are deprecated.
+    - Multi-level dictionaries are deprecated.
+  * Dynars:
+    - new function xbt_dynar_search_or_negative() that is useful when
+      you have less than 2 million elements in your dynar and don't
+      want of the extra complexity of catching exceptions when the
+      element is not found.
+  * Portability layer
+    - Make xbt_os_thread module (for thread portability) public.
+      Documentation is still to come, sorry.
+  * 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.
+      Not enabling it at runtime is not enough, disable it in cmake.
+
+  -- Tue May 15 11:30:19 UTC 2012 Da SimGrid team <simgrid-devel@lists.gforge.inria.fr>
 
 SimGrid (3.6.2) stable; urgency=low
 
@@ -25,12 +203,12 @@ SimGrid (3.6.2) stable; urgency=low
 
  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)
 
@@ -46,9 +224,9 @@ SimGrid (3.6.2) stable; urgency=low
    - 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
+ * 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
@@ -58,17 +236,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
 
  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.
@@ -81,7 +258,7 @@ SimGrid (3.6) stable; urgency=medium
 
  Java and Ruby:
  * Bindings now constitute their own package, separated from the main one.
-   Rationale: reduce our maintainance nightmare by reducing the module coupling
+   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
@@ -95,7 +272,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.
@@ -144,7 +321,7 @@ SimGrid (3.6) stable; urgency=medium
  * 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).
@@ -198,7 +375,7 @@ 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
@@ -302,7 +479,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
@@ -1046,7 +1223,7 @@ SimGrid (3.3) stable; urgency=high
     [contributed by Sékou Diakite, many thanks]
 
  GRAS:
-  * Introduce a listener thread in charge of receiving incomming
+  * Introduce a listener thread in charge of receiving incoming
     messages from the network. It allows to overlap communication and
     computation but most notably, it removes some stupid deadlocks due
     to the fact that so far, a process could not send and receive at
@@ -1200,10 +1377,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