Browse Source

mention new sched_tasks.rec file in changelog and documentation (followup to 15244a7dedeb1d045b3933b49b0229cd577d73f0)

Nathalie Furmento 5 years ago
parent
commit
b30cf2e282
2 changed files with 11 additions and 2 deletions
  1. 2 1
      ChangeLog
  2. 9 1
      doc/doxygen/chapters/380_offline_performance_tools.doxy

+ 2 - 1
ChangeLog

@@ -16,7 +16,7 @@
 # See the GNU Lesser General Public License in COPYING.LGPL for more details.
 # See the GNU Lesser General Public License in COPYING.LGPL for more details.
 #
 #
 
 
-StarPU 1.4.0 (svn revision xxxx)
+StarPU 1.4.0 (git revision xxxx)
 ==============================================
 ==============================================
 New features:
 New features:
   * Fault tolerance support with starpu_task_ft_failed().
   * Fault tolerance support with starpu_task_ft_failed().
@@ -25,6 +25,7 @@ New features:
   * New offline tool to draw graph showing elapsed time between sent
   * New offline tool to draw graph showing elapsed time between sent
     or received data and their use by tasks
     or received data and their use by tasks
   * Add 4D tensor data interface.
   * Add 4D tensor data interface.
+  * New sched_tasks.rec trace file which monitors task scheduling push/pop actions
 
 
 Small changes:
 Small changes:
   * Use the S4U interface of Simgrid instead of xbt and MSG.
   * Use the S4U interface of Simgrid instead of xbt and MSG.

+ 9 - 1
doc/doxygen/chapters/380_offline_performance_tools.doxy

@@ -209,7 +209,7 @@ $ dot -Tpdf dag.dot -o output.pdf
 
 
 Another generated trace file gives details on the executed tasks. The
 Another generated trace file gives details on the executed tasks. The
 file, created in the current directory, is named <c>tasks.rec</c>. This file
 file, created in the current directory, is named <c>tasks.rec</c>. This file
-is in the recutils format, i.e. <c>Field: value</c> lines, and empty lines to
+is in the recutils format, i.e. <c>Field: value</c> lines, and empty lines are used to
 separate each task.  This can be used as a convenient input for various ad-hoc
 separate each task.  This can be used as a convenient input for various ad-hoc
 analysis tools. By default it only contains information about the actual
 analysis tools. By default it only contains information about the actual
 execution. Performance models can be obtained by running
 execution. Performance models can be obtained by running
@@ -231,6 +231,14 @@ Another possibility is to obtain the performance models as an auxiliary <c>perfm
 $ starpu_perfmodel_recdump tasks.rec -o perfmodel.rec
 $ starpu_perfmodel_recdump tasks.rec -o perfmodel.rec
 \endverbatim
 \endverbatim
 
 
+\subsubsection TraceSchedTaskDetails Getting Scheduling Task Details
+
+The file, <c>sched_tasks.rec</c>, created in the current directory,
+and in the recutils format, gives information about the tasks
+scheduling, and lists the push and pop actions of the scheduler. For
+each action, it gives the timestamp, the job priority and the job id.
+Each action is separated from the next one by empty lines.
+
 \subsubsection MonitoringActivity Monitoring Activity
 \subsubsection MonitoringActivity Monitoring Activity
 
 
 Another generated trace file is an activity trace. The file, created
 Another generated trace file is an activity trace. The file, created