-function usage () {
- echo "usage:"
- echo "$0 [-keep-temps]"
- echo " [-np <numprocs>] -platform <xmldesc> -hostfile <hostfile> [-map] program [program-options]"
- echo " [-keep-temps] # don't remove the generated files after execution"
- echo " [-map] # display the machine on which each process rank is mapped"
- echo " [-np <numprocs>] # use that amount of processes from the hostfile."
- echo " # By default, all processes of the hostfile are used."
- echo " [-trace] # activate tracing"
- echo " [-trace-comment <comment>]# put a comment on the top of the trace file"
- echo " [-trace-comment-file <file>] # put file contents on the top of the trace file as comment"
- echo " [-trace-grouped] # group MPI processes by location"
- echo " [-trace-resource] # trace resource utilization"
- echo " [-trace-triva] # generate configuration for Triva's GraphView"
- echo " [-trace-file <tracefile>] # name of the tracefile (simgrid_smpi.trace)"
- echo "or (deprecated usage):"
- echo "$0 [-keep-temps] [-np <numprocs>] [-bandwidth <bytes/sec>] [-latency <secs>] program [program-options]"
- echo
+usage () {
+ cat <<EOF
+Usage: $0 [OPTIONS] -platform <xmldesc> -hostfile <hostfile> program [program-options]
+ $0 [OPTIONS] -platform <xmldesc> -hostfile <hostfile> -replay <tracefile> [program] [program-options]
+Options:
+ -keep-temps # don't remove the generated files after execution
+ -wrapper <command> # use command to run the program (e.g. "valgrind" or "gdb --args")
+ -map # display the machine on which each process rank is mapped
+ -np <numprocs> # use that amount of processes from the hostfile.
+ # By default, all processes of the hostfile are used.
+ -no-privatize # Disable the globals privatization, that is activated by default
+ -trace-ti # activate time independant tracing (for replay, default in smpi_simgrid.txt)
+ -trace # activate tracing (Paje, default in smpi_simgrid.trace)
+ -trace-comment <comment> # put a comment on the top of the trace file
+ -trace-comment-file <file> # put file contents on the top of the trace file as comment
+ -trace-grouped # group MPI processes by location
+ -trace-resource # trace resource utilization
+ -trace-file <tracefile> # name of the tracefile (simgrid_smpi.trace)
+ -replay <tracefile> # replays a trace instead of actually executing an application
+
+ -version # Displays the SimGrid version (human readable)
+ -git-version # Displays the git hash of SimGrid
+
+or (deprecated usage):
+ $0 [-keep-temps] [-np <numprocs>] [-bandwidth <bytes/sec>] [-latency <secs>] program [program-options]
+
+EOF