From dcbda4e1ac4f9e5a0cf56af04caf65d465762bda Mon Sep 17 00:00:00 2001
From: David Bigagli <david@schedmd.com>
Date: Tue, 24 Sep 2013 15:17:17 -0700
Subject: [PATCH] Update scontrol documentation to reflect who can modify some
 job parameters.

---
 doc/man/man1/scontrol.1 | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/doc/man/man1/scontrol.1 b/doc/man/man1/scontrol.1
index 9ca6ea7f7f8..428c344fa61 100644
--- a/doc/man/man1/scontrol.1
+++ b/doc/man/man1/scontrol.1
@@ -440,6 +440,7 @@ Possible values on Blue Gene are "MESH", "TORUS" and "NAV"
 \fIContiguous\fP=<yes|no>
 Set the job's requirement for contiguous (consecutive) nodes to be allocated.
 Possible values are "YES" and "NO".
+Only the Slurm administrator or root can change this parameter.
 .TP
 \fIDependency\fP=<dependency_list>
 Defer job's initiation until specified job dependency specification
@@ -534,18 +535,21 @@ of the cluster) as described in salloc/sbatch/srun man pages.
 .TP
 \fIMinCPUsNode\fP=<count>
 Set the job's minimum number of CPUs per node to the specified value.
+Only the Slurm administrator or root can change this parameter.
 .TP
 \fIMinMemoryCPU\fP=<megabytes>
 Set the job's minimum real memory required per allocated CPU to the specified
-value.
+value. Only the Slurm administrator or root can change this parameter.
 Either \fIMinMemoryCPU\fP or \fIMinMemoryNode\fP may be set, but not both.
 .TP
 \fIMinMemoryNode\fP=<megabytes>
 Set the job's minimum real memory required per node to the specified value.
 Either \fIMinMemoryCPU\fP or \fIMinMemoryNode\fP may be set, but not both.
+Only the Slurm administrator or root can change this parameter.
 .TP
 \fIMinTmpDiskNode\fP=<megabytes>
 Set the job's minimum temporary disk space required per node to the specified value.
+Only the Slurm administrator or root can change this parameter.
 .TP
 \fIName\fP=<name>
 Set the job's name to the specified value.
@@ -556,7 +560,7 @@ The adjustment range is from \-10000 (highest priority)
 to 10000 (lowest priority).
 Nice value changes are not additive, but overwrite any prior nice
 value and are applied to the job's base priority.
-Only privileged users can specify a negative adjustment.
+Only privileged users, Slurm administrator or root, can specify a negative adjustment.
 .TP
 \fINodeList\fP=<nodes>
 Change the nodes allocated to a running job to shrink it's size.
@@ -592,6 +596,7 @@ Explicitly setting a job's priority clears any previously set nice value and
 removes the priority/multifactor plugin's ability to manage a job's priority.
 In order to restore the priority/multifactor plugin's ability to manage a
 job's priority, hold and then release the job.
+Only the Slurm administrator or root can increase job's priority.
 .TP
 \fIQOS\fP=<name>
 Set the job's QOS (Quality Of Service) to the specified value.
@@ -625,7 +630,7 @@ Possible values are "YES" and "NO".
 .TP
 \fIShared\fP=<yes|no>
 Set the job's ability to share nodes with other jobs. Possible values are
-"YES" and "NO".
+"YES" and "NO". Only the Slurm administrator or root can increase job's priority.
 .TP
 \fIStartTime\fP=<time_spec>
 Set the job's earliest initiation time.
@@ -684,7 +689,7 @@ precede the time with a "+" or "\-" to increment or decrement the current
 time limit (e.g. "TimeLimit=+30"). In order to increment or decrement the
 current time limit, the \fIJobId\fP specification must precede the
 \fITimeLimit\fP specification.
-
+Only the Slurm administrator or root can increase job's TimeLimit.
 .TP
 \fIwait\-for\-switch\fP=<max\-time\-to\-wait>
 When a tree topology is used, this defines the  maximum time to wait for the
-- 
GitLab