Skip to content

RFC Namespace for namespace roots

Jarkko Sakkinen linux-api linux-doc linux-fsdevel linux-kselftest linux-mm linux-security-module lkml 2 versions New

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v2 RFC Latest13 patches 0 repliesNew
  2. 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 filesSizeRepliesApplied
1/13nsproxy: Pass nsproxy to create_new_namespaces()include/linux/nsproxy.h kernel/nsproxy.c+21 -160 replies
2/13rootns: Add core infrastructure for root namespacesinclude/linux/rootns.h include/uapi/linux/rootns.h init/Kconfig +2 more+222 -00 replies
3/13rootns: Track init lifecycle via copy_process() and pid_namespaceinclude/linux/pid_namespace.h include/linux/rootns.h kernel/fork.c +2 more+60 -00 replies
4/13rootns: Add rootns_create() system callinclude/linux/syscalls.h kernel/rootns.c kernel/sys_ni.c+143 -00 replies
5/13rootns: Add rootns_wait() system callinclude/linux/compat.h include/linux/syscalls.h kernel/rootns.c +1 more+113 -00 replies
6/13rootns: Add rootns_kill() system callinclude/linux/syscalls.h kernel/rootns.c kernel/sys_ni.c+67 -00 replies
7/13fork: Support CLONE_INTO_ROOTNS in clone3()include/linux/cred.h include/linux/nsproxy.h include/linux/rootns.h +6 more+288 -320 replies
8/13fs: Support FSCONFIG_SET_ROOTNS in fsconfig()fs/fsopen.c fs/proc/root.c include/linux/fs_context.h +2 more+101 -40 replies
9/13fs: Support installing rootns mount trees via move_mount()fs/namespace.c include/uapi/linux/mount.h+157 -240 replies
10/13arch: Wire up rootns system callsarch/alpha/kernel/syscalls/syscall.tbl arch/arm/tools/syscall.tbl arch/arm64/tools/syscall_32.tbl +15 more+60 -10 replies
11/13docs: Document root namespace uAPIDocumentation/userspace-api/index.rst Documentation/userspace-api/rootns.rst+41 -00 replies
12/13selftests/rootns: Add root namespace test suitetools/testing/selftests/Makefile tools/testing/selftests/rootns/.gitignore tools/testing/selftests/rootns/Makefile +2 more+1398 -00 replies
13/13MAINTAINERS: Add entry for ROOT NAMESPACEMAINTAINERS+11 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.

Read the v2 thread

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]/

Cc Alexander Viro <[email protected]>
Cc Andrew Morton <[email protected]>
Cc Andy Lutomirski <[email protected]>
Cc Ben Segall <[email protected]>
Cc Christian Brauner <[email protected]>
Cc David Hildenbrand <[email protected]>
Cc David Howells <[email protected]>
Cc Davidlohr Bueso <[email protected]>
Cc Dietmar Eggemann <[email protected]>
Cc Ingo Molnar <[email protected]>
Cc Jan Kara <[email protected]>
Cc Jarkko Sakkinen <[email protected]>
Cc Jonathan Corbet <[email protected]>
Cc John Johansen <[email protected]>
Cc Juri Lelli <[email protected]>
Cc Kees Cook <[email protected]>
Cc K Prateek Nayak <[email protected]>
Cc "Liam R. Howlett" <[email protected]>
Cc Lorenzo Stoakes <[email protected]>
Cc Manfred Spraul <[email protected]>
Cc Mel Gorman <[email protected]>
Cc Michal Hocko <[email protected]>
Cc Mike Rapoport <[email protected]>
Cc Neal Gompa <[email protected]>
Cc Paul Moore <[email protected]>
Cc Pavel Tikhomirov <[email protected]>
Cc Peter Zijlstra <[email protected]>
Cc Randy Dunlap <[email protected]>
Cc Serge Hallyn <[email protected]>
Cc Shuah Khan <[email protected]>
Cc Steven Rostedt <[email protected]>
Cc Suren Baghdasaryan <[email protected]>
Cc Valentin Schneider <[email protected]>
Cc Vincent Guittot <[email protected]>
Cc Vlastimil Babka <[email protected]>
Cc Zygmunt Krynicki <[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