Skip to content

Commit a02902e

Browse files
committed
docs: deprecated: complete deprecation of kernel-memory limit
Signed-off-by: Sebastiaan van Stijn <[email protected]>
1 parent 4373ce5 commit a02902e

File tree

1 file changed

+3
-17
lines changed

1 file changed

+3
-17
lines changed

docs/deprecated.md

Lines changed: 3 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -730,25 +730,11 @@ When using cgroups v2, the `--blkio-weight` options are implemented using
730730

731731
Specifying kernel memory limit (`docker run --kernel-memory`) is no longer supported
732732
because the [Linux kernel deprecated `kmem.limit_in_bytes` in v5.4](https://github.com/torvalds/linux/commit/0158115f702b0ba208ab0b5adf44cae99b3ebcc7).
733-
The OCI runtime specification now marks this option (as well as `--kernel-memory-tcp`)
734-
as ["NOT RECOMMENDED"](https://github.com/opencontainers/runtime-spec/pull/1093),
733+
The OCI runtime specification now marks this option as ["NOT RECOMMENDED"](https://github.com/opencontainers/runtime-spec/pull/1093),
735734
and OCI runtimes such as `runc` no longer support this option.
736735

737-
Docker API v1.42 and up now ignores this option when set. Older versions of the
738-
API continue to accept the option, but depending on the OCI runtime used, may
739-
take no effect.
740-
741-
> [!NOTE]
742-
> While not deprecated (yet) in Docker, the OCI runtime specification also
743-
> deprecated the `memory.kmem.tcp.limit_in_bytes` option. When using `runc` as
744-
> runtime, this option takes no effect. The Linux kernel did not explicitly
745-
> deprecate this feature, and there is a tracking ticket in the `runc` issue
746-
> tracker to determine if this option should be reinstated or if this was an
747-
> oversight of the Linux kernel maintainers (see [opencontainers/runc#3174](https://github.com/opencontainers/runc/issues/3174)).
748-
>
749-
> The `memory.kmem.tcp.limit_in_bytes` option is only supported with cgroups v1,
750-
> and not available on installations running with cgroups v2. This option is
751-
> only supported by the API, and not exposed on the `docker` command-line.
736+
The Docker API no longer handles the kernel-memory fields, and Docker CLI v29.0
737+
removes the `--kernel-memory` option.
752738

753739
### Classic Swarm and overlay networks using cluster store
754740

0 commit comments

Comments
 (0)