From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id D2558D132DF for ; Mon, 4 Nov 2024 15:22:01 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4424D6B0083; Mon, 4 Nov 2024 10:22:01 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 3F1F06B0085; Mon, 4 Nov 2024 10:22:01 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2E0756B0089; Mon, 4 Nov 2024 10:22:01 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 1070D6B0083 for ; Mon, 4 Nov 2024 10:22:01 -0500 (EST) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id B25811A0321 for ; Mon, 4 Nov 2024 15:22:00 +0000 (UTC) X-FDA: 82748777370.18.845438F Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf15.hostedemail.com (Postfix) with ESMTP id 5A10EA0005 for ; Mon, 4 Nov 2024 15:21:26 +0000 (UTC) Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=VtgqT1uu; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf15.hostedemail.com: domain of rppt@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=rppt@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1730733636; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=BEYbQDHSaMTi7y9eEonNUkRULuqm8S3viieTqYNtY0M=; b=3aw3LZiqttSoO6STukoAjYmXiJYGmsYPOZvQFnrw1mMFErRwOkmsNocFZityxmEOnepREy PTMjdeXCvTDd5JBC/EHVyaAO2aoa0+pGcRrlvzOaJqmR7RO6R9zEmdZ8g+cRX1bpK2fFVR gZ4ccURlquePSBIBo1tJIkAe74D2ao4= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=VtgqT1uu; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf15.hostedemail.com: domain of rppt@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=rppt@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1730733636; a=rsa-sha256; cv=none; b=ao+kdUtWxGWXPlgm7xII95TXfi5RIyMGuTBOoqVOWZLhO+HmvWsymGlrRIdRc14h3K93UZ by0sEX4IcAEq2qUo0TNZKfaDH2ptZLVs/vgWYZQRv9ml31uyjoSO5ijehWwFwOmSFfXZwf 7GXHF9Rift/EaxePSb7PxUTNTV+JfHg= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id 12305A42DF1; Mon, 4 Nov 2024 15:20:03 +0000 (UTC) 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> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <164796a6-c9aa-423b-ba2e-5c6093e3d559@lucifer.local> X-Rspam-User: X-Rspamd-Server: rspam03 X-Rspamd-Queue-Id: 5A10EA0005 X-Stat-Signature: x9ckizje665hxrjmpmao98qjoiuyqb6p X-HE-Tag: 1730733686-750451 X-HE-Meta: U2FsdGVkX1/rZv8fGE0++lF3Y4CPRmkjRBqWtfwbWFRJuv2+7GQRVOIpwwk9mDwCPB4zt+HZkWSJvVkpQVSRYn7abdor9yfzGQWZR5IUyE0CLTyXhPIb0ak+RLe6HP+y0Y9CSQpJkGHVFljQk+UWasONeLXRbvzpDMcQNG/5v6+ZkvGMb6yRhTLDVQT3uEW5YNhn9y3/0tm6R8AQ7TwDiwEK8tUu3aXVdHdSTraZ1nXyI7gtCIqW8+NDIO70VV1gzIzkAWvuaBObPRFIf3o09kRE/mGTsW+h5k/PcAuci3aT7Z2KY/XBWXeD0xCGbeNhtwMD2xkIukvXwtFV3pNEuWjhmbjZTK0S5EBbDfo2/4mM/+A3TrrwaY2/YCCs/OEW9MvoLSqkMys1U3KfJi3fLeL3reBA0lwbEpMGfaN0nfGmeDB0oyC0UuIZlNYmoWuR03IlkfZk6Wfnm4PLETU0Kxf7gXK433EazFHGG2H41r9tLJsSYgjRfwGLIAmSoaJVlqHQEQegGdXvF7BS3Hc+p/wqJyPfHycQaaDVgFFMEKLV6QChub8+twGOdNmnZrp/x2SS4TRRttztJGywQxxVOOdNvxNJVViZfqFRL21siLDxlZpME/MK58H8xo0lBLV0JB9VOv23U3rBJzRkoBeEDGjbd6i9VvuBbPz4mYq+iqm4Hgp5TIgvZ7ZNi51FrWxhv+LICJ3uqmu7n9Uo1IjBP25Qhc1OtANohowOgUwzFxzJZQ91Ef6SwfYeQk8qC9h1+zJJzNuHhk4ePt0B2jM44mp5KeA4suC2d7uT+VPsMbWzS1XFjBZydM9e2edwvNHJon6OjAxYMv9OdY9ahVyQQa8V+XYQuKFI388W3ikDCrVwRdwREw9lYwmjrjiCW5CAmlnYVDjwrukYG1DgVkf68ydIxTz7AZTB8dPVxrwYBoEt+1RVM3/EkLvuVgdbvPCogMLUKUsF8Jzj30cLpnq enmINgSK pdQANnbiXTKAutDK60jsDN3jHKQwnSX0VG/QSZBwel+2UmXIMjjh6mdlhoU9x62/aHpRdxL+NXLDU0LcLmPhLpEaOHwuf6oaoWtCZjmqD272vARXOEmazlfdK/lZ383V+lR6WoAAAZbopm7fB+K55klA/VYFgGVB4txAMMoy3KDwxkftEOSSmEuJ9OFF6EGNEE8vTIuvU4fVI8sImEBZeChFj0lbAp3zzjkaFmwEWzAL67SKwFEvQbBRulRRpqOf+KXDdXxTHlnh/M1bxXyZ4+YFw1NPe5kue0hKDKf1UhTzTUrrKc4NGTYCXiu0BRSOXIm1rKYcBihkTYXk= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: 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.