From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=100.103.45.18 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1795219736; b=iTfOkcUfotAgP2ENmJtQLb68tjdgZzY181jY95rDyxjVPzCLJ/mvSaEy0xeN91ySxEFU 8FpMMaRXXbl41zpsXdOxVEknF3REkhjLGhr4sj/H/AIHi7JABv9dcqgqlRsBcdpWfX28b XeeYZUnJeIh6sqtsl6ZcmurvqtCj5PIyk0AOvI+it/SHPEWp2Zq6Uvn69V3L884vWnOEt 0DSHqUQfl6pNa9ZG+4Ffa9B34XkHyGJJsw+AOUuMoD9Fa2XMWmjKp4LnYIXodsxassjKW Kv9v6ASRSelnmI1PSwuTMsvxJGd0iXCr9Mo5kQICVOiYGqZmbfhpTzszVnDj/GCG8zg== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1795219736; h=Received:DKIM-Signature:From:To:Cc:Subject:Date:Message-ID:X-Mailer: MIME-Version:Content-Transfer-Encoding; bh=1uAsKefbzilc6PMu577PfNWiDJqL44RmMPtTEi72U3A=; b=1MpM/oNLQmBT2mG6BrZ+cZh5kRcnHn0Qjvr+wJce8No5O+KPeqZb7bBKe5ZbuFylgk5A UR9ctZnnFMOvTLjhPzixawh35LKlSMdwTiGRPP3QmhKJDH4hAb8Nlr37Dj2WUrkS6yqoZ frF7YjNz5sdgZgpsyJ4o/bTIRAlSTGeRuEUBRhX9N9wwEvl8+U7lAYpwUEZ750xKuY7J5 0BQ9Jgd+3TFcXan1PkvD//CYv4ZDqDwSASn1rrPL5e1E3XSk7YBA6LfkvOeTSgPHVUPpl 1ZqRP6BhZr/iZJZuXiD/QBVuD4qm8SPGRU1RH9mqPNzYisvlDBOtYPBEAjNWjSFqsXQ== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256 header.s=k20260515 header.b=Qy+nfG9k; arc=none smtp.remote-ip=100.103.45.18 Received: from smtp.kernel.org (quasi.space.kernel.org [100.103.45.18]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (prime256v1)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with UTF8SMTPS id 38A25606A69C; Sat, 21 Nov 2026 00:08:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256 header.s=k20260515 header.b=Qy+nfG9k Received: by smtp.kernel.org (Postfix) with UTF8SMTPSA id F29591F000C0; Sat, 21 Nov 2026 00:08:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1795219735; bh=1uAsKefbzilc6PMu577PfNWiDJqL44RmMPtTEi72U3A=; h=From:To:Cc:Subject:Date; b=Qy+nfG9kndsGCWByIvx1D1qx5JMhbSigttGOpcfYj//YpOKAKVZXZGl+6zNKVzgws HdcUIlX1NWuRqUuo5jcF3521ZG5+P4mHk+xULIs0qrUb3OHyJRhwF/Spy/ArdB9Feb EipXNfNxnaQ+062S2zkRQRIxhQ8qddaUeBJ5a2MHpQVXbBQFi915KNLNhpWOhq80Iq ZabN8IZPjmZKM4qqzAN4jTIXyVIj8vPnp2u2vLY+cm6oyAWuqsmrjCsw3xveIMq5yz r3yLERHoO/2Zg8UHXnIY+/BZGAZasDl0BUpF2nLfv6GMAvMu9+eYljXdKmTs0Ke4Uv uj5V45q7TNajw== From: Jarkko Sakkinen To: linux-fsdevel@vger.kernel.org Cc: Jarkko Sakkinen , linux-api@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kselftest@vger.kernel.org, linux-mm@kvack.org, linux-security-module@vger.kernel.org, Alexander Mikhalitsyn , Alexander Viro , Andy Lutomirski , Christian Brauner , David Howells , Jan Kara , Jonathan Corbet , Josef Bacik , Kees Cook , Neal Gompa , Paul Moore , Serge Hallyn , Zygmunt Krynicki Subject: [RFC PATCH v5 00/25] rootns: fd-bound process closures Date: Sat, 21 Nov 2026 02:08:19 +0200 Message-ID: <20261121000844.1863324-1-jarkko@kernel.org> X-Mailer: git-send-email 2.47.3 X-Mailing-List: linux-api@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Transfer-Encoding: 8bit OVERVIEW ======== A rootns is an anonymous-inode control object (not an nsfs namespace itself) with separate build and live phases 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 ============== Standalone fd-based namespace configuration (patches 01-07) decouples user and mount namespace setup from live helper tasks. userns_set_idmap() atomically configures setgroups policy and UID, GID, and project ID mappings on a CLONE_NEWUSER nsfs fd, checking current_cred() so an unprivileged creator can delegate the fd via SCM_RIGHTS to a privileged mapping daemon. 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, attaches relative submounts both before entry and into live mount namespaces, and supports MOVE_MOUNT_CLONE for recursive bind mounts without OPEN_TREE_CLONE. rootns() 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. 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_VFORK and opening the target binary via openat2(..., RESOLVE_IN_ROOT) on the retained "/" mount fd allows spawning with execveat() directly into the target root. The first entrant becomes PID 1; once it exits and zap_pid_ns_processes() reaps all members, poll() reports EPOLLHUP and ioctl(rootnsfd, ROOTNS_WAIT, &args) returns init's exit status. ioctl(rootnsfd, ROOTNS_KILL, sig) walks pid_ns->idr under tasklist_lock to signal member thread groups, and dedicated LSM hooks mediate rootns allocation, teardown, process entry, and signal delivery. HOTPLUG ======= 1. Host creates rootns(). 2. Host sets uid/gid maps with userns_set_idmap(). 3. Host populates "/" with MOVE_MOUNT_T_MNTNS, optionally combined with MOVE_MOUNT_CLONE for bind mounts. 4. Host spawns PID 1 with clone3(CLONE_INTO_ROOTNS) (optionally passing an AF_UNIX socketpair fd for communication). 5. PID 1 watches /proc/self/ns/mnt via fanotify(FAN_REPORT_MNT | FAN_MARK_MNTNS, FAN_MNT_ATTACH) or polls /proc/self/mountinfo. 6. On hotplug, host mounts the filesystem via fsopen()/fsmount() (plus optional MOUNT_ATTR_IDMAP). 7. Host creates the mountpoint with openat2(RESOLVE_IN_ROOT) + mkdirat() and attaches the mount with MOVE_MOUNT_T_MNTNS. 8. PID 1 receives FAN_MNT_ATTACH and queries the new mount via statmount(). CHANGES ======= v5: - Heavy reduction of cc-list. More added by request. - Re-slice the patch set into standalone fd-based user and mount namespace configuration (01-07) followed by rootns (08-25), and split proc, ipc/mqueue, and bpf_lsm changes into separate commits. - Add userns_set_idmap() system call to atomically configure setgroups and UID, GID, and project ID mappings on CLONE_NEWUSER nsfs fds without /proc//*_map, checking current_cred() so unprivileged userns fds can be delegated via SCM_RIGHTS to a privileged mapping daemon (Andy Lutomirski). - Add MOVE_MOUNT_CLONE with MOVE_MOUNT_T_MNTNS in move_mount() to recursively bind-clone host mount subtrees into a target mount namespace fd without OPEN_TREE_CLONE. - Clarify in overview and uAPI documentation that rootns is an anonymous-inode control object rather than an nsfs namespace. - Fix upfront pidns ancestry check in ROOTNS_WAIT, bootstrap -EINVAL preservation in CLONE_INTO_ROOTNS, FSCONFIG_SET_ROOTNS user_ns delegation and fsmount() rootns_bound/seq_origin handling, proc pidns= mount option override check, cross-userns anonymous mount MNT_LOCKED propagation, and selftest wide-arch _IOC_NONE, socket blocking, and cleanup handling (Sashiko). - Extend selftests/rootns with userns_set_idmap(), SCM_RIGHTS delegation, MOVE_MOUNT_CLONE, and hotplug mount coverage. v4: - A single syscall API (and shenanigans e.g., in fsconfig). - I use a similar API model as I used in SGX driver, as like enclaves, containers are "closures". Instead of /dev/sgx_enclave like device file, anon inode is used. - Consolidate rootns_create(), rootns_wait(), and rootns_kill() into a single rootns() system call plus ROOTNS_WAIT and ROOTNS_KILL ioctls, dropping rusage from ROOTNS_WAIT. - LSM: lbs_rootns security blob management and security_rootns_alloc(), security_rootns_free(), security_rootns_clone(), and security_rootns_kill() LSM hooks wired into bpf_lsm. - Disallow CLONE_VM with CLONE_INTO_ROOTNS across time namespaces, require CAP_SYS_CHROOT, preserve caller umask, reset dumpability on user namespace transitions, and fix ROOTNS_WAIT, FSCONFIG_SET_ROOTNS, fsmount(), and MOVE_MOUNT_T_MNTNS locking and permission checks (Sashiko). - Rewrite selftests/rootns in Python. I used similar structure as I've used in selftests/tpm2. This "along the lines" mimics Cells style container manager. Rootns is a quite typical no policy solution and Cells is a managed solution, and they are at the far ends, which can also be witnessed from the patch set sizes. The question really is where we want to draw the borderline. I'm neither favoring nor supporting any possible solution because I don't know. I'm just saying where they live as a software stack. - Update documentation and architecture syscall tables for rootns(). 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 ======== v4: https://lore.kernel.org/linux-fsdevel/20261119224312.1037966-1-jarkko@kernel.org/ v3: https://lore.kernel.org/linux-fsdevel/20261118193539.240065-1-jarkko@kernel.org/ v2: https://lore.kernel.org/linux-fsdevel/20261117231352.3816603-1-jarkko@kernel.org/ v1: https://lore.kernel.org/linux-fsdevel/20261117050841.3289652-1-jarkko@kernel.org/ Cc: linux-api@vger.kernel.org Cc: linux-doc@vger.kernel.org Cc: linux-fsdevel@vger.kernel.org Cc: linux-kernel@vger.kernel.org Cc: linux-kselftest@vger.kernel.org Cc: linux-mm@kvack.org Cc: linux-security-module@vger.kernel.org Cc: Alexander Mikhalitsyn Cc: Alexander Viro Cc: Andy Lutomirski Cc: Christian Brauner Cc: David Howells Cc: Jan Kara Cc: Jonathan Corbet Cc: Josef Bacik Cc: Kees Cook Cc: Neal Gompa Cc: Paul Moore Cc: Serge Hallyn Cc: Zygmunt Krynicki Jarkko Sakkinen (25): userns: Factor out idmap validation and commit helpers userns: Add userns_set_idmap() system call arch: Wire up userns_set_idmap() system call mount: Add mnt_ns_get_root() mount: Enforce mount_too_revealing() for foreign mntns mount: Support MOVE_MOUNT_T_MNTNS in move_mount() mount: Support MOVE_MOUNT_CLONE with MOVE_MOUNT_T_MNTNS userns: Factor out install_user_ns_cred() nsfs: Add nsproxy_open_namespace() 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() system call rootns: Add ROOTNS_WAIT ioctl rootns: Add ROOTNS_KILL ioctl fork: Support CLONE_INTO_ROOTNS in clone3() fs: Support FSCONFIG_SET_ROOTNS in fsconfig() proc: Implement ->set_rootns() fs_context operation ipc/mqueue: Implement ->set_rootns() fs_context operation security: Add rootns LSM hooks bpf: Register rootns LSM hooks arch: Wire up rootns() system call 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 | 65 + MAINTAINERS | 11 + arch/alpha/kernel/syscalls/syscall.tbl | 2 + arch/arm/tools/syscall.tbl | 2 + arch/arm64/tools/syscall_32.tbl | 2 + arch/m68k/kernel/syscalls/syscall.tbl | 2 + arch/microblaze/kernel/syscalls/syscall.tbl | 2 + arch/mips/kernel/syscalls/syscall_n32.tbl | 2 + arch/mips/kernel/syscalls/syscall_n64.tbl | 2 + arch/mips/kernel/syscalls/syscall_o32.tbl | 2 + arch/parisc/kernel/syscalls/syscall.tbl | 2 + arch/powerpc/kernel/syscalls/syscall.tbl | 2 + arch/s390/kernel/syscalls/syscall.tbl | 2 + arch/sh/kernel/syscalls/syscall.tbl | 2 + arch/sparc/kernel/syscalls/syscall.tbl | 2 + arch/x86/entry/syscalls/syscall_32.tbl | 2 + arch/x86/entry/syscalls/syscall_64.tbl | 2 + arch/xtensa/kernel/syscalls/syscall.tbl | 2 + fs/devpts/inode.c | 2 + fs/filesystems.c | 15 + fs/fs_context.c | 21 +- fs/fsopen.c | 140 +- fs/internal.h | 6 + fs/namespace.c | 348 +++- fs/nsfs.c | 64 + fs/proc/root.c | 22 + include/linux/cred.h | 4 +- include/linux/fs_context.h | 6 + include/linux/lsm_hook_defs.h | 7 + include/linux/lsm_hooks.h | 3 + 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 | 93 + include/linux/sched/task.h | 8 + include/linux/security.h | 30 + include/linux/syscalls.h | 5 + include/linux/time_namespace.h | 13 + include/linux/user_namespace.h | 7 + include/uapi/asm-generic/unistd.h | 10 +- include/uapi/linux/mount.h | 5 +- include/uapi/linux/nsfs.h | 53 + include/uapi/linux/rootns.h | 83 + include/uapi/linux/sched.h | 5 + init/Kconfig | 9 + ipc/mqueue.c | 13 + kernel/Makefile | 2 + kernel/bpf/bpf_lsm.c | 10 + kernel/cred.c | 32 +- kernel/fork.c | 95 +- kernel/nsproxy.c | 41 +- kernel/pid_namespace.c | 2 + kernel/rootns.c | 588 ++++++ kernel/sys_ni.c | 4 + kernel/user_namespace.c | 420 ++++- scripts/syscall.tbl | 2 + security/lsm_init.c | 6 + security/security.c | 86 + tools/testing/selftests/Makefile | 1 + tools/testing/selftests/rootns/Makefile | 5 + tools/testing/selftests/rootns/config | 10 + .../testing/selftests/rootns/rootns_cells.py | 1400 ++++++++++++++ tools/testing/selftests/rootns/rootns_test.py | 1645 +++++++++++++++++ tools/testing/selftests/rootns/test_smoke.sh | 10 + 67 files changed, 5286 insertions(+), 172 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/Makefile create mode 100644 tools/testing/selftests/rootns/config create mode 100755 tools/testing/selftests/rootns/rootns_cells.py create mode 100755 tools/testing/selftests/rootns/rootns_test.py create mode 100755 tools/testing/selftests/rootns/test_smoke.sh -- 2.47.3