From 9faadae0265b5baa19d97d197547f2888b64f697 Mon Sep 17 00:00:00 2001 From: Morris Jette <jette@schedmd.com> Date: Wed, 25 Mar 2015 11:01:32 -0700 Subject: [PATCH] Clarify job submit nodelist option --- doc/man/man1/salloc.1 | 4 ++-- doc/man/man1/sbatch.1 | 4 ++-- doc/man/man1/srun.1 | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/doc/man/man1/salloc.1 b/doc/man/man1/salloc.1 index 0183395eb5a..34c3266671b 100644 --- a/doc/man/man1/salloc.1 +++ b/doc/man/man1/salloc.1 @@ -1111,8 +1111,8 @@ This option has been replaced by \fB\-\-immediate\fR=<\fIseconds\fR>. .TP \fB\-w\fR, \fB\-\-nodelist\fR=<\fInode name list\fR> Request a specific list of hosts. -Unless constrained by the maximum node count, the job will contain -\fIall\fR of these hosts. +The job will contain \fIall\fR of these hosts and possibly additional hosts +as needed to satisfy resource requirements. The list may be specified as a comma\-separated list of hosts, a range of hosts (host[1\-5,7,...] for example), or a filename. The host list will be assumed to be a filename if it contains a "/" character. diff --git a/doc/man/man1/sbatch.1 b/doc/man/man1/sbatch.1 index ea5c674138e..8593ce6be26 100644 --- a/doc/man/man1/sbatch.1 +++ b/doc/man/man1/sbatch.1 @@ -1283,8 +1283,8 @@ errors will be displayed. .TP \fB\-w\fR, \fB\-\-nodelist\fR=<\fInode name list\fR> Request a specific list of hosts. -Unless constrained by the maximum node count, the job will contain -\fIall\fR of these hosts. +The job will contain \fIall\fR of these hosts and possibly additional hosts +as needed to satisfy resource requirements. The list may be specified as a comma\-separated list of hosts, a range of hosts (host[1\-5,7,...] for example), or a filename. The host list will be assumed to be a filename if it contains a "/" character. diff --git a/doc/man/man1/srun.1 b/doc/man/man1/srun.1 index ae5a03791ab..afd2bd0e3d2 100644 --- a/doc/man/man1/srun.1 +++ b/doc/man/man1/srun.1 @@ -1656,8 +1656,8 @@ exits with a non\-zero exit code. .TP \fB\-w\fR, \fB\-\-nodelist\fR=<\fIhost1,host2,...\fR or \fIfilename\fR> Request a specific list of hosts. -Unless constrained by the maximum node count, the job will contain -\fIall\fR of these hosts. +The job will contain \fIall\fR of these hosts and possibly additional hosts +as needed to satisfy resource requirements. The list may be specified as a comma\-separated list of hosts, a range of hosts (host[1\-5,7,...] for example), or a filename. The host list will be assumed to be a filename if it contains a "/" character. -- GitLab