Skip to content

Commit 8958f93

Browse files
committed
merge branch 'pr-1125'
Kir Kolyshkin (1): config-linux: MAY reject an unfit cgroup LGTMs: guiseppe tianon cyphar Closes opencontainers#1125
2 parents c2389c3 + 104385d commit 8958f93

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

config-linux.md

+10
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,16 @@ Also known as cgroups, they are used to restrict resource usage for a container
171171
cgroups provide controls (through controllers) to restrict cpu, memory, IO, pids, network and RDMA resources for the container.
172172
For more information, see the [kernel cgroups documentation][cgroup-v1].
173173

174+
A runtime MAY, during a particular [container operation](runtime.md#operation),
175+
such as [create](runtime.md#create), [start](runtime.md#start), or
176+
[exec](runtime.md#exec), check if the container cgroup is fit for purpose,
177+
and MUST [generate an error](runtime.md#errors) if such a check fails.
178+
For example, a frozen cgroup or (for [create](runtime.md#create) operation)
179+
a non-empty cgroup. The reason for this is that accepting such configurations
180+
could cause container operation outcomes that users may not anticipate or
181+
understand, such as operation on one container inadvertently affecting other
182+
containers.
183+
174184
### <a name="configLinuxCgroupsPath" />Cgroups Path
175185

176186
**`cgroupsPath`** (string, OPTIONAL) path to the cgroups.

0 commit comments

Comments
 (0)