diff --git a/doc/man/man1/srun.1 b/doc/man/man1/srun.1 index ec51fe06d7ec2f8de6094ba8097b089469a8ca8d..b783e8e5a24aa339d7e8de4412028f90ba885492 100644 --- a/doc/man/man1/srun.1 +++ b/doc/man/man1/srun.1 @@ -83,6 +83,14 @@ to 10000 (lowest priority). Only privileged users can specify a negative adjustment. NOTE: This option is presently ignored if \fISchedulerType=sched/maui\fR. +.TP +\fB\-\-multi\-prog\fR +Run a job with different programs and different arguments for +each task. In this case, the executable program specified is +actually a configuration file specifying the executable and +arguments for each task. See \fBMULTIPLE PROGRAM CONFIGURATION\fR +below for details on the configuration file contents. + .TP \fB\-\-begin\fR=\fItime\fR Defer initiation of this job until the specified time. @@ -1017,6 +1025,53 @@ list of computers on which to execute. This list can be constructed executing the command \fBsrun /bin/hostname\fR and writing its standard output to the desired file. Execute \fBmpirun \-\-help\fR for more options. +.SH "MULTIPLE PROGRAM CONFIGURATION" +Comments in the configuration file must have a "#" in collumn one. +The configuration file contains the following fields separated by white +space: +.TP +Task rank +One or more task ranks to use this configuration. +Multiple values may be comma separated. +Ranges may be indicated with two numbers separated with a '\-'. +.TP +Executable +The name of the program to execute. +May be fully qualified pathname if desired. +.TP +Arguments +Program arguments. +The expression "%t" will be replaced with the task's number. +The expression "%o" will be replaced with the task's offset within +this range (e.g. a configured task rank value of "1-5" would +have offset values of "0-4"). +Single quotes may be used to avoid having the enclosed values interpretted. +This field is optional. +.PP +For example: +.nf +################################################################### +# srun multiple program configuration file +# +# srun -n8 -l --multi-prog silly.conf +################################################################### +4-6 hostname +1,7 echo task:%t +0,2-3 echo offset:%o + +$ srun -n8 -l --multi-prog silly.conf +0: offset:0 +1: task:1 +2: offset:1 +3: offset:2 +4: linux15.llnl.gov +5: linux16.llnl.gov +6: linux17.llnl.gov +7: task:7 + +.fi + + .SH "EXAMPLES" This simple example demonstrates the execution of the command \fBhostname\fR in eight tasks. At least eight processors will be allocated to the job