cgroup: define controller file conventions
authorTejun Heo <tj@kernel.org>
Tue, 4 Aug 2015 19:20:55 +0000 (15:20 -0400)
committerTejun Heo <tj@kernel.org>
Tue, 4 Aug 2015 19:20:55 +0000 (15:20 -0400)
commit6abc8ca19df0078de17dc38340db3002ed489ce7
tree126fd69e8b4645e1da77f26ec73ea711e7b2165f
parentd770e558e21961ad6cfdf0ff7df0eb5d7d4f0754
cgroup: define controller file conventions

Traditionally, each cgroup controller implemented whatever interface
it wanted leading to interfaces which are widely inconsistent.
Examining the requirements of the controllers readily yield that there
are only a few control schemes shared among all.

Two major controllers already had to implement new interface for the
unified hierarchy due to significant structural changes.  Let's take
the chance to establish common conventions throughout all controllers.

This patch defines CGROUP_WEIGHT_MIN/DFL/MAX to be used on all weight
based control knobs and documents the conventions that controllers
should follow on the unified hierarchy.  Except for io.weight knob,
all existing unified hierarchy knobs are already compliant.  A
follow-up patch will update io.weight.

v2: Added descriptions of min, low and high knobs.

Signed-off-by: Tejun Heo <tj@kernel.org>
Acked-by: Johannes Weiner <hannes@cmpxchg.org>
Cc: Li Zefan <lizefan@huawei.com>
Cc: Peter Zijlstra <peterz@infradead.org>
Documentation/cgroups/unified-hierarchy.txt
include/linux/cgroup.h