RFC Namespace for namespace roots
Get series with b4
b4 am [email protected]Versions newest first · linked by author and title
- v2 RFC Latest13 patches 0 repliesNew
- v1 RFC13 patches 7 repliesSuperseded
Changes in v2 from the cover letter
- 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.
Patches in v2 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/13 | nsproxy: Pass nsproxy to create_new_namespaces()include/ kernel/ | +21 | 0 replies | |
| 2/13 | rootns: Add core infrastructure for root namespacesinclude/ include/ init/ +2 more | +222 | 0 replies | |
| 3/13 | rootns: Track init lifecycle via copy_process() and pid_namespaceinclude/ include/ kernel/ +2 more | +60 | 0 replies | |
| 4/13 | rootns: Add rootns_create() system callinclude/ kernel/ kernel/ | +143 | 0 replies | |
| 5/13 | rootns: Add rootns_wait() system callinclude/ include/ kernel/ +1 more | +113 | 0 replies | |
| 6/13 | rootns: Add rootns_kill() system callinclude/ kernel/ kernel/ | +67 | 0 replies | |
| 7/13 | fork: Support CLONE_INTO_ROOTNS in clone3()include/ include/ include/ +6 more | +288 | 0 replies | |
| 8/13 | fs: Support FSCONFIG_SET_ROOTNS in fsconfig()fs/ fs/ include/ +2 more | +101 | 0 replies | |
| 9/13 | fs: Support installing rootns mount trees via move_mount()fs/ include/ | +157 | 0 replies | |
| 10/13 | arch: Wire up rootns system callsarch/ arch/ arch/ +15 more | +60 | 0 replies | |
| 11/13 | docs: Document root namespace uAPIDocumentation/ Documentation/ | +41 | 0 replies | |
| 12/13 | selftests/rootns: Add root namespace test suitetools/ tools/ tools/ +2 more | +1398 | 0 replies | |
| 13/13 | MAINTAINERS: Add entry for ROOT NAMESPACEMAINTAINERS | +11 | 0 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.
Cover letter [RFC PATCH v2 00/13] Namespace for namespace roots
OVERVIEW
========
A root namespace (rootns) is a kernel object backed by a file descriptor that binds together:
1. A full or partial set of detached namespaces.
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) that must be populated before going live, without inheriting host mount-tree ancestors.
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@warthog.procyon.org.uk/
IMPLEMENTATION
==============
rootns_create() allocates a rootns instance backed by a pollable anonymous inode fd, pinning dedicated empty mount (CLONE_EMPTY_MNTNS) and PID namespaces along with any optional namespaces selected in flags.
Before entry, userspace populates the mount tree through the control fd:FSCONFIG_SET_ROOTNS binds a newly opened fs_context to the target rootns, and move_mount(..., MOVE_MOUNT_T_ROOTNS_ROOT) installs "/" onto the nullfs root once (transitioning the rootns to ROOTNS_READY) and attaches relative submounts beneath it.
Processes are spawned into a ready 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 RCU to signal member thread groups.
CHANGES
=======
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
========
v1: https://lore.kernel.org/linux-fsdevel/[email protected]/
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 installing rootns mount trees via 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 + Documentation/userspace-api/rootns.rst | 40 + 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/fsopen.c | 76 +- fs/namespace.c | 178 ++- fs/proc/root.c | 13 + include/linux/compat.h | 4 + include/linux/cred.h | 4 +- include/linux/fs_context.h | 3 + include/linux/nsproxy.h | 9 +- include/linux/pid_namespace.h | 4 + include/linux/rootns.h | 92 ++ include/linux/sched/task.h | 8 + include/linux/syscalls.h | 4 + include/uapi/asm-generic/unistd.h | 10 +- include/uapi/linux/mount.h | 4 +- include/uapi/linux/rootns.h | 38 + include/uapi/linux/sched.h | 5 + init/Kconfig | 9 + ipc/mqueue.c | 12 + kernel/Makefile | 2 + kernel/cred.c | 70 +- kernel/fork.c | 67 +- kernel/nsproxy.c | 41 +- kernel/pid_namespace.c | 2 + kernel/rootns.c | 593 ++++++++ kernel/sys_ni.c | 6 + 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 | 9 + tools/testing/selftests/rootns/smoke.c | 1381 +++++++++++++++++++ 49 files changed, 2680 insertions(+), 75 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