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=1795030592; b=A/Zop2pr3GjSLpQwLp391GnDnLn2j4zudrPkMQ+TDfUIRPKwieMLq9zuVoBOSt/obmUU yYBaQcWlGFrTDTIR3rGA0tLwTgNhF7nUqM2RMQ7zjCRTSEwmqE8UMaicjgodTgMEnM9/x mY5mkWDpLQfnEdpq+y9egGDigWULgmRQhQpbHVVngYBglIGhHFjcIuXYcPfCfF8qrLHV9 Ryb/KCunBHiRyLNjyEYVRVaIfGyXpuM62079KQkW5KYay4AVCReQUmp2gvwOKJeT75mVp K4+ETOT7FFCGWO/KzZCQBP41BTPMm8bDLGS2xI/j5JjjqSDEMk6GUa2lQ2gjXiTgEYw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1795030592; h=Received:DKIM-Signature:From:To:Cc:Subject:Date:Message-ID:X-Mailer: In-Reply-To:References:MIME-Version:Content-Transfer-Encoding; bh=emvb8auKFt8ReD/7cfPOhlXVG+92MMR8s3O3PK6mxX4=; b=PCdfX8/FFziJaDrbX6T1kmN67Jo5rjS96sOO6lU1sDm0fPWjYRdasi17lDHukXy5iSRJ w4q5p3OC1hhZrBF1lRnKPJPMVjriGpT5Qw/v/Fq+iBsQX7MgrZzVnE59MzcWju7x7ZqzA 4HkRMgMIsfPi7HDpwGRro/e1kjVTf816iNSZ7mwcbSR+kemmbbrK21VJSU4DSHflCNIZN 5bP3OHW2htueFBsCO3Hb28rxB62CebnbDBXE9uSawwfrNWspdWIJlLKDco1UHPym4OmF2 Q3wrpD4fMD2kZsxDSWTADyuv62w2a48qMqSJx2lTm0hXMziAwrsXohvqI2C8PDQ7SUA== 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=Rn4NJ9AI; 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 6283D606F256; Wed, 18 Nov 2026 19:36:32 +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=Rn4NJ9AI Received: by smtp.kernel.org (Postfix) with UTF8SMTPSA id 7FD931F000C5; Wed, 18 Nov 2026 19:36:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1795030592; bh=emvb8auKFt8ReD/7cfPOhlXVG+92MMR8s3O3PK6mxX4=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=Rn4NJ9AI6YGF8PVWQXBRv1FiBYfqpDSxzELVRGBk54g25p1QGmG0kbWwjkVW4w2D8 lNzUuvLqiYY70zuklWvAlaaxGRUO2cvanIC+l4rtHSr6wjBsvkeFQH2zeKwkHM/2HR 1E03wIpBV8/JESxYLAq9/dbhxN92LOjVYCvST4kDso8ClYV5rrMrTwrfyh/ubHS4pd 29LnkBtPFVtNdP00rXXeNWtMptKSanngC+X7c0JwyXA6ykEmc4izrUQaAGbXjt3Ifd lmma7UFXxVsvv8DqOK1WIAvb8JCmLv/h9lHWZ8WxweV0E5ESZyMRyrlmlwsmYGXN4M kayuyeKN8AOxA== From: Jarkko Sakkinen To: David Howells Cc: Jarkko Sakkinen , linux-api@vger.kernel.org, linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kselftest@vger.kernel.org, linux-mm@kvack.org, linux-security-module@vger.kernel.org, Alexander Viro , Andrew Morton , Andy Lutomirski , Anna-Maria Behnsen , Ben Segall , Christian Brauner , David Hildenbrand , Davidlohr Bueso , Dietmar Eggemann , Frederic Weisbecker , Ingo Molnar , Jan Kara , John Johansen , Jonathan Corbet , Juri Lelli , Kees Cook , K Prateek Nayak , "Liam R. Howlett" , Lorenzo Stoakes , Manfred Spraul , Mel Gorman , Michal Hocko , Mike Rapoport , Neal Gompa , Paul Moore , Pavel Tikhomirov , Peter Zijlstra , Randy Dunlap , Serge Hallyn , Shuah Khan , Steven Rostedt , Suren Baghdasaryan , Thomas Gleixner , Valentin Schneider , Vincent Guittot , Vincenzo Frascino , Vlastimil Babka , Zygmunt Krynicki Subject: [RFC PATCH v3 11/13] docs: Document root namespace uAPI Date: Wed, 18 Nov 2026 21:35:37 +0200 Message-ID: <20261118193539.240065-12-jarkko@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20261118193539.240065-1-jarkko@kernel.org> References: <20261118193539.240065-1-jarkko@kernel.org> X-Mailing-List: linux-doc@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 Userspace container managers need a clear specification of rootns state transitions, namespace fd ioctls, mount-tree construction, credential rules, and process creation semantics. Add Documentation/userspace-api/rootns.rst to include the kernel-doc sections and system call reference from kernel/rootns.c, include/uapi/linux/rootns.h, fs/fsopen.c, and fs/namespace.c, and register the rootns ioctl magic in ioctl-number.rst. Co-developed-by: David Howells Signed-off-by: David Howells Signed-off-by: Jarkko Sakkinen --- Documentation/userspace-api/index.rst | 1 + .../userspace-api/ioctl/ioctl-number.rst | 1 + Documentation/userspace-api/rootns.rst | 47 +++++++++++++++++++ 3 files changed, 49 insertions(+) create mode 100644 Documentation/userspace-api/rootns.rst diff --git a/Documentation/userspace-api/index.rst b/Documentation/userspace-api/index.rst index a68b1bea57a8..56d0ac4eb087 100644 --- a/Documentation/userspace-api/index.rst +++ b/Documentation/userspace-api/index.rst @@ -17,6 +17,7 @@ System calls :maxdepth: 1 unshare + rootns futex2 ebpf/index ioctl/index diff --git a/Documentation/userspace-api/ioctl/ioctl-number.rst b/Documentation/userspace-api/ioctl/ioctl-number.rst index dbe462040999..d8dc926ea283 100644 --- a/Documentation/userspace-api/ioctl/ioctl-number.rst +++ b/Documentation/userspace-api/ioctl/ioctl-number.rst @@ -385,6 +385,7 @@ Code Seq# Include File Comments 0xB8 01-02 uapi/misc/mrvl_cn10k_dpi.h Marvell CN10K DPI driver 0xB8 all uapi/linux/mshv.h Microsoft Hyper-V /dev/mshv driver +0xB9 00-0F uapi/linux/rootns.h Root namespace uAPI 0xBA 00-0F uapi/linux/liveupdate.h Pasha Tatashin 0xC0 00-0F linux/usb/iowarrior.h diff --git a/Documentation/userspace-api/rootns.rst b/Documentation/userspace-api/rootns.rst new file mode 100644 index 000000000000..a7724539a9fe --- /dev/null +++ b/Documentation/userspace-api/rootns.rst @@ -0,0 +1,47 @@ +.. SPDX-License-Identifier: GPL-2.0 + +=================== +Root namespace uAPI +=================== + +Overview +======== + +.. kernel-doc:: kernel/rootns.c + :doc: Overview + +Flags +===== + +.. kernel-doc:: include/uapi/linux/rootns.h + :identifiers: rootns_flags + +Ioctls +====== + +.. kernel-doc:: include/uapi/linux/rootns.h + :doc: ROOTNS_GET_NSFD + +System calls +============ + +.. kernel-doc:: kernel/rootns.c + :identifiers: sys_rootns_create sys_rootns_wait sys_rootns_kill + +Process creation +================ + +.. kernel-doc:: kernel/rootns.c + :doc: CLONE_INTO_ROOTNS + +Filesystem configuration +======================== + +.. kernel-doc:: fs/fsopen.c + :doc: FSCONFIG_SET_ROOTNS + +Mount tree installation +======================= + +.. kernel-doc:: fs/namespace.c + :doc: MOVE_MOUNT_T_MNTNS -- 2.47.3