From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 56CC033985 for ; Mon, 4 Nov 2024 15:21:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730733718; cv=none; b=pZiUzC2p+OigBm5PeLQPjVBm9uLcFqrM44zTBXyPC0CDUyp+2hQxQZIwuGXetyFLMC3JDQBtn2F1eTFS1GCuF/ls2qJQvIB+wl32ZQuvKER2BEa5OLfBjsWd3b0oHApGMabKTXNYyE8CF55kOH6gwb36mKq19Yu8WZFWrjqQ5QU= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1730733718; c=relaxed/simple; bh=oBYUN9j1BO+q23M2y1oS+AkreaMduAa607+U0E1Z1hs=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=SAuN4+XBmW6fPur7sEor1E+RvUVWzggUq7y8PJ/lWxNxypRi5MA8zlEr06Ej3muuwQymcjB97cdxdfxbq9fkX4oUNRyo7RLYoaqREJuzeAAl+mfEB8UmufYr4AwdQu5wQimNhM3XqKp7V7OSbOJqlZ/cZt/je512akFreNOQ+Cs= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=VtgqT1uu; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="VtgqT1uu" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 8BB7DC4CECE; Mon, 4 Nov 2024 15:21:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1730733717; bh=oBYUN9j1BO+q23M2y1oS+AkreaMduAa607+U0E1Z1hs=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=VtgqT1uuFQtPbxTjdgfVroBbcew1hX1L4HXAYMwMvXqPJ18WEY6oODnfvOB6bQAJK 4+Xl7+vcOQvCPumVZIWftglnvulteTpcVVEm/tOgUiPbnTtrxftytpApvosRn0Hm0Z 2wvsXGqazeJ4x6XVqlHg+MIfo54JO3Enphh9kZi8LbkhSMbOYizHmpGhBVgzPbYQBh Fk7BQneqHsYhLD9RxUybWeqwSFpHsYQxR1pOGDmFSywrtkavG9TI+vZNxW3cRGuG9V fgGid78B4qQdjQZP0HAM3r93gMa5Vp2b96U/sHvV5Yx2E4zgOLASHSwsD/GW1dYpYQ 6Lfm+B3h4HYMQ== Date: Mon, 4 Nov 2024 17:19:21 +0200 From: Mike Rapoport To: Lorenzo Stoakes Cc: Jonathan Corbet , Andrew Morton , "Liam R . Howlett" , Vlastimil Babka , Jann Horn , Alice Ryhl , Boqun Feng , Matthew Wilcox , linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: Re: [RFC PATCH] docs/mm: add VMA locks documentation Message-ID: References: <20241101185033.131880-1-lorenzo.stoakes@oracle.com> <164796a6-c9aa-423b-ba2e-5c6093e3d559@lucifer.local> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <164796a6-c9aa-423b-ba2e-5c6093e3d559@lucifer.local> On Mon, Nov 04, 2024 at 02:17:36PM +0000, Lorenzo Stoakes wrote: > On Sat, Nov 02, 2024 at 11:00:20AM +0200, Mike Rapoport wrote: > > > + > > > +The table specifies which write locks must be held to write to the field. > > > + > > > +.. list-table:: > > > + :widths: 20 10 22 5 20 > > > + :header-rows: 1 > > > > And use .. table here as well, e.g > > Hm this one is a little less clearly worth it because not only will that take me > ages but it'll be quite difficult to read in a sensible editor. I can if you > insist though? With spaces it will look just fine in a text editor and IMHO better than list-table, but I don't insist. > > .. table:: > > > > ======== ======== ========================== ================== ========== > > Field Config Description Unstable RCU read? Write lock > > ======== ======== ========================== ================== ========== > > vm_start Inclusive start virtual mmap write, > > address of range VMA VMA write > > describes > > > > vm_end Exclusive end virtual mmap write, > > address of range VMA VMA write > > describes > > > > vm_rcu vma_lock RCU list head, in union N/A N/A > > with vma_start, vma_end. > > RCU implementation detail > > ======== ======== ========================== ================== ========== -- Sincerely yours, Mike.