From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from frasgout.his.huawei.com (frasgout.his.huawei.com [185.176.79.56]) (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 4DA391F1534; Thu, 8 Jan 2026 15:27:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=185.176.79.56 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767886041; cv=none; b=M9qZis7IEI98PPWHjch0LGYSImD8mOHxDUx7AinPUx5uzE50fGcbpMZGn8TWQDS1PIf3rOomgjn2M1Nhs+2uTaU/PFeMiz+lJezqo1UrryL3hMf2Nw1vnc2eowJ7jt+n4X+50ufbJd+XESy1HEZ2OkPdkYi9A6T15TdIxveEq1U= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767886041; c=relaxed/simple; bh=jKUcZrfjjXtmON/mcBgSGHdkM8Yw6PvAIJrOv31+CnY=; h=Date:From:To:CC:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=DANk/z2zadLDpuVm2QdtZQpA/tYuP7tCtVn3d2UZA3rrCJn8XcJnhpFjd9gbU4wx5W/eRqhG8oVMK/A0URkGeQo86jxCqazJPy5yN5+RKsA62duKvclF+0/yoaChC9agY4FNAiVdWgdSHOaqyQznwKzLrXGhOUt+cLel2WT6MXE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=huawei.com; spf=pass smtp.mailfrom=huawei.com; arc=none smtp.client-ip=185.176.79.56 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=huawei.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=huawei.com Received: from mail.maildlp.com (unknown [172.18.224.150]) by frasgout.his.huawei.com (SkyGuard) with ESMTPS id 4dn80D4YQnzHnGg3; Thu, 8 Jan 2026 23:27:08 +0800 (CST) Received: from dubpeml100005.china.huawei.com (unknown [7.214.146.113]) by mail.maildlp.com (Postfix) with ESMTPS id EE2BE4056B; Thu, 8 Jan 2026 23:27:16 +0800 (CST) Received: from localhost (10.203.177.15) by dubpeml100005.china.huawei.com (7.214.146.113) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1544.36; Thu, 8 Jan 2026 15:27:15 +0000 Date: Thu, 8 Jan 2026 15:27:13 +0000 From: Jonathan Cameron To: John Groves CC: Miklos Szeredi , Dan Williams , Bernd Schubert , "Alison Schofield" , John Groves , Jonathan Corbet , Vishal Verma , Dave Jiang , Matthew Wilcox , Jan Kara , Alexander Viro , "David Hildenbrand" , Christian Brauner , "Darrick J . Wong" , Randy Dunlap , Jeff Layton , Amir Goldstein , Stefan Hajnoczi , Joanne Koong , Josef Bacik , Bagas Sanjaya , Chen Linxuan , "James Morse" , Fuad Tabba , "Sean Christopherson" , Shivank Garg , Ackerley Tng , Gregory Price , Aravind Ramesh , Ajay Joshi , , , , , , Subject: Re: [PATCH V3 21/21] famfs_fuse: Add documentation Message-ID: <20260108152713.00001b42@huawei.com> In-Reply-To: <20260107153332.64727-22-john@groves.net> References: <20260107153244.64703-1-john@groves.net> <20260107153332.64727-1-john@groves.net> <20260107153332.64727-22-john@groves.net> X-Mailer: Claws Mail 4.3.0 (GTK 3.24.42; x86_64-w64-mingw32) Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-ClientProxiedBy: lhrpeml100012.china.huawei.com (7.191.174.184) To dubpeml100005.china.huawei.com (7.214.146.113) On Wed, 7 Jan 2026 09:33:30 -0600 John Groves wrote: > Add Documentation/filesystems/famfs.rst and update MAINTAINERS > > Reviewed-by: Randy Dunlap > Tested-by: Randy Dunlap > Signed-off-by: John Groves > --- > Documentation/filesystems/famfs.rst | 142 ++++++++++++++++++++++++++++ > Documentation/filesystems/index.rst | 1 + > MAINTAINERS | 1 + > 3 files changed, 144 insertions(+) > create mode 100644 Documentation/filesystems/famfs.rst > > diff --git a/Documentation/filesystems/famfs.rst b/Documentation/filesystems/famfs.rst > new file mode 100644 > index 000000000000..0d3c9ba9b7a8 > --- /dev/null > +++ b/Documentation/filesystems/famfs.rst > +Principles of Operation > +======================= .... > +When an app accesses a data object in a famfs file, there is no page cache > +involvement. The CPU cache is loaded directly from the shared memory. In > +some use cases, this is an enormous reduction read amplification compared > +to loading an entire page into the page cache. > + Trivial but this double blank line seems inconsistent. I don't mind if it's one or two, but do the same everywhere. > + > +Famfs is Not a Conventional File System > +--------------------------------------- Nice doc. Reviewed-by: Jonathan Cameron