[RFC PATCH v3 00/13] Namespace for namespace roots
From: Jarkko Sakkinen
Date: Wed Nov 18 2026 - 14:39:53 EST
OVERVIEW
========
A root namespace (rootns) is a kernel object backed by a file descriptor
that binds together:
1. A full set of detached namespaces owned by a fresh user namespace.
2. A dedicated PID namespace for spawning processes into, signaling
members, and polling or waiting on PID 1 exit.
3. An initially empty mount namespace (CLONE_EMPTY_MNTNS) populated
directly in its target user namespace before going live, without
inheriting host mounts or cloning staged trees, while still allowing
new mounts to be attached at runtime.
Work on this feature started in 2025 from David Howells' container object
patch set [1], which I turned into a namespace for namespace roots and
rebuilt around that premise.
While the patch set is manually written, the original motivation came
from isolating LLM agents. Running untrusted agent workloads made it
clear that OCI runtimes need to minimize their live configuration
surface.
Assembling mounts, credentials, and namespaces inside helper processes
with a half-configured container is what I see as the main challenge,
and the existential debate around namespaces and container objects is an
unfocused discussion topic.
[1] https://lore.kernel.org/all/155059610368.17079.2220554006494174417.stgit@xxxxxxxxxxxxxxxxxxxxxx/
IMPLEMENTATION
==============
rootns_create() allocates a rootns instance backed by a pollable
anonymous inode fd, creating a fresh owning user namespace and a full set
of detached namespaces: empty mount (CLONE_EMPTY_MNTNS), PID, UTS, IPC,
network, cgroup, and time. ioctl(rootnsfd, ROOTNS_GET_NSFD, nstype)
returns nsfs file descriptors for individual member namespaces when
standalone namespace operations are needed.
Superblocks are configured directly in the target user namespace via
fsopen(), FSCONFIG_SET_ROOTNS, and fsmount(), allowing unprivileged
callers to assemble FS_USERNS_MOUNT filesystems without holding
CAP_SYS_ADMIN in their own user namespace or entering the target user
namespace first. move_mount(..., MOVE_MOUNT_T_MNTNS) operates on any
non-anonymous mount namespace fd: on an empty mount namespace it installs
"/" onto the nullfs root once, and it attaches relative submounts both
before entry and into live mount namespaces.
Once "/" is installed, processes are spawned into the rootns via clone3()
with CLONE_INTO_ROOTNS and struct clone_args.rootns, without mutating the
caller in place. Pairing CLONE_INTO_ROOTNS with CLONE_VM | CLONE_VFORK
and opening the target binary via openat2(..., RESOLVE_IN_ROOT) on the
retained "/" mount fd allows spawning with execveat() without copying
page tables.
The first entrant becomes PID 1; once it exits and
zap_pid_ns_processes() reaps all members, poll() reports EPOLLHUP and
rootns_wait() returns init's exit status and rusage. rootns_kill() walks
pid_ns->idr under tasklist_lock to signal member thread groups.
CHANGES
=======
v3:
- The patch set size increased predominantly because the coverage of
kselftest had to widened to cover the introduced changes.
- Replace MOVE_MOUNT_T_ROOTNS_ROOT with MOVE_MOUNT_T_MNTNS targeting
mnt_ns nsfs fds, and add ioctl(ROOTNS_GET_NSFD) to open member
namespace fds (Andy Lutomirski).
- Allow unprivileged fsopen(), FSCONFIG_SET_ROOTNS, and fsmount() to
configure and mount FS_USERNS_MOUNT filesystems directly in the target
user namespace without entering it first (Andy Lutomirski).
- Fix locking, refcounting, credential/dumpability/timens setup,
pivot_root() lookup, and cross-userns mount checks across copy_rootns(),
CLONE_INTO_ROOTNS, rootns_kill(), FSCONFIG_SET_ROOTNS, and move_mount()
(Sashiko).
- Mark PowerPC rootns syscalls nospu (Sashiko).
- Update documentation and kselftests.
v2:
- Drop rootns provenance tracking (rootns_id and rootns_may_setns()) and
rely on user_namespace ownership for setns() isolation (Andy
Lutomirski).
- Replace the rootns_enter() system call with clone3(CLONE_INTO_ROOTNS)
and struct clone_args.rootns (CLONE_ARGS_SIZE_VER3), allowing
CLONE_VM | CLONE_VFORK and compatible per-child clone3() flags (Andy
Lutomirski).
- Drop the spurious task_no_new_privs() check in may_enter_rootns_creds()
(Andy Lutomirski).
- Update documentation, Kconfig, syscall tables, and kselftests for
CLONE_INTO_ROOTNS.
VERSIONS
========
v2: https://lore.kernel.org/linux-fsdevel/20261117231352.3816603-1-jarkko@xxxxxxxxxx/
v1: https://lore.kernel.org/linux-fsdevel/20261117050841.3289652-1-jarkko@xxxxxxxxxx/
Cc: linux-api@xxxxxxxxxxxxxxx
Cc: linux-doc@xxxxxxxxxxxxxxx
Cc: linux-fsdevel@xxxxxxxxxxxxxxx
Cc: linux-kernel@xxxxxxxxxxxxxxx
Cc: linux-kselftest@xxxxxxxxxxxxxxx
Cc: linux-mm@xxxxxxxxx
Cc: linux-security-module@xxxxxxxxxxxxxxx
Cc: Alexander Viro <viro@xxxxxxxxxxxxxxxxxx>
Cc: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
Cc: Andy Lutomirski <luto@xxxxxxxxxxxxxx>
Cc: Anna-Maria Behnsen <anna-maria@xxxxxxxxxxxxx>
Cc: Ben Segall <bsegall@xxxxxxxxxx>
Cc: Christian Brauner <brauner@xxxxxxxxxx>
Cc: David Hildenbrand <david@xxxxxxxxxx>
Cc: David Howells <dhowells@xxxxxxxxxx>
Cc: Davidlohr Bueso <dave@xxxxxxxxxxxx>
Cc: Dietmar Eggemann <dietmar.eggemann@xxxxxxx>
Cc: Frederic Weisbecker <frederic@xxxxxxxxxx>
Cc: Ingo Molnar <mingo@xxxxxxxxxx>
Cc: Jan Kara <jack@xxxxxxx>
Cc: Jarkko Sakkinen <jarkko@xxxxxxxxxx>
Cc: John Johansen <john.johansen@xxxxxxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Juri Lelli <juri.lelli@xxxxxxxxxx>
Cc: Kees Cook <kees@xxxxxxxxxx>
Cc: K Prateek Nayak <kprateek.nayak@xxxxxxx>
Cc: "Liam R. Howlett" <liam@xxxxxxxxxxxxx>
Cc: Lorenzo Stoakes <ljs@xxxxxxxxxx>
Cc: Manfred Spraul <manfred@xxxxxxxxxxxxxxxx>
Cc: Mel Gorman <mgorman@xxxxxxx>
Cc: Michal Hocko <mhocko@xxxxxxxx>
Cc: Mike Rapoport <rppt@xxxxxxxxxx>
Cc: Neal Gompa <neal@xxxxxxxxx>
Cc: Paul Moore <paul@xxxxxxxxxxxxxx>
Cc: Pavel Tikhomirov <ptikhomirov@xxxxxxxxxxxxx>
Cc: Peter Zijlstra <peterz@xxxxxxxxxxxxx>
Cc: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Cc: Serge Hallyn <sergeh@xxxxxxxxxx>
Cc: Shuah Khan <skhan@xxxxxxxxxxxxxxxxxxx>
Cc: Steven Rostedt <rostedt@xxxxxxxxxxx>
Cc: Suren Baghdasaryan <surenb@xxxxxxxxxx>
Cc: Thomas Gleixner <tglx@xxxxxxxxxx>
Cc: Valentin Schneider <vschneid@xxxxxxxxxx>
Cc: Vincent Guittot <vincent.guittot@xxxxxxxxxx>
Cc: Vincenzo Frascino <vincenzo.frascino@xxxxxxx>
Cc: Vlastimil Babka <vbabka@xxxxxxxxxx>
Cc: Zygmunt Krynicki <zygmunt.krynicki@xxxxxxxxxxxxx>
Jarkko Sakkinen (13):
nsproxy: Pass nsproxy to create_new_namespaces()
rootns: Add core infrastructure for root namespaces
rootns: Track init lifecycle via copy_process() and pid_namespace
rootns: Add rootns_create() system call
rootns: Add rootns_wait() system call
rootns: Add rootns_kill() system call
fork: Support CLONE_INTO_ROOTNS in clone3()
fs: Support FSCONFIG_SET_ROOTNS in fsconfig()
fs: Support MOVE_MOUNT_T_MNTNS in move_mount()
arch: Wire up rootns system calls
docs: Document root namespace uAPI
selftests/rootns: Add root namespace test suite
MAINTAINERS: Add entry for ROOT NAMESPACE
Documentation/userspace-api/index.rst | 1 +
.../userspace-api/ioctl/ioctl-number.rst | 1 +
Documentation/userspace-api/rootns.rst | 47 +
MAINTAINERS | 11 +
arch/alpha/kernel/syscalls/syscall.tbl | 3 +
arch/arm/tools/syscall.tbl | 3 +
arch/arm64/tools/syscall_32.tbl | 3 +
arch/m68k/kernel/syscalls/syscall.tbl | 3 +
arch/microblaze/kernel/syscalls/syscall.tbl | 3 +
arch/mips/kernel/syscalls/syscall_n32.tbl | 3 +
arch/mips/kernel/syscalls/syscall_n64.tbl | 3 +
arch/mips/kernel/syscalls/syscall_o32.tbl | 3 +
arch/parisc/kernel/syscalls/syscall.tbl | 3 +
arch/powerpc/kernel/syscalls/syscall.tbl | 3 +
arch/s390/kernel/syscalls/syscall.tbl | 3 +
arch/sh/kernel/syscalls/syscall.tbl | 3 +
arch/sparc/kernel/syscalls/syscall.tbl | 3 +
arch/x86/entry/syscalls/syscall_32.tbl | 3 +
arch/x86/entry/syscalls/syscall_64.tbl | 3 +
arch/xtensa/kernel/syscalls/syscall.tbl | 3 +
fs/filesystems.c | 15 +
fs/fs_context.c | 20 +-
fs/fsopen.c | 121 +-
fs/internal.h | 6 +
fs/namespace.c | 245 ++-
fs/nsfs.c | 64 +
fs/proc/root.c | 18 +
include/linux/compat.h | 4 +
include/linux/cred.h | 4 +-
include/linux/fs_context.h | 5 +
include/linux/mnt_namespace.h | 2 +
include/linux/nsfs.h | 2 +
include/linux/nsproxy.h | 9 +-
include/linux/pid_namespace.h | 4 +
include/linux/rootns.h | 91 +
include/linux/sched/task.h | 8 +
include/linux/syscalls.h | 4 +
include/linux/time_namespace.h | 21 +
include/linux/user_namespace.h | 7 +
include/uapi/asm-generic/unistd.h | 10 +-
include/uapi/linux/mount.h | 4 +-
include/uapi/linux/rootns.h | 44 +
include/uapi/linux/sched.h | 5 +
init/Kconfig | 9 +
ipc/mqueue.c | 13 +
kernel/Makefile | 2 +
kernel/cred.c | 31 +-
kernel/fork.c | 97 +-
kernel/nsproxy.c | 44 +-
kernel/pid_namespace.c | 2 +
kernel/rootns.c | 609 ++++++
kernel/sys_ni.c | 6 +
kernel/time/namespace_vdso.c | 8 +
kernel/user_namespace.c | 12 +-
scripts/syscall.tbl | 3 +
tools/testing/selftests/Makefile | 1 +
tools/testing/selftests/rootns/.gitignore | 2 +
tools/testing/selftests/rootns/Makefile | 5 +
tools/testing/selftests/rootns/config | 10 +
tools/testing/selftests/rootns/smoke.c | 1934 +++++++++++++++++
60 files changed, 3529 insertions(+), 80 deletions(-)
create mode 100644 Documentation/userspace-api/rootns.rst
create mode 100644 include/linux/rootns.h
create mode 100644 include/uapi/linux/rootns.h
create mode 100644 kernel/rootns.c
create mode 100644 tools/testing/selftests/rootns/.gitignore
create mode 100644 tools/testing/selftests/rootns/Makefile
create mode 100644 tools/testing/selftests/rootns/config
create mode 100644 tools/testing/selftests/rootns/smoke.c
--
2.47.3