This is the first release candidate of the runc 1.4.0 release. It
contains a couple of new features, but is mostly made up of some minor
bug fixes and some follow-ups for features deprecated in runc 1.3.0.
Users are strongly encouraged to test our release candidates over the
next two months so we can fix issues before the general release. You
should expect runc 1.4.0 to be released at the end of October 2025 (at
which point, runc 1.2.z will only receive high-severity security fixes
for 6 months and users are thus very strongly encouraged to migrate to a
newer version).
This version of runc requires Go 1.24 to build.
libcontainer API
- The deprecated
libcontainer/user
package has been removed; use
github.com/moby/sys/user
instead. (#3999, #4617) libcontainer/apparmor
variables containing public functions have been
switched to wrapper functions. (#4725)
Breaking
-
runc update no longer allows
--l3-cache-schema
or--mem-bw-schema
if
linux.intelRdt
was not present in the container’s originalconfig.json
.Without
linux.intelRdt
no CLOS (resctrl group) is created at container
creation, so it is not possible to apply the updated options withrunc 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) -
The deprecated
--criu
flag has been removed entirely, instead thecriu
binary in$PATH
will be used. (#4722)
Added
- runc now supports the
linux.netDevices
field to allow for devices to be
moved into container network namespaces seamlessly. (#4538) runc update
now supports per-device weight and iops cgroup limits. (#4775)- intel rdt: allow explicit assignment to root CLOS. (#4854)
Fixed
- Container processes will no longer inherit the CPU affinity of runc by
default. Instead, the default CPU affinity of container processes will be
the largest set of CPUs permitted by the container's cpuset cgroup and any
other system restrictions (such as isolated CPUs). (#4041, #4815, #4858) - Use
chown(uid, -1)
when configuring the console inode, to avoid issues
with unmapped GIDs. (#4679) - Add logging for the cases where failed keyring operations are ignored during
setup. (#4676) - Optimise
runc exec
by avoiding calling into SELinux'sSet.*Label
when
processLabel
is not set. (#4354) - Fix mips64 builds for remap-rootfs. (#4723)
- Setting
linux.rootfsPropagation
toshared
orunbindable
now functions
properly. (#1755, #1815, #4724) - runc delete and runc stop can now correctly handle cases where runc
create was killed during setup. Previously it was possible for the
container to be in such a state that neither runc stop nor runc
delete would be unable to kill or delete the container. (#4534,
#4645, #4757) - Close seccomp agent connection to prevent resource leaks. (#4796)
runc update
will no longer clear intelRdt state information. (#4828)- runc will now error out earlier if intelRdt is not enabled. (#4829)
- Improve filesystem operations within intelRdt manager. (#4840, #4831)
- Resolve a certain race between
runc create
andrunc delete
that would
previously result in spurious errors. (#4735) - CI: skip bpf tests on misbehaving udev systems. (#4825)
Changes
- Use Go's built-in
pidfd_send_signal(2)
support when available. (#4666) - Make
state.json
25% smaller. (#4685) - Migrate to Go 1.22+ features. (#4687, #4703)
- Provide private wrappers around common syscalls to make
-EINTR
handling
less cumbersome for the rest of runc. (#4697) - Ignore the dmem controller in our cgroup tests, as systemd does not
yet support it. (#4806) /proc/net/dev
is no longer included in the permitted procfs overmount
list. Its inclusion was almost certainly an error, and because
/proc/net
is a symlink to/proc/self/net
, overmounting this was
almost certainly never useful (and will be blocked by future kernel
versions). (#4817)- Simplify the prepareCriuRestoreMounts logic for checkpoint-restore.
(#4765) - Bump minimum Go version to 1.24. (#4851)
- CI: migrate virtualised Fedora tests from Vagrant + Cirrus to Lima + GHA. We
still use Cirrus for the AlmaLinux tests, since they can be run without
virtualisation. (#4664) - CI: install fewer dependencies (#4671), bump shellcheck and bats versions
(#4670). - CI: remove
toolchain
fromgo.mod
and add a CI check to make sure it's
never added accidentally. (#4717, #4721) - CI: do not allow
exclude
orreplace
directives ingo.mod
, to make sure
thatgo install
doesn't get accidentally broken. (#4750) - CI: fix exclusion rules and allow us to run jobs manually. (#4760)
- CI: Switch to GitHub-hosted ARM runners. Thanks again to @alexellis
for supporting runc's ARM CI up until now. (#4844, #4856) - Various dependency updates. (#4659, #4658, #4662, #4663, #4689, #4694,
#4702, #4701, #4707, #4710, #4746, #4756, #4751, #4758, #4764, #4768, #4779,
#4783, #4785, #4801, #4808, #4803, #4839, #4846, #4847, #4845, #4850, #4861,
#4860)
Static Linking Notices
The runc
binary distributed with this release are statically linked with
the following GNU LGPL-2.1 licensed libraries, with runc
acting
as a "work that uses the Library":
The versions of these libraries were not modified from their upstream versions,
but in order to comply with the LGPL-2.1 (§6(a)), we have attached the
complete source code for those libraries which (when combined with the attached
runc source code) may be used to exercise your rights under the LGPL-2.1.
However we strongly suggest that you make use of your distribution's packages
or download them from the authoritative upstream sources, especially since
these libraries are related to the security of your containers.
Thanks to the following contributors for making this release possible:
- Akihiro Suda akihiro.suda.cz@hco.ntt.co.jp
- Aleksa Sarai cyphar@cyphar.com
- Andrei Vagin avagin@gmail.com
- Antonio Ojea aojea@google.com
- Antti Kervinen antti.kervinen@intel.com
- Henry Chen henry.chen@oss.cipunited.com
- HirazawaUi 695097494plus@gmail.com
- Kir Kolyshkin kolyshkin@gmail.com
- Markus Lehtonen markus.lehtonen@intel.com
- Martin Sivak msivak@redhat.com
- Mikhail Dmitrichenko m.dmitrichenko222@gmail.com
- Pavel Liubimov prlyubimov@gmail.com
- Peter Hunt pehunt@redhat.com
- Prajwal S N prajwalnadig21@gmail.com
- Rodrigo Campos rodrigoca@microsoft.com
- Sebastiaan van Stijn thaJeztah@users.noreply.github.com
- Tigran Sogomonian tsogomonian@astralinux.ru
- Yusuke Sakurai yusuke.sakurai@3-shake.com
- jokemanfire hu.dingyang@zte.com.cn
- lifubang lifubang@acmcoder.com
- ningmingxiao ning.mingxiao@zte.com.cn
Signed-off-by: Aleksa Sarai cyphar@cyphar.com