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=-2.4 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_1 autolearn=no 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 E5903C433DF for ; Sun, 31 May 2020 19:56:26 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id A88F320707 for ; Sun, 31 May 2020 19:56:26 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=nvidia.com header.i=@nvidia.com header.b="LJmZyCG3" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org A88F320707 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=nvidia.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 4C3A880007; Sun, 31 May 2020 15:56:26 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 474278E0003; Sun, 31 May 2020 15:56:26 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3890580007; Sun, 31 May 2020 15:56:26 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0032.hostedemail.com [216.40.44.32]) by kanga.kvack.org (Postfix) with ESMTP id 1E4018E0003 for ; Sun, 31 May 2020 15:56:26 -0400 (EDT) Received: from smtpin17.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay04.hostedemail.com (Postfix) with ESMTP id C1B19125C for ; Sun, 31 May 2020 19:56:25 +0000 (UTC) X-FDA: 76878071130.17.lift25_8f602096dc322 Received: from filter.hostedemail.com (10.5.16.251.rfc1918.com [10.5.16.251]) by smtpin17.hostedemail.com (Postfix) with ESMTP id AA4F9180D0180 for ; Sun, 31 May 2020 19:56:25 +0000 (UTC) X-HE-Tag: lift25_8f602096dc322 X-Filterd-Recvd-Size: 3425 Received: from hqnvemgate24.nvidia.com (hqnvemgate24.nvidia.com [216.228.121.143]) by imf46.hostedemail.com (Postfix) with ESMTP for ; Sun, 31 May 2020 19:56:25 +0000 (UTC) Received: from hqpgpgate101.nvidia.com (Not Verified[216.228.121.13]) by hqnvemgate24.nvidia.com (using TLS: TLSv1.2, DES-CBC3-SHA) id ; Sun, 31 May 2020 12:54:50 -0700 Received: from hqmail.nvidia.com ([172.20.161.6]) by hqpgpgate101.nvidia.com (PGP Universal service); Sun, 31 May 2020 12:56:23 -0700 X-PGP-Universal: processed; by hqpgpgate101.nvidia.com on Sun, 31 May 2020 12:56:23 -0700 Received: from [10.2.56.10] (10.124.1.5) by HQMAIL107.nvidia.com (172.20.187.13) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Sun, 31 May 2020 19:56:23 +0000 Subject: Re: [PATCH 1/2] mm/gup: introduce pin_user_pages_locked() To: Souptick Joarder CC: Andrew Morton , LKML , Linux-MM References: <20200527223243.884385-1-jhubbard@nvidia.com> <20200527223243.884385-2-jhubbard@nvidia.com>

X-Nvconfidentiality: public From: John Hubbard Message-ID: <0674f8b7-a5eb-6d5c-792d-573f85871a72@nvidia.com> Date: Sun, 31 May 2020 12:56:23 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.8.1 MIME-Version: 1.0 In-Reply-To: X-Originating-IP: [10.124.1.5] X-ClientProxiedBy: HQMAIL111.nvidia.com (172.20.187.18) To HQMAIL107.nvidia.com (172.20.187.13) Content-Type: text/plain; charset="utf-8"; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nvidia.com; s=n1; t=1590954890; bh=Th/cRGXuH5TQAsB59fJhQbQWOy6yVIziuBSyzMG0XRw=; h=X-PGP-Universal:Subject:To:CC:References:X-Nvconfidentiality:From: Message-ID:Date:User-Agent:MIME-Version:In-Reply-To: X-Originating-IP:X-ClientProxiedBy:Content-Type:Content-Language: Content-Transfer-Encoding; b=LJmZyCG3IH0g2a0d4Ax6nEFatLTVb1w2HMjjjElXPV7cUVsnZIqIoaH3C647Wd2Ua IHP/OndOMCopjWvsPRz1sUUvGkqOiYqRw4d5kRcSGYbpcL/PyuaaHJDHopIBH4pVUG NHluLPeoAOMveuTSKhHZJ6eGjHCu9YB6XbFsp06F1FLSMahpVlwgW3G9dbkNR/vpVn hIMu2mv1hzuPNXaCwAUwqF0NBnVftbEHcZCvpYvVTs7NXO5ZZlFkEEAiIq12R+d7hK xjh6zzOzUB1aCRiiBWOf1ehwn2yViW4U2lh9OcqonhvXHttv8qtCmlNqNhgBvkP/8g ltz+cBQGZFcBA== X-Rspamd-Queue-Id: AA4F9180D0180 X-Spamd-Result: default: False [0.00 / 100.00] X-Rspamd-Server: rspam01 X-Bogosity: Ham, tests=bogofilter, spamicity=0.002447, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On 2020-05-31 00:13, Souptick Joarder wrote: > On Sun, May 31, 2020 at 12:34 PM Souptick Joarder wrote: >> >> On Thu, May 28, 2020 at 4:02 AM John Hubbard wrote: >>> >>> Introduce pin_user_pages_locked(), which is nearly identical to >>> get_user_pages_locked() except that it sets FOLL_PIN and rejects >>> FOLL_GET. > > Forget to ask, is it fine to add this new pin_user_pages_locked() in > Documentation/core-api/pin_user_pages.rst ? > I wasn't planning on maintaining a rigorous list of all of the pin_user_page*() API calls, in pin_user_pages.rst. Each call is documented in gup.c, for that. The .rst is there to help explain things at a slighly higher abstraction level. thanks, -- John Hubbard NVIDIA