# Re: \[RFC PATCH v3 00/13\] Namespace for namespace roots

- From: Jarkko Sakkinen \<jarkko@kernel.org\>
- Date: 2026-11-18 21:22:56 
- List: linux-api
- Page: https://ratatoskr.run/linux-api/2026/11/17971012
- Thread: https://ratatoskr.run/linux-api/2026/11/17968274/t.md

```text
On Wed, Nov 18, 2026 at 10:42:15PM +0200, Jarkko Sakkinen wrote:
> On Wed, Nov 18, 2026 at 09:54:32PM +0200, Jarkko Sakkinen wrote:
> > On Wed, Nov 18, 2026 at 09:35:26PM +0200, Jarkko Sakkinen wrote:
> > > 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@warthog.procyon.org.uk/
> > > 
> > > 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.
> > 
> > I.e. before PID 1 and /proc/<pid>/ns/* existss, nsfd for namespace other
> > than root nsfd can be acquired as follows:
> > 
> > 	int mnts_fd = ioctl(root_fd, ROOTNS_GET_NSFD, CLONE_NEWNS);
> 
> 
> Unprivileged caller becomes the owner of rootns->user_ns. Each mount
> syscall then just checks CAP_SYS_ADMIN against rootns->user_ns.
> 
> The user space wiring goes along the lines of:
> 
>         int root_fd = rootns_create(ROOTNS_KILL_ON_CLOSE | ROOTNS_CLOSE_ON_EXEC);
>         int mntns_fd = ioctl(root_fd, ROOTNS_GET_NSFD, CLONE_NEWNS);
> 
>         int tmpfs_fd = fsopen("tmpfs", 0);
>         fsconfig(tmpfs_fd, FSCONFIG_SET_ROOTNS, NULL, NULL, root_fd);
>         fsconfig(tmpfs_fd, FSCONFIG_CMD_CREATE, NULL, NULL, 0);
>         int rootfs_fd = fsmount(tmpfs_fd, 0, 0);
> 
>         move_mount(rootfs_fd, "", mntns_fd, "/", MOVE_MOUNT_F_EMPTY_PATH | MOVE_MOUNT_T_MNTNS);
> 
>         struct clone_args args = {
>                 .flags  = CLONE_INTO_ROOTNS,
>                 .rootns = root_fd,
>         };
>         pid_t pid = clone3(&args, sizeof(args));
> 
> Note that example is uncompiled :-)
> 
> This example makes me feel that perhaps RootNS is not the best possible
> name for this but this rather should be e.g., NullNS?

Before judging this, keep in mind that I've not just suddenly invented
this. I first encountered the topic when David posted his patches, and
felt that they were a bit unfairly judged.

Somewhere at 2025 David rebased his branch when I asked, and slow-cooked
the result that we're seeing during a period of 1.5 years. It has not
been a priority topic at work so this has been more like a spare time
sudoku.

So if you count the David's original patch set version, this has
history spanning since 2017.

Br, Jarkko
```
