runc v1.2.7 -- "さんをつけろよデコ助野郎！"

This is the seventh release of the 1.2.z release branch of runc. It
contains some fixes for issues found in runc 1.3.z that were considered
"significant" bugfixes (as per our new release and support policy) and
thus be worth backporting.

Fixed

• Removed preemptive "full access to cgroups" warning when calling
  runc pause or runc unpause as an unprivileged user without
  --systemd-cgroups. Now the warning is only emitted if an actual permission
  error was encountered. (#4709, #4720)
• Add time namespace to container config after checkpoint/restore. CRIU since
  version 3.14 uses a time namespace for checkpoint/restore, however it was
  not joining the time namespace in runc. (#4696, #4714)
• 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)
• Close seccomp agent connection to prevent resource leaks. (#4796, #4800)
• Several fixes to our CI, mainly related to AlmaLinux and CRIU. (#4670,
  #4728, #4736, #4742)
• Setting linux.rootfsPropagation to shared or unbindable now functions
  properly. (#1755, #1815, #4724, #4791)
• runc update will no longer clear intelRdt state information. (#4828,
  #4834)

Changed

• In runc 1.2, we changed our mount behaviour to correctly handle clearing
  flags. However, the error messages we returned did not provide as much
  information to users about what clearing flags were conflicting with locked
  mount flags. We now provide more diagnostic information if there is an error
  when in the fallback path to handle locked mount flags. (#4734, #4740)
• Ignore the dmem controller in our cgroup tests, as systemd does not yet
  support it. (#4806, #4811)
• /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, #4820)
• CI: Switch to GitHub-hosted ARM runners. Thanks again to @alexellis for
  supporting runc's ARM CI up until now. (#4844, #4856, #4867)
• Simplify the prepareCriuRestoreMounts logic for checkpoint-restore.
  (#4765, #4872)

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":

• libseccomp

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 [email protected]
• Aleksa Sarai [email protected]
• Andrei Vagin [email protected]
• Kir Kolyshkin [email protected]
• Markus Lehtonen [email protected]
• Martin Sivak [email protected]
• Pavel Liubimov [email protected]
• Peter Hunt [email protected]
• Rodrigo Campos [email protected]
• Yusuke Sakurai [email protected]
• lfbzhm [email protected]
• ningmingxiao [email protected]

Signed-off-by: Aleksa Sarai [email protected]

runc v1.3.0 -- "Mr. President, we must not allow a mine shaft gap!"

This is the first release of the 1.3.z release branch of runc. It
contains a few minor fixes for issues found in 1.3.0-rc.2.

This is the first release of runc that will follow our new release and
support policy (see RELEASES.md for more details). This means that, as
of this release:

• As of this release, the runc 1.2.z release branch will now only
  receive security and "significant" bugfixes.
• Users are encouraged to plan migrating to runc 1.3.0 as soon as
  possible.
• Due to its particular situation, runc 1.1.z is officially no longer
  supported and will no longer receive any updates (not even for
  critical security issues). Users are urged (in the strongest possible
  terms) to upgrade to a supported version of runc.
• Barring any future changes to our release policy, users should expect
  a runc 1.4.0 release in late October 2025.

Fixed

• Removed pre-emptive "full access to cgroups" warning when calling
  runc pause or runc unpause as an unprivileged user without
  --systemd-cgroups. Now the warning is only emitted if an actual permission
  error was encountered. (#4709)
• Several fixes to our CI, mainly related to AlmaLinux and CRIU. (#4670,
  #4728, #4736)

Changed

• In runc 1.2, we changed our mount behaviour to correctly handle clearing
  flags. However, the error messages we returned did not provide as much
  information to users about what clearing flags were conflicting with locked
  mount flags. We now provide more diagnostic information if there is an error
  when in the fallback path to handle locked mount flags. (#4734)
• Upgrade our CI to use golangci-lint v2.0. (#4692)
• runc version information is now filled in using //go:embed rather than
  being set through Makefile. This allows go install or other non-make
  builds to contain the correct version information. Note that
  make EXTRA_VERSION=... still works. (#418)
• Remove exclude directives from our go.mod for broken cilium/ebpf
  versions. v0.17.3 resolved the issue we had, and exclude directives are
  incompatible with go install. (#4748)

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":

• libseccomp

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 [email protected]
• Aleksa Sarai [email protected]
• Kir Kolyshkin [email protected]
• Rodrigo Campos [email protected]
• lifubang [email protected]

Signed-off-by: Aleksa Sarai [email protected]

runc v1.3.0-rc.2 -- "Eppur si muove."

This is the second release candidate of the runc 1.3.0 release. It
contains a few fixes for issues found in rc.1.

This is the first release series that will follow our new release
policy, meaning that users should expect runc 1.3.0 to be released at
the end of April 2025, at which point the support policy for the runc
1.2.z branch will change. Please see the new RELEASES.md document for
more information.

Users are strongly encouraged to test our release candidates so we can
fix issues before the general release.

Fixed

• Use the container's /etc/passwd to set the HOME env var. After a refactor
  for 1.3, we were setting it reading the host's /etc/passwd file instead.
  (#4693, #4688)
• Override HOME env var if it's set to the empty string. This fixes a
  regression after the same refactor for 1.3 and aligns the behavior with older
  versions of runc. (#4711)
• Add time namespace to container config after checkpoint/restore. CRIU since
  version 3.14 uses a time namespace for checkpoint/restore, however it was not
  joining the time namespace in runc. (#4705)

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":

• libseccomp

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:

• Rodrigo Campos [email protected]
• Rudi Heitbaum [email protected]
• Kir Kolyshkin [email protected]
• lifubang [email protected]
• Akihiro Suda [email protected]
• Andrei Vagin [email protected]

Signed-off-by: Kir Kolyshkin [email protected]

runc v1.2.6 -- "Hasta la victoria, siempre."

This is the sixth patch release in the 1.2.z series of runc.
It primarily fixes an issue with runc exec vs time namespace,
and a compatibility issue with older kernels.

Fixed

• Fix a stall issue that would happen if setting O_CLOEXEC with
  CloseExecFrom failed (#4647).
• runc now properly handles joining time namespaces (such as with
  runc exec). Previously we would attempt to set the time offsets
  when joining, which would fail. (#4635, #4649)
• Handle EINTR retries correctly for socket-related direct
  golang.org/x/sys/unix system calls. (#4650)
• We no longer use F_SEAL_FUTURE_WRITE when sealing the runc binary, as it
  turns out this had some unfortunate bugs in older kernel versions and was
  never necessary in the first place. (#4651, #4640)

Removed

• Remove Fexecve helper from libcontainer/system. Runc 1.2.1 removed
  runc-dmz, but we forgot to remove this helper added only for that. (#4646)

Changed

• Use Go 1.23 for official builds, run CI with Go 1.24 and drop Ubuntu 20.04
  from CI. We need to drop Ubuntu 20.04 from CI because Github Actions
  announced it's already deprecated and it will be discontinued soon. (#4648)

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":

• libseccomp

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 who made this release possible:

• Akihiro Suda [email protected]
• Aleksa Sarai [email protected]
• Evan Phoenix [email protected]
• Kir Kolyshkin [email protected]
• lifubang [email protected]
• Rodrigo Campos [email protected]
• Tomasz Duda [email protected]

Signed-off-by: Kir Kolyshkin [email protected]

runc v1.3.0-rc.1 -- "No tengo miedo al invierno, con tu recuerdo lleno de sol."

This is the first release candidate of the runc 1.3.0 release. It
contains a couple of new features, but is mostly made up of some minor
(but notable) API changes to libcontainer as well as a series of bug
fixes.

This is the first release series that will follow our new release
policy, meaning that user should expect runc 1.3.0 to be released at the
end of April 2025, at which point the support policy for the runc 1.2.z
branch will change. Please see the new RELEASES.md document for more
information.

Users are strongly encouraged to test our release candidates over the
next two months so we can fix issues before the general release.

libcontainer API

• configs.CommandHook struct has changed, Command is now a pointer.
  Also, configs.NewCommandHook now accepts a *Command. (#4325)
• The Process struct has User string field replaced with numeric
  UID and GID fields, and AdditionalGroups changed its type from
  []string to []int. Essentially, resolution of user and group
  names to IDs is no longer performed by libcontainer, so if a libcontainer
  user previously relied on this feature, now they have to convert names to
  IDs before calling libcontainer; it is recommended to use Go package
  github.com/moby/sys/user for that. (#3999)
• Move libcontainer/cgroups to a separate repository. (#4618)

Fixed

• runc exec -p no longer ignores specified ioPriority and scheduler
  settings. Similarly, libcontainer's Container.Start and Container.Run
  methods no longer ignore Process.IOPriority and Process.Scheduler
  settings. (#4585)
• We no longer use F_SEAL_FUTURE_WRITE when sealing the runc binary, as it
  turns out this had some unfortunate bugs in older kernel versions and was
  never necessary in the first place. (#4641, #4640)
• runc now uses a more flexible method of joining namespaces, which better
  matches the behaviour of nsenter(8). This is mainly useful for users that
  create a container with a runc-managed user namespace but want the container
  to join some externally-managed namespace as well. (#4492)
• runc now properly handles joining time namespaces (such as with runc exec).
  Previously we would attempt to set the time offsets when joining, which
  would fail. (#4635, #4636)
• Handle EINTR retries correctly for socket-related direct
  golang.org/x/sys/unix system calls. (#4637)
• Handle close_range(2) errors more gracefully. (#4596)
• Fix a stall issue that would happen if setting O_CLOEXEC with
  CloseExecFrom failed (#4599).
• Handle errors on older kernels when resetting ambient capabilities more
  gracefully. (#4597)

Changed

• runc now has an official release policy to help provide more consistency
  around our release schedules and better define our support policy for old
  release branches. See RELEASES.md for more details. (#4557)
• Improved performance by switching to strings.Cut where appropriate.
  (#4470)
• The minimum Go version of runc is now Go 1.23. (#4598)
• Updated builds to libseccomp v2.5.6. (#4625)

Added

• runc has been updated to support OCI runtime-spec 1.2.1. (#4653)
• CPU affinity support for runc exec. (#4327)
• CRIU support can be disabled using the build tag runc_nocriu. (#4546)
• Support to get the pidfd of the container via CLI flag pidfd-socket.
  (#4045)
• Support skip-in-flight and link-remap options for CRIU. (#4627)
• Support cgroup v1 mounted with noprefix. (#4513)

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":

• libseccomp

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:

• Adam Korczynski [email protected]
• Akihiro Suda [email protected]
• Aleksa Sarai [email protected]
• Brad Davidson [email protected]
• Daniel Levi-Minzi [email protected]
• Evan Phoenix [email protected]
• Jian Wen [email protected]
• Kir Kolyshkin [email protected]
• Rin Arakaki [email protected]
• Rodrigo Campos [email protected]
• Sebastiaan van Stijn [email protected]
• Tomasz Duda [email protected]
• Wei Fu [email protected]
• Yangzhao Hjh [email protected]
• lifubang [email protected]

Signed-off-by: Aleksa Sarai [email protected]

runc v1.2.5 -- "Мороз и солнце; день чудесный!"

This is the fifth patch release in the 1.2.z series of runc. It
primarily fixes an issue caused by an upstream systemd bug.

• There was a regression in systemd v230 which made the way we define device
  rule restrictions require a systemctl daemon-reload for our transient
  units. This caused issues for workloads using NVIDIA GPUs. Workaround the
  upstream regression by re-arranging how the unit properties are defined.
  (#4568, #4612, #4615)
• Dependency github.com/cyphar/filepath-securejoin is updated to v0.4.1,
  to allow projects that vendor runc to bump it as well. (#4608)
• CI: fixed criu-dev compilation. (#4611)
• Dependency golang.org/x/net is updated to 0.33.0. (#4632)

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":

• libseccomp

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 who made this release possible:

• Akihiro Suda [email protected]
• Aleksa Sarai [email protected]
• Brad Davidson [email protected]
• Jian Wen [email protected]
• Kir Kolyshkin [email protected]
• Rodrigo Campos [email protected]
• lifubang [email protected]

Signed-off-by: Aleksa Sarai [email protected]

runc v1.2.4 -- "Христос се роди!"

This is the fourth patch release of the 1.2.z release branch of runc. It
includes a fix for a regression introduced in 1.2.0 related to the
default device list.

• Re-add tun/tap devices to built-in allowed devices lists.

  In runc 1.2.0 we removed these devices from the default allow-list
  (which were added seemingly by accident early in Docker's history) as
  a precaution in order to try to reduce the attack surface of device
  inodes available to most containers (#3468). At the time we thought
  that the vast majority of users using tun/tap would already be
  specifying what devices they need (such as by using --device with
  Docker/Podman) as opposed to doing the mknod manually, and thus
  there would've been no user-visible change.

  Unfortunately, it seems that this regressed a noticeable number of
  users (and not all higher-level tools provide easy ways to specify
  devices to allow) and so this change needed to be reverted. Users
  that do not need these devices are recommended to explicitly disable
  them by adding deny rules in their container configuration. (#4555,
  #4556)

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":

• libseccomp

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 all of the contributors who made this release possible:

• Akihiro Suda [email protected]
• Aleksa Sarai [email protected]
• Kir Kolyshkin [email protected]
• lifubang [email protected]

Signed-off-by: Aleksa Sarai [email protected]

runc v1.2.3 -- "Winter is not a season, it's a celebration."

This is the third patch release of the 1.2.z release branch of runc. It
primarily fixes some minor regressions introduced in 1.2.0.

• Fixed a regression in use of securejoin.MkdirAll, where multiple
  runc processes racing to create the same mountpoint in a shared rootfs
  would result in spurious EEXIST errors. In particular, this regression
  caused issues with BuildKit. (#4543, #4550)
• Fixed a regression in eBPF support for pre-5.6 kernels after upgrading
  Cilium's eBPF library version to 0.16 in runc. (#3008, #4551)

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":

• libseccomp

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 all of the contributors who made this release possible:

• Aleksa Sarai [email protected]
• Kir Kolyshkin [email protected]
• lifubang [email protected]

Signed-off-by: Aleksa Sarai [email protected]

runc v1.2.2 -- "Specialization is for insects."

This is the second patch release of the 1.2.z branch of runc. It
includes two fixes for problems introduced in runc 1.2.0, as well as
some documentation improvements surrounding the overlayfs /proc/self/exe
protections.

• Fixed the failure of runc delete on a rootless container with no
  dedicated cgroup on a system with read-only /sys/fs/cgroup mount.
  This is a regression in runc 1.2.0, causing a failure when using
  rootless buildkit. (#4518, #4531)
• Using runc on a system where /run/runc and /usr/bin are on different
  filesystems no longer results in harmless but annoying messages
  ("overlayfs: "xino" feature enabled using 3 upper inode bits")
  appearing in the kernel log. (#4508, #4530)
• Better memfd-bind documentation. (#4530)
• CI: bump Fedora 40 -> 41. (#4528)

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":

• libseccomp

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 all of the contributors who made this release possible:

• Akihiro Suda [email protected]
• Aleksa Sarai [email protected]
• Austin Vazquez [email protected]
• Kir Kolyshkin [email protected]
• Rodrigo Campos [email protected]
• lfbzhm [email protected]

Signed-off-by: Aleksa Sarai [email protected]

runc v1.2.1 -- "No existe una escuela que enseñe a vivir."

This is the first patch release of the 1.2.z series of runc. It includes
a critical bugfix for an issue that manifested on SELinux-based
distributions and was blocking containerd from updating to
runc 1.2.z.

In addition, runc-dmz (added in 1.2.0) has been removed entirely. This
was opt-in (due to the many limitations it had), but the late addition
of the overlayfs-based CVE-2019-5736 protection made it no longer
necessary at all.

• We now explicitly become root after joining an existing user namespace.
  Otherwise, runc won't have permissions to configure some mounts when
  running under SELinux and runc is not creating the user namespace.
  (#4466, #4477)

• Remove dependency on golang.org/x/sys/execabs from go.mod. (#4480)
• Remove runc-dmz, that had many limitations, and is mostly made obsolete by
  the new protection mechanism added in v1.2.0. Note that runc-dmz was only
  available only in the 1.2.0 release and required to set an environment variable
  to opt-in. (#4488)

• The script/check-config.sh script now checks for overlayfs support. (#4494)
• When using cgroups v2, allow to set or update memory limit to "unlimited"
  and swap limit to a specific value. (#4501)

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":

• libseccomp

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 all of the contributors who made this release possible:

• Akihiro Suda [email protected]
• Aleksa Sarai [email protected]
• Kir Kolyshkin [email protected]
• Rodrigo Campos [email protected]
• Wei Fu [email protected]
• lifubang [email protected]

Signed-off-by: Aleksa Sarai [email protected]