From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-qt1-f170.google.com (mail-qt1-f170.google.com [209.85.160.170]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AA19D1BD9C9 for ; Mon, 16 Mar 2026 00:43:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=pass smtp.client-ip=209.85.160.170 ARC-Seal:i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773621836; cv=pass; b=E3JubHXCa/VAJh8UOTOEQ18dR51m6+ptFt8+hkQk2FxZ2L0elOtyTXAy20HUFX4PhsGxaiqOzEoBK9rDMef2+Sl6VYggn/BbdSn7dqAGvH/7ANvwkEPZCbDjheXFRS7xynhSR6D8Xagnb3ve02j5Zwr2VGCiDuBYP+gD944k0qM= ARC-Message-Signature:i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773621836; c=relaxed/simple; bh=7LEG6GSfAF3VAhLmKNS+zMMoXAkVfIwRn9mYIfi1rWQ=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=h2tSV8qh35gZIQG0c8MWreY4x51YhZS5vN/pIa0Grq8NPR/GEnVTOfg5NMkUIaKwEwDIGC5qpb8DMJMpInf5LvOyJl384VS3fJX78ABb2wi77hXxUMy8aW8580iBAD8zZOD6Bl2+7vOwmMEv98dLyYl7fRUfSAZI6m1iw+0brcg= ARC-Authentication-Results:i=2; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=Uq8l+CWJ; arc=pass smtp.client-ip=209.85.160.170 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="Uq8l+CWJ" Received: by mail-qt1-f170.google.com with SMTP id d75a77b69052e-509069a7a7fso778251cf.0 for ; Sun, 15 Mar 2026 17:43:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1773621833; cv=none; d=google.com; s=arc-20240605; b=CB+kHruWTuMhO07bC6qzQdPXZ7xTj9y3ePIb6xaNGlZ6fTpKEz0rgdSeIZNmhaMolB LmKAnbuyZhR51jy3Je5GSLPwqYRTfFve/L7/BQlYVzwjv9KHkCUi0PJUI3L3zc32xu0g C3cLru6sj8PrbcHspIiK/16ofL6xNCN1WqMVVxnKvnOrYocGUUXlOTMB3igmBtE0U/4n ESw+ShLTXtqSN2rcobk1J/Q1H9JzyRuyEZulyUwCFQI4BzCCxUabc5yCMoADXNs1CPMC ynerMyExzATQVHgnEiEcpI29rhlnqwlLAkzV8uy/cWlA5iF4U062mbw4AEq+1SKLtjE+ C+lw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:dkim-signature; bh=B4iLbVdU6UwNcjWJZqb9n6er3BcFb6HsfZvwCgpauBo=; fh=f20OlRiu1QT5TrJkS13wAFIbPaQsyMm4sx1x0eSXsZE=; b=Va4KnpXeyY7OHlWbjGBx5jEtpPOO+5MisrX36G7qUqdTvEHvc6ttpY63NjVTSz7RvX 4SqgvtuZZ1uMrw3vK/nEGFfCDL3PFv3T4QqEitfmT85ofuWyHi5mmc1ZwAkizL9bAMTH JDuvVmThy9mcZQW8u4Ums8kH2M5QZBy+LT7RJaoYCvzKMrB/sXNNmyPQOb2w72eG41dU iYnjtsSd8z1u4bX5gaMzoaIza/+uuO4JrJwYss6IKsghulShHvlk9fp9H1aEUnGNBe6G R4/bHtfpRSPwi2JAgX+YIVDtROXLNFfFIg40JHIxUG21X/+oI8NGJaG3FK/ik4e9+ObB Om+w==; darn=vger.kernel.org ARC-Authentication-Results: i=1; mx.google.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20251104; t=1773621833; x=1774226633; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=B4iLbVdU6UwNcjWJZqb9n6er3BcFb6HsfZvwCgpauBo=; b=Uq8l+CWJk0WTqz9jqxGNlxO9DJTTEYg0jzcEwKsGQromc9HdLwhBRDIig9v5LDqAiL +j68IzkMKWna2XRNimWCHTi3EoL4lYBymgIN7lMybA/HcFO1BA3q+nyBplYYXrnqMDaq BZwzyqITeQCHv7TPdA+Vj2DW739xzI9lMEipKNvKoNzGqNLTteNdbMvpr01TU8RhbGnk +1j81C+2p97jzOHOdrl57tF9V1fCcQxW5F+bvgN05PPn5MX6gjD9sd6JSD82mPE1IN+8 xwS/crF5d+HNk8eP8wJaOQ0IrqBhXpWskLk3fmIE7k+6g7u9z99A+htspNfIZR9kOwPs oioQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773621833; x=1774226633; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=B4iLbVdU6UwNcjWJZqb9n6er3BcFb6HsfZvwCgpauBo=; b=i9txym4z0qEh1QSDk4DgORxYYfxOJ7MkC7VcrhvRAQnPVHzf7Spc8l8eNQQynIkPsW ZPfA3opYpm5V+CFG/l5/M6ZHEWJ9QoxLMZ7n0rD0zGI2v//qeynBgorWqiJMwxeYEjme KAKPi8zxIHPrhyIdoXbujM7hwUDAnUTWYCO1re3CTXWaYxKfEG2a0dV8SEjxrryB/JDW vhSJQMR302muc4oKzEvfcoAQUqgcSRx14NvjqM4HLM9VH7Y2nuuuarCvlbDr1bv1pFJx W4j3QsqtSvfbQIzVPg6ZYInQv3q9dRe3phUsZQklFqtirPJV4qvyXIU6GDJPWPHWZUra qbTw== X-Forwarded-Encrypted: i=1; AJvYcCXH23fCkVYxEe0RHd7bsqfnKy1iqq+ZL0hEZ/WauNEde69ttupv3UovdHZEJehB+iFxz4Cu0ZoZEvUs1Z4=@vger.kernel.org X-Gm-Message-State: AOJu0YwRR7VkFblRtGezdXW0U0RlQ9ubc36CHElWzbPKqfQD8m4phEMo NgvHMDIBvp8N01fivf1FJwhxkRXn6Dpqj1T0FyvqzjXVeBVv0kZmbDCFvvmSXWAs9tnTnY+I424 yIVOKAXY7es+rvHBud7/4IB9I2j/bIw9VeW1j9E9N X-Gm-Gg: ATEYQzwx1ylgzDQub1EvcDyvzRppbDvsWlAJ+CKjmLkoFOnxeFjePPIdDftcUW6qS2g ESV5Wn9osiivA2oZXedgBb/1oyszPlm5MotJFF6eKaMAVgU4Ig5s/jYHxglSO3bG7ccn0M3WWYv yQgj8qTVPBSlG4ncTQqy7w5YPh3w7xGSeL9gTfrzs0vRQFIENJpdzQfPpHWXgbkJasbnPEGxjBP kH/WmiEwz9XgJ2RsYRGfXodRE6Jo6IvFWYyHnHtTM8Lh423WIPY3QJEit6yjhluJvmE2poC+eeC chsJEg== X-Received: by 2002:ac8:590e:0:b0:503:4bc:c925 with SMTP id d75a77b69052e-5096aa2ae2cmr17578141cf.13.1773621833001; Sun, 15 Mar 2026 17:43:53 -0700 (PDT) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <52a7b9a003ea51521ab3c0baf30337a7800a3af7.1773346620.git.ljs@kernel.org> In-Reply-To: <52a7b9a003ea51521ab3c0baf30337a7800a3af7.1773346620.git.ljs@kernel.org> From: Suren Baghdasaryan Date: Sun, 15 Mar 2026 17:43:41 -0700 X-Gm-Features: AaiRm51H9IsCynzRpnxAc6_DrzYXD9cjd8fR558hmylwDQfMj5FrJzUnU5dorNw Message-ID: Subject: Re: [PATCH 03/15] mm: document vm_operations_struct->open the same as close() To: "Lorenzo Stoakes (Oracle)" Cc: Andrew Morton , Jonathan Corbet , Clemens Ladisch , Arnd Bergmann , Greg Kroah-Hartman , "K . Y . Srinivasan" , Haiyang Zhang , Wei Liu , Dexuan Cui , Long Li , Alexander Shishkin , Maxime Coquelin , Alexandre Torgue , Miquel Raynal , Richard Weinberger , Vignesh Raghavendra , Bodo Stroesser , "Martin K . Petersen" , David Howells , Marc Dionne , Alexander Viro , Christian Brauner , Jan Kara , David Hildenbrand , "Liam R . Howlett" , Vlastimil Babka , Mike Rapoport , Michal Hocko , Jann Horn , Pedro Falcato , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-hyperv@vger.kernel.org, linux-stm32@st-md-mailman.stormreply.com, linux-arm-kernel@lists.infradead.org, linux-mtd@lists.infradead.org, linux-staging@lists.linux.dev, linux-scsi@vger.kernel.org, target-devel@vger.kernel.org, linux-afs@lists.infradead.org, linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, Ryan Roberts Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Thu, Mar 12, 2026 at 1:27=E2=80=AFPM Lorenzo Stoakes (Oracle) wrote: > > Describe when the operation is invoked and the context in which it is > invoked, matching the description already added for vm_op->close(). > > While we're here, update all outdated references to an 'area' field for > VMAs to the more consistent 'vma'. > > Signed-off-by: Lorenzo Stoakes (Oracle) > --- > include/linux/mm.h | 15 ++++++++++----- > 1 file changed, 10 insertions(+), 5 deletions(-) > > diff --git a/include/linux/mm.h b/include/linux/mm.h > index cc5960a84382..12a0b4c63736 100644 > --- a/include/linux/mm.h > +++ b/include/linux/mm.h > @@ -748,15 +748,20 @@ struct vm_uffd_ops; > * to the functions called when a no-page or a wp-page exception occurs. > */ > struct vm_operations_struct { > - void (*open)(struct vm_area_struct * area); > + /** > + * @open: Called when a VMA is remapped or split. Not called upon= first > + * mapping a VMA. It's also called from dup_mmap() which is part of forking. > + * Context: User context. May sleep. Caller holds mmap_lock. > + */ > + void (*open)(struct vm_area_struct *vma); > /** > * @close: Called when the VMA is being removed from the MM. > * Context: User context. May sleep. Caller holds mmap_lock. > */ > - void (*close)(struct vm_area_struct * area); > + void (*close)(struct vm_area_struct *vma); > /* Called any time before splitting to check if it's allowed */ > - int (*may_split)(struct vm_area_struct *area, unsigned long addr)= ; > - int (*mremap)(struct vm_area_struct *area); > + int (*may_split)(struct vm_area_struct *vma, unsigned long addr); > + int (*mremap)(struct vm_area_struct *vma); > /* > * Called by mprotect() to make driver-specific permission > * checks before mprotect() is finalised. The VMA must not > @@ -768,7 +773,7 @@ struct vm_operations_struct { > vm_fault_t (*huge_fault)(struct vm_fault *vmf, unsigned int order= ); > vm_fault_t (*map_pages)(struct vm_fault *vmf, > pgoff_t start_pgoff, pgoff_t end_pgoff); > - unsigned long (*pagesize)(struct vm_area_struct * area); > + unsigned long (*pagesize)(struct vm_area_struct *vma); > > /* notification that a previously read-only page is about to beco= me > * writable, if an error is returned it will cause a SIGBUS */ > -- > 2.53.0 >