Skip to content

Commit 5942b00

Browse files
committed
config-linux: clarify cgroupsPath
Clarify some of the confusion with cgroupsPath. Due to systemd, we cannot require that relative paths be treated in any specific way. In addition, add a line stating that not all values of cgroupsPath are required to be valid (and that runtimes must error out if they have an invalid cgroup path). Signed-off-by: Aleksa Sarai <asarai@suse.de>
1 parent 79b26a1 commit 5942b00

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

config-linux.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,8 +158,12 @@ cgroups provide controls to restrict cpu, memory, IO, pids and network for the c
158158
For more information, see the [kernel cgroups documentation][cgroup-v1].
159159

160160
The path to the cgroups can be specified in the Spec via `cgroupsPath`.
161-
`cgroupsPath` is expected to be relative to the cgroups mount point.
162-
If `cgroupsPath` is not specified, implementations can define the default cgroup path.
161+
If `cgroupsPath` is
162+
* ... an absolute path (starting with `/`), the implementation MUST take the path to be relative to the cgroup mount point.
163+
* ... a relative path (not starting with `/`), implementations SHOULD take the value to be the suffix of the resulting cgroup path.
164+
* ... not specified, implementations CAN define the default cgroup path.
165+
Implementations CAN consider certain `cgroupsPath` values to be invalid, and MUST generate an error if this is the case.
166+
163167
Implementations of the Spec can choose to name cgroups in any manner.
164168
The Spec does not include naming schema for cgroups.
165169
The Spec does not support [split hierarchy][cgroup-v2].

0 commit comments

Comments
 (0)