From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from flow-a7-smtp.messagingengine.com (flow-a7-smtp.messagingengine.com [103.168.172.142]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 78F923B388A; Mon, 29 Jun 2026 06:59:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.142 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782716398; cv=none; b=imc0IdnDILMuA+0pFDpBCMy5b2GjI4XTMI4KSFec028QDeDbsPkY6D6fwEgKRa3ZLDSlU3SLXgz8x8z8pGnFCaPujZkYypToGxCETHCpc6IyQhjEJNc/hm2mFmsOkEdkJZF0Gj1vWmRLVxs/UTQFfilJPDMh8hVt8gYEp6xpkyE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782716398; c=relaxed/simple; bh=6qzG+s+o0ntSMLj3f0AMOalFGqBsSo63rEgrfvI/OqQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=jgyErqX5dW5y8lKS2IqgC4bKClViHVDRV1GCcKzfrhhzE4VLJtt0/jcbycnwHCgB5/ODTjKZSEB1lfNNWmjdi1p3XGn5nkZxTBTVfZ6ZaJnY40j7eeP2b15rDuQs2PWIOla2QsOqmanKn4CIrbzZwlkDptV2QzOdVl9T4VW7QFo= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=fail (p=none dis=none) header.from=Obsidian.Systems; spf=fail smtp.mailfrom=Obsidian.Systems; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=HvjgLc9t; arc=none smtp.client-ip=103.168.172.142 Authentication-Results: smtp.subspace.kernel.org; dmarc=fail (p=none dis=none) header.from=Obsidian.Systems Authentication-Results: smtp.subspace.kernel.org; spf=fail smtp.mailfrom=Obsidian.Systems Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="HvjgLc9t" Received: from phl-compute-05.internal (phl-compute-05.internal [10.202.2.45]) by mailflow.phl.internal (Postfix) with ESMTP id C743913801A0; Mon, 29 Jun 2026 02:59:56 -0400 (EDT) Received: from phl-frontend-04 ([10.202.2.163]) by phl-compute-05.internal (MEProxy); Mon, 29 Jun 2026 02:59:56 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:subject:subject:to:to:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm1; t=1782716396; x=1782723596; bh=O dOkzuKr6PMGP0Swb+3TBhVRv/cseWllGDt56sDblRs=; b=HvjgLc9t3YyxCa4ow ky52JhgHPeriumxhHt8q6kcpfaWO9XKn122fSgobz8Fx4DjCp/tT/4/CJEcUvJCz yqHgpd7xDZGMnPcKH8m48tqvnqd/SQFcpcmcpvQmAaraS4tbcZ9LVB0TC9Wn8Cum QnOG32skVZNbCRu0EvSBUT7Fr3aae6r0vsLFC0rAbYeZ8uLZqwZG2yWpXU3KV4sT MBLFlKNgU+5JKOiak7cGLO3rKYHFWKCdJlm41ujEZHF5z1375pUvU8Y69EX29zZ2 R60EoZjqOvrp4g7oH/gipnqvs4WP/INR+oG2ap6FaYHLJzsl6oIHDZ+ena8eGiXQ Y1PNA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: dmFkZTFXRXqXXHQig7aOEXscQpb861yO5R1n/JZ6/neobiLJxdwcQzvLtKpg3rAKseaAOK QsJhQwi62/No698HcwnilN3sG7YXlAfqWy/lDrcLEbeiS6jMSOcpT8xMw4CYYBtDSPh9ua fbkHZ4sq8c9RILgSHAvyMaHp4hjTZcdv0ZCaXt3xRyvWX2TfrkxRsebc3IizW4gRw8G5PK egy7dn1PuCGj8lbOqc95xmreGYhBGeCRsZ8NvMQ3TGqmgXLN4na69GZ07y8Q5aNxwOSqVq phXG20pRAzX8AuKD1hIURFKnXT3/UUySz0y1LRBFEWGzEXoNvnA32P6m9f2FXjRHKlHnr/ zWYb3y4oIArybB1B6dKf5EZT9gG4pXqx8qAtOT6OkrlP4d40o72eIvDP6NvR0sp1XjsgUb 9AgebZ+ED5ZSb5HIlRcCUZWXWpo+SvWI/xu08Ai6fZP51goYJgSchB48NX3dt0BhAx/A/G NVzQIIiqroByFKkdSv7bHbZiQ8OjMCiUrvXBQi75M7Ge2lgm8fRqmF7k0pmuAJymrBhFRJ iDsMOFEduArHeOQqBqzSGb3YkpYRwSqxQwic95jXUrvnIICJWRMt8qKayX9DvzauKEiuo2 IaipwU+ZfJjAk0qzW3cDwjlDuQYqn6IdfFN3qLY/JsJdBDb9kD7/POtIDHJA X-ME-Proxy: Feedback-ID: i91b946ab:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 29 Jun 2026 02:59:55 -0400 (EDT) From: John Ericson To: "Andy Lutomirski" , "Al Viro" , "Christian Brauner" , "Jan Kara" , "David Howells" , "Chuck Lever" , "Jeff Layton" , "Shuah Khan" , "David Laight" , "H. Peter Anvin" , "Li Chen" , "Cong Wang" , "Arnd Bergmann" , "Thomas Gleixner" , "Ingo Molnar" , "Borislav Petkov" , "Dave Hansen" , "Jonathan Corbet" , "Kees Cook" , "Sergei Zimmerman" , "Farid Zakaria" , linux-arch , LKML , linux-fsdevel , linux-api , netfs , linux-nfs Cc: John Ericson Subject: [RFC PATCH 1/3] fs: Add documentation to some `struct fs_struct` fields Date: Mon, 29 Jun 2026 02:58:20 -0400 Message-ID: <20260629065934.1425479-2-John.Ericson@Obsidian.Systems> X-Mailer: git-send-email 2.51.2 In-Reply-To: <20260629065934.1425479-1-John.Ericson@Obsidian.Systems> References: <20260629065934.1425479-1-John.Ericson@Obsidian.Systems> Precedence: bulk X-Mailing-List: linux-api@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: John Ericson This will be expanded upon in the next commit. Link: https://lore.kernel.org/all/a49ce818-f38d-41b0-bbf7-80b8aad998b1@app.fastmail.com/ Signed-off-by: John Ericson --- include/linux/fs_struct.h | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/include/linux/fs_struct.h b/include/linux/fs_struct.h index 0070764b790a..b5db5de9eb01 100644 --- a/include/linux/fs_struct.h +++ b/include/linux/fs_struct.h @@ -12,7 +12,21 @@ struct fs_struct { seqlock_t seq; int umask; int in_exec; - struct path root, pwd; + + /* + * The root directory for the task(s) that points to this + * `fs_struct`. The root directory also controls how `..` + * resolve; path traversal is not allowed to resolve upwards + * beyond the root directory. (It is for this latter reason that + * `chroot` is a privileged operation.) + */ + struct path root; + + /* + * The current working directory for the task(s) that points to + * this `fs_struct`. + */ + struct path pwd; } __randomize_layout; extern struct kmem_cache *fs_cachep; -- 2.51.2