diff --git a/doc/man/man1/salloc.1 b/doc/man/man1/salloc.1 index 62098fd855f09514fc2a0977c1d9551303d53b8e..d708bef31f008bdd138bf6070678dbff4eacbed3 100644 --- a/doc/man/man1/salloc.1 +++ b/doc/man/man1/salloc.1 @@ -336,10 +336,11 @@ change directory to \fIpath\fR before beginning execution. .TP \fB\-\-exclusive\fR -The job allocation cannot share nodes with other running jobs. This is -the oposite of \-\-share, whichever option is seen last on the command line -will win. (The default shared/exclusive behaviour depends on system -configuration.) +The job allocation can not share nodes with other running jobs. +This is the opposite of \-\-share, whichever option is seen last +on the command line will be used. The default shared/exclusive +behavior depends on system configuration and the partition's \fBShared\fR +option takes precedence over the job's option. .TP \fB\-F\fR, \fB\-\-nodefile\fR=<\fInode file\fR> @@ -795,7 +796,7 @@ allowing more than one task per processor. However no more than .TP \fB\-p\fR, \fB\-\-partition\fR=<\fIpartition_names\fR> Request a specific partition for the resource allocation. If not specified, -the default behaviour is to allow the slurm controller to select the default +the default behavior is to allow the slurm controller to select the default partition as designated by the system administrator. If the job can use more than one partition, specify their names in a comma separate list and the one offering earliest initiation will be used. @@ -818,9 +819,12 @@ Allocate resources for the job from the named reservation. .TP \fB\-s\fR, \fB\-\-share\fR -The job allocation can share nodes with other running jobs. (The default -shared/exclusive behaviour depends on system configuration.) -This may result the allocation being granted sooner than if the \-\-share +The job allocation can share nodes with other running jobs. +This is the opposite of \-\-exclusive, whichever option is seen last +on the command line will be used. The default shared/exclusive +behavior depends on system configuration and the partition's \fBShared\fR +option takes precedence over the job's option. +This option may result the allocation being granted sooner than if the \-\-share option was not set and allow higher system utilization, but application performance will likely suffer due to competition for resources within a node. diff --git a/doc/man/man1/sbatch.1 b/doc/man/man1/sbatch.1 index bf4c7272a05c1fc16557a3e644ff44129c95f95d..1fd59a0eaa69242ada35ca891d2f4cb625aac116 100644 --- a/doc/man/man1/sbatch.1 +++ b/doc/man/man1/sbatch.1 @@ -355,10 +355,11 @@ See the \fB\-\-input\fR option for filename specification options. .TP \fB\-\-exclusive\fR -The job allocation cannot share nodes with other running jobs. This is -the oposite of \-\-share, whichever option is seen last on the command line -will win. (The default shared/exclusive behaviour depends on system -configuration.) +The job allocation can not share nodes with other running jobs. +This is the opposite of \-\-share, whichever option is seen last +on the command line will be used. The default shared/exclusive +behavior depends on system configuration and the partition's \fBShared\fR +option takes precedence over the job's option. .TP \fB\-\-export\fR=<\fIenvironment variables | ALL | NONE\fR> @@ -854,7 +855,7 @@ The default value is specified by the system configuration parameter .TP \fB\-p\fR, \fB\-\-partition\fR=<\fIpartition_names\fR> Request a specific partition for the resource allocation. If not specified, -the default behaviour is to allow the slurm controller to select the default +the default behavior is to allow the slurm controller to select the default partition as designated by the system administrator. If the job can use more than one partition, specify their names in a comma separate list and the one offering earliest initiation will be used. @@ -929,9 +930,12 @@ Allocate resources for the job from the named reservation. .TP \fB\-s\fR, \fB\-\-share\fR -The job allocation can share nodes with other running jobs. (The default -shared/exclusive behaviour depends on system configuration.) -This may result in the allocation being granted sooner than if the \-\-share +The job allocation can share nodes with other running jobs. +This is the opposite of \-\-exclusive, whichever option is seen last +on the command line will be used. The default shared/exclusive +behavior depends on system configuration and the partition's \fBShared\fR +option takes precedence over the job's option. +This option may result the allocation being granted sooner than if the \-\-share option was not set and allow higher system utilization, but application performance will likely suffer due to competition for resources within a node. diff --git a/doc/man/man1/srun.1 b/doc/man/man1/srun.1 index c265a0728428c45acd4a31bacf5185a64463241d..072e1b21bf9bebe151b24fab68e39221931e4e3e 100644 --- a/doc/man/man1/srun.1 +++ b/doc/man/man1/srun.1 @@ -386,9 +386,10 @@ parameter in slurm.conf. .TP \fB\-\-exclusive\fR When used to initiate a job, the job allocation cannot share nodes with -other running jobs. This is the oposite of \-\-share, whichever option -is seen last on the command line will win. (The default shared/exclusive -behavior depends on system configuration.) +other running jobs. This is the opposite of \-\-share, whichever option +is seen last on the command line will win. The default shared/exclusive +behavior depends on system configuration and the partition's \fBShared\fR +option takes precedence over the job's option. This option can also be used when initiating more than one job step within an existing resource allocation, where you want separate processors to @@ -894,7 +895,7 @@ The default value is specified by the system configuration parameter .TP \fB\-p\fR, \fB\-\-partition\fR=<\fIpartition_names\fR> Request a specific partition for the resource allocation. If not specified, -the default behaviour is to allow the slurm controller to select the default +the default behavior is to allow the slurm controller to select the default partition as designated by the system administrator. If the job can use more than one partition, specify their names in a comma separate list and the one offering earliest initiation will be used. @@ -1010,8 +1011,14 @@ be read (used by the checkpoint/blcrm and checkpoint/xlch plugins only). .TP \fB\-s\fR, \fB\-\-share\fR -The job can share nodes with other running jobs. This may result in faster job -initiation and higher system utilization, but lower application performance. +The job allocation can share nodes with other running jobs. +This is the opposite of \-\-exclusive, whichever option is seen last +on the command line will be used. The default shared/exclusive +behavior depends on system configuration and the partition's \fBShared\fR +option takes precedence over the job's option. +This option may result the allocation being granted sooner than if the \-\-share +option was not set and allow higher system utilization, but application +performance will likely suffer due to competition for resources within a node. .TP \fB\-\-signal\fR=<\fIsig_num\fR>[@<\fIsig_time\fR>]