From 07d72d32b43ea303d2c91fc74b6ad75c9e3c4e12 Mon Sep 17 00:00:00 2001
From: "Christopher J. Morrone" <morrone2@llnl.gov>
Date: Tue, 29 Aug 2006 21:56:54 +0000
Subject: [PATCH] Document the --exclusive option in the sbatch and salloc man
 pages.

---
 doc/man/man1/salloc.1 | 18 +++++++++++++-----
 doc/man/man1/sbatch.1 | 18 +++++++++++++-----
 2 files changed, 26 insertions(+), 10 deletions(-)

diff --git a/doc/man/man1/salloc.1 b/doc/man/man1/salloc.1
index 0c0c94b2880..b280a5f3bf6 100644
--- a/doc/man/man1/salloc.1
+++ b/doc/man/man1/salloc.1
@@ -43,11 +43,19 @@ different  users.   The  value may be changed after job submission using the
 scontrol command.
 
 .TP
-\fB\-s\fR, \fB\-\-share\fR
-The job allocation can share nodes with other running jobs. This 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.
+\fB\-s\fR, \fB\-\-shared\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 \-\-shared
+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\-\-exclusive\fR
+The job allocation cannot share nodes with other running jobs.  This is
+the oposite of \-\-shared, whichever option is seen last on the command line
+will win.  (The default shared/exclusive behaviour depends on system
+configuration.)
 
 .TP
 \fB\-t\fR, \fB\-\-time\fR[=]<\fIminutes\fR>
diff --git a/doc/man/man1/sbatch.1 b/doc/man/man1/sbatch.1
index 31af3655ddd..609eae912f1 100644
--- a/doc/man/man1/sbatch.1
+++ b/doc/man/man1/sbatch.1
@@ -52,11 +52,19 @@ different  users.   The  value may be changed after job submission using the
 scontrol command.
 
 .TP
-\fB\-s\fR, \fB\-\-share\fR
-The job allocation can share nodes with other running jobs. This 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.
+\fB\-s\fR, \fB\-\-shared\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 \-\-shared
+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\-\-exclusive\fR
+The job allocation cannot share nodes with other running jobs.  This is
+the oposite of \-\-shared, whichever option is seen last on the command line
+will win.  (The default shared/exclusive behaviour depends on system
+configuration.)
 
 .TP
 \fB\-t\fR, \fB\-\-time\fR[=]<\fIminutes\fR>
-- 
GitLab