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

- From: Jarkko Sakkinen \<jarkko@kernel.org\>
- Date: 2026-11-18 20:42:14 
- List: linux-api
- Page: https://ratatoskr.run/linux-api/2026/11/17969987
- Thread: https://ratatoskr.run/linux-api/2026/11/17968274/t.md

```text
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?

Br, Jarkko
```
