diff --git a/doc/man/man1/salloc.1 b/doc/man/man1/salloc.1 index 5d83e300a6602415a668a9de806e8a0cc2176973..4fd4cea3266b565334c00dccbf076a3737070057 100644 --- a/doc/man/man1/salloc.1 +++ b/doc/man/man1/salloc.1 @@ -275,6 +275,38 @@ the \-\-cpus\-per\-task=3 options, the controller knows that each task requires 3 processors on the same node, and the controller will grant an allocation of 4 nodes, one for each of the 4 tasks. +.TP +\fB\-d\fR, \fB\-\-dependency\fR=<\fIdependency_list\fR> +Defer the start of this job until the specified dependencies have been +satisfied completed. +<\fIdependency_list\fR> is of the form +<\fItype:job_id[:job_id][,type:job_id[:job_id]]\fR>. +Many jobs can share the same dependency and these jobs may even belong to +different users. The value may be changed after job submission using the +scontrol command. +.PD +.RS +.TP +\fBafter:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have begun +execution. +.TP +\fBafterany:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have terminated. +.TP +\fBafternotok:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have terminated +in some failed state (non-zero exit code, node failure, timed out, etc). +.TP +\fBafterok:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have successfully +executed (ran to completion with non-zero exit code). +.TP +\fBsingleton\fR +This job can begin execution after any previously launched jobs +sharing the same job name and user have terminated. +.RE + .TP \fB\-D\fR, \fB\-\-chdir\fR=<\fIpath\fR> change directory to \fIpath\fR before beginning execution. @@ -674,38 +706,6 @@ per processor. By specifying \fB\-\-overcommit\fR you are explicitly allowing more than one task per processor. However no more than \fBMAX_TASKS_PER_NODE\fR tasks are permitted to execute per node. -.TP -\fB\-P\fR, \fB\-\-dependency\fR=<\fIdependency_list\fR> -Defer the start of this job until the specified dependencies have been -satisfied completed. -<\fIdependency_list\fR> is of the form -<\fItype:job_id[:job_id][,type:job_id[:job_id]]\fR>. -Many jobs can share the same dependency and these jobs may even belong to -different users. The value may be changed after job submission using the -scontrol command. -.PD -.RS -.TP -\fBafter:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have begun -execution. -.TP -\fBafterany:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have terminated. -.TP -\fBafternotok:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have terminated -in some failed state (non-zero exit code, node failure, timed out, etc). -.TP -\fBafterok:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have successfully -executed (ran to completion with non-zero exit code). -.TP -\fBsingleton\fR -This job can begin execution after any previously launched jobs sharing the same -job name and user have terminated. -.RE - .TP \fB\-p\fR, \fB\-\-partition\fR=<\fIpartition name\fR> Request a specific partition for the resource allocation. If not specified, diff --git a/doc/man/man1/sbatch.1 b/doc/man/man1/sbatch.1 index d89e6358eecc4cb5413aa3b37169045aa60f8d4b..5bc3d216912bd6a4e962c078657bc4c2155b374f 100644 --- a/doc/man/man1/sbatch.1 +++ b/doc/man/man1/sbatch.1 @@ -283,6 +283,38 @@ the \-\-cpus\-per\-task=3 options, the controller knows that each task requires 3 processors on the same node, and the controller will grant an allocation of 4 nodes, one for each of the 4 tasks. +.TP +\fB\-d\fR, \fB\-\-dependency\fR=<\fIdependency_list\fR> +Defer the start of this job until the specified dependencies have been +satisfied completed. +<\fIdependency_list\fR> is of the form +<\fItype:job_id[:job_id][,type:job_id[:job_id]]\fR>. +Many jobs can share the same dependency and these jobs may even belong to +different users. The value may be changed after job submission using the +scontrol command. +.PD +.RS +.TP +\fBafter:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have begun +execution. +.TP +\fBafterany:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have terminated. +.TP +\fBafternotok:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have terminated +in some failed state (non-zero exit code, node failure, timed out, etc). +.TP +\fBafterok:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have successfully +executed (ran to completion with non-zero exit code). +.TP +\fBsingleton\fR +This job can begin execution after any previously launched jobs +sharing the same job name and user have terminated. +.RE + .TP \fB\-D\fR, \fB\-\-workdir\fR=<\fIdirectory\fR> Set the working directory of the batch script to \fIdirectory\fR before @@ -717,38 +749,6 @@ Open the output and error files using append or truncate mode as specified. The default value is specified by the system configuration parameter \fIJobFileAppend\fR. -.TP -\fB\-P\fR, \fB\-\-dependency\fR=<\fIdependency_list\fR> -Defer the start of this job until the specified dependencies have been -satisfied completed. -<\fIdependency_list\fR> is of the form -<\fItype:job_id[:job_id][,type:job_id[:job_id]]\fR>. -Many jobs can share the same dependency and these jobs may even belong to -different users. The value may be changed after job submission using the -scontrol command. -.PD -.RS -.TP -\fBafter:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have begun -execution. -.TP -\fBafterany:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have terminated. -.TP -\fBafternotok:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have terminated -in some failed state (non-zero exit code, node failure, timed out, etc). -.TP -\fBafterok:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have successfully -executed (ran to completion with non-zero exit code). -.TP -\fBsingleton\fR -This job can begin execution after any previously launched jobs sharing the same -job name and user have terminated. -.RE - .TP \fB\-p\fR, \fB\-\-partition\fR=<\fIpartition name\fR> Request a specific partition for the resource allocation. If not specified, diff --git a/doc/man/man1/srun.1 b/doc/man/man1/srun.1 index 6488c9c2c37af7168df0760de1b05139e5f34ee8..7b14b94655e96041f7a8713d25085b192ad63b95 100644 --- a/doc/man/man1/srun.1 +++ b/doc/man/man1/srun.1 @@ -299,19 +299,44 @@ This option may also be useful to spawn tasks without allocating resources to the job step from the job's allocation when running multiple job steps with the \fB\-\-exclusive\fR option. +.TP +\fB\-d\fR, \fB\-\-dependency\fR=<\fIdependency_list\fR> +Defer the start of this job until the specified dependencies have been +satisfied completed. +<\fIdependency_list\fR> is of the form +<\fItype:job_id[:job_id][,type:job_id[:job_id]]\fR>. +Many jobs can share the same dependency and these jobs may even belong to +different users. The value may be changed after job submission using the +scontrol command. +.PD +.RS +.TP +\fBafter:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have begun +execution. +.TP +\fBafterany:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have terminated. +.TP +\fBafternotok:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have terminated +in some failed state (non-zero exit code, node failure, timed out, etc). +.TP +\fBafterok:job_id[:jobid...]\fR +This job can begin execution after the specified jobs have successfully +executed (ran to completion with non-zero exit code). +.TP +\fBsingleton\fR +This job can begin execution after any previously launched jobs +sharing the same job name and user have terminated. +.RE + .TP \fB\-D\fR, \fB\-\-chdir\fR=<\fIpath\fR> have the remote processes do a chdir to \fIpath\fR before beginning execution. The default is to chdir to the current working directory of the \fBsrun\fR process. -.TP -\fB\-d\fR, \fB\-\-slurmd\-debug\fR=<\fIlevel\fR> -Specify a debug level for slurmd(8). \fIlevel\fR may be an integer value -between 0 [quiet, only errors are displayed] and 4 [verbose operation]. -The slurmd debug information is copied onto the stderr of -the job. By default only errors are displayed. - .TP \fB\-e\fR, \fB\-\-error\fR=<\fImode\fR> Specify how stderr is to be redirected. By default in interactive mode, @@ -782,38 +807,6 @@ Open the output and error files using append or truncate mode as specified. The default value is specified by the system configuration parameter \fIJobFileAppend\fR. -.TP -\fB\-P\fR, \fB\-\-dependency\fR=<\fIdependency_list\fR> -Defer the start of this job until the specified dependencies have been -satisfied completed. -<\fIdependency_list\fR> is of the form -<\fItype:job_id[:job_id][,type:job_id[:job_id]]\fR>. -Many jobs can share the same dependency and these jobs may even belong to -different users. The value may be changed after job submission using the -scontrol command. -.PD -.RS -.TP -\fBafter:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have begun -execution. -.TP -\fBafterany:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have terminated. -.TP -\fBafternotok:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have terminated -in some failed state (non-zero exit code, node failure, timed out, etc). -.TP -\fBafterok:job_id[:jobid...]\fR -This job can begin execution after the specified jobs have successfully -executed (ran to completion with non-zero exit code). -.TP -\fBsingleton\fR -This job can begin execution after any previously launched jobs sharing the same -job name and user have terminated. -.RE - .TP \fB\-p\fR, \fB\-\-partition\fR=<\fIpartition name\fR> Request a specific partition for the resource allocation. If not specified, @@ -944,6 +937,13 @@ By default, no signal is sent before the job's end time. If a \fIsig_num\fR is specified without any \fIsig_time\fR, the default time will be 60 seconds. +.TP +\fB\-\-slurmd\-debug\fR=<\fIlevel\fR> +Specify a debug level for slurmd(8). \fIlevel\fR may be an integer +value between 0 [quiet, only errors are displayed] and 4 [verbose +operation]. The slurmd debug information is copied onto the stderr of +the job. By default only errors are displayed. + .TP \fB\-T\fR, \fB\-\-threads\fR=<\fInthreads\fR> Request that \fBsrun\fR