From: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
To: Hillf Danton <hdanton@sina.com>
Cc: Boqun Feng <boqun.feng@gmail.com>, Jann Horn <jannh@google.com>,
linux-mm@kvack.org, linux-kernel@vger.kernel.org
Subject: Re: [RFC PATCH] docs/mm: add VMA locks documentation
Date: Thu, 7 Nov 2024 11:15:02 +0000 [thread overview]
Message-ID: <f2c8e125-8436-40dd-81d5-5bda786d54a2@lucifer.local> (raw)
In-Reply-To: <20241107110717.3441-1-hdanton@sina.com>
On Thu, Nov 07, 2024 at 07:07:17PM +0800, Hillf Danton wrote:
> On Fri, 1 Nov 2024 18:50:33 +0000 Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
> >
> > Locking around VMAs is complicated and confusing. While we have a number of
> > disparate comments scattered around the place, we seem to be reaching a
> > level of complexity that justifies a serious effort at clearly documenting
> > how locks are expected to be interacted with when it comes to interacting
> > with mm_struct and vm_area_struct objects.
> >
> > This is especially pertinent as regards efforts to find sensible
> > abstractions for these fundamental objects within the kernel rust
> > abstraction whose compiler strictly requires some means of expressing these
> > rules (and through this expression can help self-document these
> > requirements as well as enforce them which is an exciting concept).
> >
> > The document limits scope to mmap and VMA locks and those that are
> > immediately adjacent and relevant to them - so additionally covers page
> > table locking as this is so very closely tied to VMA operations (and relies
> > upon us handling these correctly).
> >
> > The document tries to cover some of the nastier and more confusing edge
> > cases and concerns especially around lock ordering and page table teardown.
> >
> What is missed is the clear guide to the correct locking order.
> Is the order below correct for instance?
>
> lock vma
> lock vma->vm_mm
There's a whole section on lock ordering (albeit, a copy/paste of mm/rmap.c
comment).
However I do agree that I didn't put enough emphasis on lock ordering for VMA
locks.
I'm working on v2 now (aside: my god you won't believe how surprisingly
challenging it is to write docs, I mean you'd think I'd know after book but I
forgot I guess :) where I put a very strong emphasis on this locking order,
including reflecting Suren and Jann's input on read mmap lock vs. vma read lock
(you'd probably not want to bother with vma read lock if you have an mmap read
lock, but the latter has to be taken before the former if you do - the other way
round is a deadlock).
The v2 respin puts a much stronger emphasis on separating a top-level practical
guide to what locks to acquire and where in what order vs. implementation
details as per the valuable feedback on this from Alice + others.
So TL;DR - yes agree absolutely and this is made clearer in v2!
prev parent reply other threads:[~2024-11-07 11:15 UTC|newest]
Thread overview: 33+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-11-01 18:50 Lorenzo Stoakes
2024-11-01 20:58 ` Lorenzo Stoakes
2024-11-01 22:41 ` Suren Baghdasaryan
2024-11-01 23:48 ` SeongJae Park
2024-11-04 13:02 ` Lorenzo Stoakes
2024-11-04 13:47 ` Mike Rapoport
2024-11-04 19:55 ` Lorenzo Stoakes
2024-11-02 1:45 ` Jann Horn
2024-11-04 16:42 ` Lorenzo Stoakes
2024-11-04 21:29 ` Jann Horn
2024-11-05 16:10 ` Lorenzo Stoakes
2024-11-05 17:21 ` Jann Horn
2024-11-06 3:09 ` Qi Zheng
2024-11-06 18:09 ` Jann Horn
2024-11-07 7:07 ` Qi Zheng
2024-11-06 2:56 ` Qi Zheng
2024-11-06 11:28 ` Lorenzo Stoakes
2024-11-07 6:47 ` Qi Zheng
2024-11-02 9:00 ` Mike Rapoport
2024-11-04 14:17 ` Lorenzo Stoakes
2024-11-04 15:19 ` Mike Rapoport
2024-11-05 12:23 ` Lorenzo Stoakes
2024-11-04 14:47 ` Alice Ryhl
2024-11-04 16:52 ` Lorenzo Stoakes
2024-11-05 13:56 ` Alice Ryhl
2024-11-05 14:18 ` Lorenzo Stoakes
2024-11-04 17:01 ` Suren Baghdasaryan
2024-11-04 21:04 ` Lorenzo Stoakes
2024-11-04 21:20 ` Suren Baghdasaryan
2024-11-05 16:11 ` Lorenzo Stoakes
2024-11-04 21:25 ` Jann Horn
2024-11-07 11:07 ` Hillf Danton
2024-11-07 11:15 ` Lorenzo Stoakes [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=f2c8e125-8436-40dd-81d5-5bda786d54a2@lucifer.local \
--to=lorenzo.stoakes@oracle.com \
--cc=boqun.feng@gmail.com \
--cc=hdanton@sina.com \
--cc=jannh@google.com \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®