lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <8102e84f-a12b-4e8b-9e24-99e2e9bc112d@lucifer.local>
Date: Thu, 11 Sep 2025 10:20:16 +0100
From: Lorenzo Stoakes <lorenzo.stoakes@...cle.com>
To: "Liam R. Howlett" <Liam.Howlett@...cle.com>
Cc: Andrew Morton <akpm@...ux-foundation.org>, maple-tree@...ts.infradead.org,
        linux-mm@...ck.org, linux-kernel@...r.kernel.org,
        David Hildenbrand <david@...hat.com>, Vlastimil Babka <vbabka@...e.cz>,
        Suren Baghdasaryan <surenb@...gle.com>, Michal Hocko <mhocko@...e.com>,
        Jann Horn <jannh@...gle.com>, Pedro Falcato <pfalcato@...e.de>,
        Charan Teja Kalla <quic_charante@...cinc.com>,
        shikemeng@...weicloud.com, kasong@...cent.com, nphamcs@...il.com,
        bhe@...hat.com, baohua@...nel.org, chrisl@...nel.org,
        Matthew Wilcox <willy@...radead.org>
Subject: Re: [PATCH v1 7/9] mm: Introduce unmap_desc struct to reduce
 function arguments

On Tue, Sep 09, 2025 at 03:09:43PM -0400, Liam R. Howlett wrote:
> The unmap_region code uses a number of arguments that could use better
> documentation.  With the addition of a descriptor for unmap (called
> unmap_desc), the arguments can be more self-documenting and increase the
> descriptions within the declaration.
>
> No functional change intended
>
> Signed-off-by: Liam R. Howlett <Liam.Howlett@...cle.com>

Apart from bikeshed below, LGTM so:

Reviewed-by: Lorenzo Stoakes <lorenzo.stoakes@...cle.com>

> ---
>  mm/mmap.c | 12 ++++++++----
>  mm/vma.c  | 27 ++++++++++++---------------
>  mm/vma.h  | 35 ++++++++++++++++++++++++++++++++---
>  3 files changed, 52 insertions(+), 22 deletions(-)
>
> diff --git a/mm/mmap.c b/mm/mmap.c
> index aa4770b8d7f1e..5c9bd3f20e53f 100644
> --- a/mm/mmap.c
> +++ b/mm/mmap.c
> @@ -1883,11 +1883,15 @@ __latent_entropy int dup_mmap(struct mm_struct *mm, struct mm_struct *oldmm)
>  		if (max) {
>  			vma_iter_set(&vmi, 0);
>  			tmp = vma_next(&vmi);
> +			UNMAP_REGION(unmap, &vmi, /* first vma = */ tmp,
> +				     /* min vma addr = */ 0,
> +				     /* max vma addr = */ max,
> +				     /* prev = */ NULL, /* next = */ NULL);
> +
> +			/* Don't free the pgtables higher than the failure */
> +			unmap.tree_max = max;
>  			flush_cache_mm(mm);
> -			unmap_region(&vmi.mas, /* vma = */ tmp,
> -				     /*vma_min = */ 0, /* vma_max = */ max,
> -				     /* pg_max = */ max, /* prev = */ NULL,
> -				     /* next = */ NULL);
> +			unmap_region(&unmap);
>  			charge = tear_down_vmas(mm, &vmi, tmp, max);
>  			vm_unacct_memory(charge);
>  		}
> diff --git a/mm/vma.c b/mm/vma.c
> index 4c850ffd83a4b..c92384975cbb2 100644
> --- a/mm/vma.c
> +++ b/mm/vma.c
> @@ -473,22 +473,20 @@ void remove_vma(struct vm_area_struct *vma)
>   *
>   * Called with the mm semaphore held.
>   */
> -void unmap_region(struct ma_state *mas, struct vm_area_struct *vma,
> -		unsigned long vma_min, unsigned long vma_max, unsigned long pg_max,
> -		struct vm_area_struct *prev, struct vm_area_struct *next)
> +void unmap_region(struct unmap_desc *desc)
>  {
> -	struct mm_struct *mm = vma->vm_mm;
> +	struct mm_struct *mm = desc->first->vm_mm;
> +	struct ma_state *mas = desc->mas;
>  	struct mmu_gather tlb;
>
>  	tlb_gather_mmu(&tlb, mm);
>  	update_hiwater_rss(mm);
> -	unmap_vmas(&tlb, mas, vma, vma_min, vma_max, vma_max,
> -		   /* mm_wr_locked = */ true);
> -	mas_set(mas, vma->vm_end);
> -	free_pgtables(&tlb, mas, vma, prev ? prev->vm_end : FIRST_USER_ADDRESS,
> -		      next ? next->vm_start : USER_PGTABLES_CEILING,
> -		      pg_max,
> -		      /* mm_wr_locked = */ true);
> +	unmap_vmas(&tlb, mas, desc->first, desc->vma_min, desc->vma_max,
> +		   desc->vma_max, desc->mm_wr_locked);
> +	mas_set(mas, desc->tree_reset);
> +	free_pgtables(&tlb, mas, desc->first, desc->first_pgaddr,
> +		      desc->last_pgaddr, desc->tree_max,
> +		      desc->mm_wr_locked);
>  	tlb_finish_mmu(&tlb);
>  }
>
> @@ -2414,15 +2412,14 @@ static int __mmap_new_file_vma(struct mmap_state *map,
>
>  	error = mmap_file(vma->vm_file, vma);
>  	if (error) {
> +		UNMAP_REGION(unmap, vmi, vma, vma->vm_start, vma->vm_end,
> +			     map->prev, map->next);
>  		fput(vma->vm_file);
>  		vma->vm_file = NULL;
>
>  		vma_iter_set(vmi, vma->vm_end);
>  		/* Undo any partial mapping done by a device driver. */
> -		unmap_region(&vmi->mas, vma, vma->vm_start, vma->vm_end,
> -			     map->next ? map->next->vm_start : USER_PGTABLES_CEILING,
> -			     map->prev, map->next);
> -
> +		unmap_region(&unmap);
>  		return error;
>  	}
>
> diff --git a/mm/vma.h b/mm/vma.h
> index b0ebc81d5862e..4edd5d26ffcfc 100644
> --- a/mm/vma.h
> +++ b/mm/vma.h
> @@ -152,6 +152,37 @@ struct vma_merge_struct {
>
>  };
>
> +struct unmap_desc {
> +	struct  ma_state *mas;        /* the maple state point to the first vma */
> +	struct vm_area_struct *first; /* The first vma */
> +	unsigned long first_pgaddr;   /* The first pagetable address to free */
> +	unsigned long last_pgaddr;    /* The last pagetable address to free */
> +	unsigned long vma_min;        /* The min vma address */
> +	unsigned long vma_max;        /* The max vma address */
> +	unsigned long tree_max;       /* Maximum for the vma tree search */
> +	unsigned long tree_reset;     /* Where to reset the vma tree walk */
> +	bool mm_wr_locked;            /* If the mmap write lock is held */
> +};

Nice :) comments really help this be self-documenting also.

> +
> +#define UNMAP_REGION(name, _vmi, _vma, _vma_min, _vma_max, _prev, _next)      \

Not to bike shed, but I we already have MMAP_STATE() and VMG_MMAP_STATE() for
instance, so perhaps UNMAP_STATE() for consistency?

> +	struct unmap_desc name = {                                          \
> +		.mas = &(_vmi)->mas,                                          \
> +		.first = _vma,                                                \
> +		.first_pgaddr = _prev ?                                       \
> +			((struct vm_area_struct *)_prev)->vm_end :            \
> +			FIRST_USER_ADDRESS,                                   \
> +		.last_pgaddr = _next ?                                        \
> +			((struct vm_area_struct *)_next)->vm_start :          \
> +			USER_PGTABLES_CEILING,                                \
> +		.vma_min = _vma_min,                                          \
> +		.vma_max = _vma_max,                                          \
> +		.tree_max = _next ?                                           \
> +			((struct vm_area_struct *)_next)->vm_start :          \
> +			USER_PGTABLES_CEILING,                                \
> +		.tree_reset = _vma->vm_end,                                   \
> +		.mm_wr_locked = true,                                         \
> +	}
> +
>  static inline bool vmg_nomem(struct vma_merge_struct *vmg)
>  {
>  	return vmg->state == VMA_MERGE_ERROR_NOMEM;
> @@ -260,9 +291,7 @@ int do_vmi_munmap(struct vma_iterator *vmi, struct mm_struct *mm,
>
>  void remove_vma(struct vm_area_struct *vma);
>
> -void unmap_region(struct ma_state *mas, struct vm_area_struct *vma,
> -		unsigned long min, unsigned long max, unsigned long pg_max,
> -		struct vm_area_struct *prev, struct vm_area_struct *next);
> +void unmap_region(struct unmap_desc *desc);
>
>  /* We are about to modify the VMA's flags. */
>  __must_check struct vm_area_struct
> --
> 2.47.2
>

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ