summaryrefslogtreecommitdiffstats
path: root/Documentation/admin-guide
diff options
context:
space:
mode:
authorTejun Heo2019-05-13 21:37:17 +0200
committerTejun Heo2019-05-31 20:48:40 +0200
commita5e112e6424adb77d953eac20e6936b952fd6b32 (patch)
treef338dc9c274907e5d2321f9e7e4a8608fdb202ea /Documentation/admin-guide
parentcgroup: Include dying leaders with live threads in PROCS iterations (diff)
downloadkernel-qcow2-linux-a5e112e6424adb77d953eac20e6936b952fd6b32.tar.gz
kernel-qcow2-linux-a5e112e6424adb77d953eac20e6936b952fd6b32.tar.xz
kernel-qcow2-linux-a5e112e6424adb77d953eac20e6936b952fd6b32.zip
cgroup: add cgroup_parse_float()
cgroup already uses floating point for percent[ile] numbers and there are several controllers which want to take them as input. Add a generic parse helper to handle inputs. Update the interface convention documentation about the use of percentage numbers. While at it, also clarify the default time unit. Signed-off-by: Tejun Heo <tj@kernel.org>
Diffstat (limited to 'Documentation/admin-guide')
-rw-r--r--Documentation/admin-guide/cgroup-v2.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/admin-guide/cgroup-v2.rst b/Documentation/admin-guide/cgroup-v2.rst
index 88e746074252..73b0c0d8df31 100644
--- a/Documentation/admin-guide/cgroup-v2.rst
+++ b/Documentation/admin-guide/cgroup-v2.rst
@@ -696,6 +696,12 @@ Conventions
informational files on the root cgroup which end up showing global
information available elsewhere shouldn't exist.
+- The default time unit is microseconds. If a different unit is ever
+ used, an explicit unit suffix must be present.
+
+- A parts-per quantity should use a percentage decimal with at least
+ two digit fractional part - e.g. 13.40.
+
- If a controller implements weight based resource distribution, its
interface file should be named "weight" and have the range [1,
10000] with 100 as the default. The values are chosen to allow