From a8faf92551e996403b563621b541e663bb8b5946 Mon Sep 17 00:00:00 2001
From: Markus Lehtonen <markus.lehtonen@intel.com>
Date: Mon, 11 Aug 2025 10:20:33 +0300
Subject: [PATCH] CHANGELOG: document breaking change of runc update

Co-authored-by: lfbzhm <lifubang@acmcoder.com>
Signed-off-by: Markus Lehtonen <markus.lehtonen@intel.com>
---
 CHANGELOG.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e390ab0ed..ae6cead0b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Breaking
+
+- runc update no longer allows `--l3-cache-schema` or `--mem-bw-schema` if
+  `linux.intelRdt` was not present in the container’s original `config.json`.
+
+  Without `linux.intelRdt` no CLOS (resctrl group) is created at container
+  creation, so it is not possible to apply the updated options with `runc
+  update`.
+
+  Previously, this scenario did not work as expected. The `runc update` would
+  create a new CLOS but fail to apply the schema, move only the init process
+  (omitting children) to the new group, and leave the CLOS orphaned after
+  container exit. (#4827)
+
 ## [1.3.0] - 2025-04-30
 
 > Mr. President, we must not allow a mine shaft gap!