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 X-Spam-Level: X-Spam-Status: No, score=-8.5 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_PASS,USER_AGENT_MUTT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id AD6DCC282F6 for ; Mon, 21 Jan 2019 10:20:42 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id C9E8320989 for ; Mon, 21 Jan 2019 10:20:40 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726694AbfAUKUj (ORCPT ); Mon, 21 Jan 2019 05:20:39 -0500 Received: from mx0b-001b2d01.pphosted.com ([148.163.158.5]:46626 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1726004AbfAUKUi (ORCPT ); Mon, 21 Jan 2019 05:20:38 -0500 Received: from pps.filterd (m0098416.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x0LADuxq105593 for ; Mon, 21 Jan 2019 05:20:37 -0500 Received: from e06smtp04.uk.ibm.com (e06smtp04.uk.ibm.com [195.75.94.100]) by mx0b-001b2d01.pphosted.com with ESMTP id 2q5bg72adr-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Mon, 21 Jan 2019 05:20:37 -0500 Received: from localhost by e06smtp04.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Mon, 21 Jan 2019 10:20:35 -0000 Received: from b06cxnps4074.portsmouth.uk.ibm.com (9.149.109.196) by e06smtp04.uk.ibm.com (192.168.101.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Mon, 21 Jan 2019 10:20:29 -0000 Received: from d06av26.portsmouth.uk.ibm.com (d06av26.portsmouth.uk.ibm.com [9.149.105.62]) by b06cxnps4074.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x0LAKSFp64159796 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Mon, 21 Jan 2019 10:20:28 GMT Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 51FBCAE053; Mon, 21 Jan 2019 10:20:28 +0000 (GMT) Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A8A87AE055; Mon, 21 Jan 2019 10:20:26 +0000 (GMT) Received: from rapoport-lnx (unknown [9.148.206.247]) by d06av26.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Mon, 21 Jan 2019 10:20:26 +0000 (GMT) Date: Mon, 21 Jan 2019 12:20:24 +0200 From: Mike Rapoport To: Peter Xu Cc: linux-mm@kvack.org, linux-kernel@vger.kernel.org, Hugh Dickins , Maya Gokhale , Jerome Glisse , Johannes Weiner , Martin Cracauer , Denis Plotnikov , Shaohua Li , Andrea Arcangeli , Pavel Emelyanov , Mike Kravetz , Marty McFadden , Mike Rapoport , Mel Gorman , "Kirill A . Shutemov" , "Dr . David Alan Gilbert" Subject: Re: [PATCH RFC 01/24] mm: gup: rename "nonblocking" to "locked" where proper References: <20190121075722.7945-1-peterx@redhat.com> <20190121075722.7945-2-peterx@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20190121075722.7945-2-peterx@redhat.com> User-Agent: Mutt/1.5.24 (2015-08-30) X-TM-AS-GCONF: 00 x-cbid: 19012110-0016-0000-0000-000002483BCE X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19012110-0017-0000-0000-000032A26C2E Message-Id: <20190121102024.GB19725@rapoport-lnx> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2019-01-21_06:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1901210082 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Jan 21, 2019 at 03:56:59PM +0800, Peter Xu wrote: > There's plenty of places around __get_user_pages() that has a parameter > "nonblocking" which does not really mean that "it won't block" (because > it can really block) but instead it shows whether the mmap_sem is > released by up_read() during the page fault handling mostly when > VM_FAULT_RETRY is returned. > > We have the correct naming in e.g. get_user_pages_locked() or > get_user_pages_remote() as "locked", however there're still many places > that are using the "nonblocking" as name. > > Renaming the places to "locked" where proper to better suite the > functionality of the variable. While at it, fixing up some of the > comments accordingly. > > Signed-off-by: Peter Xu Reviewed-by: Mike Rapoport > --- > mm/gup.c | 44 +++++++++++++++++++++----------------------- > mm/hugetlb.c | 8 ++++---- > 2 files changed, 25 insertions(+), 27 deletions(-) > > diff --git a/mm/gup.c b/mm/gup.c > index 8cb68a50dbdf..7b1f452cc2ef 100644 > --- a/mm/gup.c > +++ b/mm/gup.c > @@ -506,12 +506,12 @@ static int get_gate_page(struct mm_struct *mm, unsigned long address, > } > > /* > - * mmap_sem must be held on entry. If @nonblocking != NULL and > - * *@flags does not include FOLL_NOWAIT, the mmap_sem may be released. > - * If it is, *@nonblocking will be set to 0 and -EBUSY returned. > + * mmap_sem must be held on entry. If @locked != NULL and *@flags > + * does not include FOLL_NOWAIT, the mmap_sem may be released. If it > + * is, *@locked will be set to 0 and -EBUSY returned. > */ > static int faultin_page(struct task_struct *tsk, struct vm_area_struct *vma, > - unsigned long address, unsigned int *flags, int *nonblocking) > + unsigned long address, unsigned int *flags, int *locked) > { > unsigned int fault_flags = 0; > vm_fault_t ret; > @@ -523,7 +523,7 @@ static int faultin_page(struct task_struct *tsk, struct vm_area_struct *vma, > fault_flags |= FAULT_FLAG_WRITE; > if (*flags & FOLL_REMOTE) > fault_flags |= FAULT_FLAG_REMOTE; > - if (nonblocking) > + if (locked) > fault_flags |= FAULT_FLAG_ALLOW_RETRY; > if (*flags & FOLL_NOWAIT) > fault_flags |= FAULT_FLAG_ALLOW_RETRY | FAULT_FLAG_RETRY_NOWAIT; > @@ -549,8 +549,8 @@ static int faultin_page(struct task_struct *tsk, struct vm_area_struct *vma, > } > > if (ret & VM_FAULT_RETRY) { > - if (nonblocking && !(fault_flags & FAULT_FLAG_RETRY_NOWAIT)) > - *nonblocking = 0; > + if (locked && !(fault_flags & FAULT_FLAG_RETRY_NOWAIT)) > + *locked = 0; > return -EBUSY; > } > > @@ -627,7 +627,7 @@ static int check_vma_flags(struct vm_area_struct *vma, unsigned long gup_flags) > * only intends to ensure the pages are faulted in. > * @vmas: array of pointers to vmas corresponding to each page. > * Or NULL if the caller does not require them. > - * @nonblocking: whether waiting for disk IO or mmap_sem contention > + * @locked: whether we're still with the mmap_sem held > * > * Returns number of pages pinned. This may be fewer than the number > * requested. If nr_pages is 0 or negative, returns 0. If no pages > @@ -656,13 +656,11 @@ static int check_vma_flags(struct vm_area_struct *vma, unsigned long gup_flags) > * appropriate) must be called after the page is finished with, and > * before put_page is called. > * > - * If @nonblocking != NULL, __get_user_pages will not wait for disk IO > - * or mmap_sem contention, and if waiting is needed to pin all pages, > - * *@nonblocking will be set to 0. Further, if @gup_flags does not > - * include FOLL_NOWAIT, the mmap_sem will be released via up_read() in > - * this case. > + * If @locked != NULL, *@locked will be set to 0 when mmap_sem is > + * released by an up_read(). That can happen if @gup_flags does not > + * has FOLL_NOWAIT. > * > - * A caller using such a combination of @nonblocking and @gup_flags > + * A caller using such a combination of @locked and @gup_flags > * must therefore hold the mmap_sem for reading only, and recognize > * when it's been released. Otherwise, it must be held for either > * reading or writing and will not be released. > @@ -674,7 +672,7 @@ static int check_vma_flags(struct vm_area_struct *vma, unsigned long gup_flags) > static long __get_user_pages(struct task_struct *tsk, struct mm_struct *mm, > unsigned long start, unsigned long nr_pages, > unsigned int gup_flags, struct page **pages, > - struct vm_area_struct **vmas, int *nonblocking) > + struct vm_area_struct **vmas, int *locked) > { > long ret = 0, i = 0; > struct vm_area_struct *vma = NULL; > @@ -718,7 +716,7 @@ static long __get_user_pages(struct task_struct *tsk, struct mm_struct *mm, > if (is_vm_hugetlb_page(vma)) { > i = follow_hugetlb_page(mm, vma, pages, vmas, > &start, &nr_pages, i, > - gup_flags, nonblocking); > + gup_flags, locked); > continue; > } > } > @@ -736,7 +734,7 @@ static long __get_user_pages(struct task_struct *tsk, struct mm_struct *mm, > page = follow_page_mask(vma, start, foll_flags, &ctx); > if (!page) { > ret = faultin_page(tsk, vma, start, &foll_flags, > - nonblocking); > + locked); > switch (ret) { > case 0: > goto retry; > @@ -1195,7 +1193,7 @@ EXPORT_SYMBOL(get_user_pages_longterm); > * @vma: target vma > * @start: start address > * @end: end address > - * @nonblocking: > + * @locked: whether the mmap_sem is still held > * > * This takes care of mlocking the pages too if VM_LOCKED is set. > * > @@ -1203,14 +1201,14 @@ EXPORT_SYMBOL(get_user_pages_longterm); > * > * vma->vm_mm->mmap_sem must be held. > * > - * If @nonblocking is NULL, it may be held for read or write and will > + * If @locked is NULL, it may be held for read or write and will > * be unperturbed. > * > - * If @nonblocking is non-NULL, it must held for read only and may be > - * released. If it's released, *@nonblocking will be set to 0. > + * If @locked is non-NULL, it must held for read only and may be > + * released. If it's released, *@locked will be set to 0. > */ > long populate_vma_page_range(struct vm_area_struct *vma, > - unsigned long start, unsigned long end, int *nonblocking) > + unsigned long start, unsigned long end, int *locked) > { > struct mm_struct *mm = vma->vm_mm; > unsigned long nr_pages = (end - start) / PAGE_SIZE; > @@ -1245,7 +1243,7 @@ long populate_vma_page_range(struct vm_area_struct *vma, > * not result in a stack expansion that recurses back here. > */ > return __get_user_pages(current, mm, start, nr_pages, gup_flags, > - NULL, NULL, nonblocking); > + NULL, NULL, locked); > } > > /* > diff --git a/mm/hugetlb.c b/mm/hugetlb.c > index 705a3e9cc910..05b879bda10a 100644 > --- a/mm/hugetlb.c > +++ b/mm/hugetlb.c > @@ -4181,7 +4181,7 @@ int hugetlb_mcopy_atomic_pte(struct mm_struct *dst_mm, > long follow_hugetlb_page(struct mm_struct *mm, struct vm_area_struct *vma, > struct page **pages, struct vm_area_struct **vmas, > unsigned long *position, unsigned long *nr_pages, > - long i, unsigned int flags, int *nonblocking) > + long i, unsigned int flags, int *locked) > { > unsigned long pfn_offset; > unsigned long vaddr = *position; > @@ -4252,7 +4252,7 @@ long follow_hugetlb_page(struct mm_struct *mm, struct vm_area_struct *vma, > spin_unlock(ptl); > if (flags & FOLL_WRITE) > fault_flags |= FAULT_FLAG_WRITE; > - if (nonblocking) > + if (locked) > fault_flags |= FAULT_FLAG_ALLOW_RETRY; > if (flags & FOLL_NOWAIT) > fault_flags |= FAULT_FLAG_ALLOW_RETRY | > @@ -4269,8 +4269,8 @@ long follow_hugetlb_page(struct mm_struct *mm, struct vm_area_struct *vma, > break; > } > if (ret & VM_FAULT_RETRY) { > - if (nonblocking) > - *nonblocking = 0; > + if (locked) > + *locked = 0; > *nr_pages = 0; > /* > * VM_FAULT_RETRY must not return an > -- > 2.17.1 > -- Sincerely yours, Mike.