X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/85ef40ae60f69070f3ad07b6927d403902e857c8..f186888449310ed2ffeae9f6cf170cf40f1d17d1:/doc/manpage/smpirun.1 diff --git a/doc/manpage/smpirun.1 b/doc/manpage/smpirun.1 index 5d2cc20c52..08ab896a13 100644 --- a/doc/manpage/smpirun.1 +++ b/doc/manpage/smpirun.1 @@ -1,20 +1,24 @@ .TH smpirun 1 .SH NAME -smpirun \- Allow the configuration and the execution of MPI programs with simgrid and SMPI +smpirun \- Exectute MPI programs in the SimGrid simulator .SH SYNOPSIS -smpirun [\fIOPTIONS\fR]… \fB\-platform\fR \fB\-hostfile\fR program [\fIPROGRAM-OPTIONS\fR]… +smpirun [\fISMPI OPTIONS\fR]… \fB\-platform\fR \fB\-hostfile\fR program [\fISIMULATION OPTIONS\fR] [\fIPROGRAM OPTIONS\fR] .SH DESCRIPTION -smpirun provides an easy way to run programs linked to simgrid and using SMPI. It sets some default values, and generate a deployment file using the mandatory arguments \fB-platform\fR and \fB-hostfile\fR. +smpirun car run MPI programs that were compiled with smpicc on top of +the simulator. Basically, it generates a deployment files from the +provided hostfile (if needed), and launches the simulation with the right +arguments. It is intended to be easy to use to regular MPI users. +.SH MANDATORY PARAMETERS .TP \fB\-platform\fR XML file describing the platform on which we want to deploy the program .TP \fB\-hostfile\fR, \fB\-machinefile\fR Hostfile listing all the machines in use -.SH OPTIONS -.SS Configuration options -The configuration of the simulation can be tweaked using \fB--cfg\fR=\fIparameter\fR:\fIvalue\fR. Refer to http://simgrid.gforge.inria.fr/simgrid/latest/doc/options.html to know what are the different possibilities. -.SS Other options +.SH SMPI OPTIONS +The smpirun itself accepts some optionnal parameters, that are not to +be mixed with the configuration options described in the next section. + .TP \fB\-help\fR Print the usage and a résumé of the available options @@ -43,7 +47,7 @@ should probably link statically instead of disabling this. Do not link statically against SimGrid, only the others. .TP \fB\-trace\fR -Equivalent to \fB–cfg\fR=\fItracing\fR:\fIyes\fR \fB–cfg\fR=\fItracing/smpi\fR:\fIyes\fR, activate the trace mechanism if available. +Activate the trace mechanism if available (equivalent to \fB--cfg\fR=\fItracing\fR:\fIyes\fR \fB--cfg\fR=\fItracing/smpi\fR:\fIyes\fR) .TP \fB\-trace-ti\fR Activate time independant tracing. @@ -65,12 +69,20 @@ Generate configuration for Viva's GraphView. .TP \fB\-trace-file\fR Name of the tracefile + +.SH SIMULATION OPTIONS +You can change many simulation parameter on the command line by passing +\fB--cfg\fR=\fIparameter\fR:\fIvalue\fR after the program name. +A full list of existing parameters and their meaning can be found at +http://simgrid.gforge.inria.fr/simgrid/latest/doc/options.html + .SH AUTHORS The SimGrid team (simgrid-devel@lists.gforge.inria.fr) .SH COPYRIGHT AND LICENCE -Copyright (c) 2014. The SimGrid Team. All rights reserved. +Copyright (c) 2014-2016. The SimGrid Team. All rights reserved. -This program is free software; you may redistribute it and/or modify it under the terms of GNU LGPL (v2.1) license. +This program is free software; you may redistribute it and/or modify +it under the terms of GNU LGPL (v2.1) license. .SH SEE ALSO .B smpicc\fR(1) .B smpicxx\fR(1)