From e1e4fb913aeca88e8042753559d6ca42a30e65de Mon Sep 17 00:00:00 2001
From: Moe Jette <jette1@llnl.gov>
Date: Fri, 21 Mar 2003 17:16:41 +0000
Subject: [PATCH] Describe new node state update option of "DRAIN".

---
 doc/html/quickstart.html | 3 +++
 doc/man/man1/scontrol.1  | 9 ++++++---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/doc/html/quickstart.html b/doc/html/quickstart.html
index 8383b639cf7..4d20bc7e639 100644
--- a/doc/html/quickstart.html
+++ b/doc/html/quickstart.html
@@ -307,6 +307,9 @@ scontrol: update JobId=477 Priority=0
 </pre>
 <p>
 Print the state of node <i>adev13</i> and drain it.
+To drain a node specify a new state of "DRAIN", "DRAINED", or "DRAINING".
+SLURM will automatically set it to the appropriate value of either "DRAINING"
+or "DRAINED" depending if the node is allocated or not.
 Return it to service later.
 <pre>
 adev0: scontrol
diff --git a/doc/man/man1/scontrol.1 b/doc/man/man1/scontrol.1
index 518d387f62a..f3284fdda2d 100644
--- a/doc/man/man1/scontrol.1
+++ b/doc/man/man1/scontrol.1
@@ -159,9 +159,12 @@ simple regular expressions (e.g. "lx[10-20]"). This specification is required.
 .TP
 \fIState\fP=<state>
 Identify the state to be assigned to the node. Possible values are  "NoResp", 
-"DOWN", "IDLE", "DRAINED", "DRAINING", and "ALLOCATED". The "NoResp" state 
-will only set the "NoResp" flag for a node without changing its underlying 
-state.
+"DOWN", "IDLE", "DRAIN", "DRAINED", "DRAINING", and "ALLOCATED". 
+To drain a node specify "DRAIN", "DRAINED", or "DRAINING".
+SLURM will automatically set it to the appropriate value of either 
+"DRAINING" or "DRAINED" depending if the node is allocated or not.
+The "NoResp" state will only set the "NoResp" flag for a node without
+changing its underlying state.
 .TP
 \fBSPECIFICATIONS FOR UPDATE COMMAND, PARTITIONS\fR
 .TP
-- 
GitLab