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 4DAAC22127B for ; 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=1767886042; cv=none; b=T3N5kwi+X/EunYfkOtx9YCkUniGfA+GBaEI/7qiz5nxG2oi0feJxnNzFwqx/hmTeDTKfbj9/2q0FCY0DUcHExZCzARuiUVg2wrY94DieCLoWihR0eLyZd4I4z/voXuZDVVgV9UgrK3qvk4Qitv9m/N/zXl0sQDimSCy5VCYKvH0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767886042; c=relaxed/simple; bh=jKUcZrfjjXtmON/mcBgSGHdkM8Yw6PvAIJrOv31+CnY=; h=Date:From:To:CC:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=Nr+AJLC1RH81aVT51t3/U0I2wn9/b7NuL2V2UZUqhxGXE5mCt9DIoJ7NQeC9e5eVCz7qIwMD4grmSUP88izlckD2GPXvIAb7pyaWsij9tSyYMv0Ryey67K2dudhlpPd7jv5REJ6Ehx0WT9VOLzD4ouWW8lPeSU7qMRtqPV/TG+U= 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: nvdimm@lists.linux.dev 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