From patchwork Wed Mar 1 02:27:20 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Suren Baghdasaryan X-Patchwork-Id: 13155456 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id EC8ACC7EE30 for ; Wed, 1 Mar 2023 02:27:29 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3110C6B007B; Tue, 28 Feb 2023 21:27:29 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 2C1636B007D; Tue, 28 Feb 2023 21:27:29 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 1892E6B007E; Tue, 28 Feb 2023 21:27:29 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 0BC106B007B for ; Tue, 28 Feb 2023 21:27:29 -0500 (EST) Received: from smtpin19.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id D6FE240F46 for ; Wed, 1 Mar 2023 02:27:28 +0000 (UTC) X-FDA: 80518742976.19.8FE8DC3 Received: from mail-yw1-f201.google.com (mail-yw1-f201.google.com [209.85.128.201]) by imf18.hostedemail.com (Postfix) with ESMTP id 1F5F71C0009 for ; Wed, 1 Mar 2023 02:27:26 +0000 (UTC) Authentication-Results: imf18.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=nEKJGBxV; spf=pass (imf18.hostedemail.com: domain of 3Drj-YwYKCJ8RTQDMAFNNFKD.BNLKHMTW-LLJU9BJ.NQF@flex--surenb.bounces.google.com designates 209.85.128.201 as permitted sender) smtp.mailfrom=3Drj-YwYKCJ8RTQDMAFNNFKD.BNLKHMTW-LLJU9BJ.NQF@flex--surenb.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1677637647; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=7cn5FYVeC2KQFYRWBJMiQUgkU1g+DHIoWLNV16kMAX8=; b=G93INKCrHiMgSuY5ykaPduejOBTUBdNp6XOVocuC0DwPtqfDi/st4sDcPCEsLko8tfXnIG lOTwYauo6FVjD7MXGAdv+dUVJ0crkOpZcm31AoONPCB5hBlcKgmnop4vxs2+b9KPesba8x 3kcF15+zDUqtnOZitQEHjpcaONC/c0g= ARC-Authentication-Results: i=1; imf18.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=nEKJGBxV; spf=pass (imf18.hostedemail.com: domain of 3Drj-YwYKCJ8RTQDMAFNNFKD.BNLKHMTW-LLJU9BJ.NQF@flex--surenb.bounces.google.com designates 209.85.128.201 as permitted sender) smtp.mailfrom=3Drj-YwYKCJ8RTQDMAFNNFKD.BNLKHMTW-LLJU9BJ.NQF@flex--surenb.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1677637647; a=rsa-sha256; cv=none; b=6vPGFk34ikpKjVkmLE4mmdSaxRPL7+LjclSm9qG0BankeUf51ofvwXd3ln9FVwYGHqVQ4U OBk4SAomy8EQNrhNuW0fNg5EP+vBrh3KJ8tJCglup7zekO5NztbdeBtkeJn3qACguHvEDQ 7WTeIu2gAB6zFbx8dpIDqNlq0pyv3BQ= Received: by mail-yw1-f201.google.com with SMTP id 00721157ae682-5376fa4106eso252890677b3.7 for ; Tue, 28 Feb 2023 18:27:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; t=1677637646; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=7cn5FYVeC2KQFYRWBJMiQUgkU1g+DHIoWLNV16kMAX8=; b=nEKJGBxVMi4BEnUPRf0A+X+O4cmdoIfmLz4mW0W7FAAdyzE+55RofUSqDm1Oc8j5HW s1kTQu8Va0CaEqyTIW/ytdCVmiVSAcL55TeGUQBZ59DCB+JKZYO06jESJpBOq9zHC2Ve BFLqAqFjGXGEaw6a2XEiZp/v9rL6janNV4eXvoeLzGpw+GAUNeE9/AYpJAhViMLNUcMj M9FU382AfH+XW6iH4w1WuYFyzsFbmH3+tD0ZrvREQ3+QePPpECTKuQVBwosyAERKmI53 sgKsNHDtefpjWD8aYJb4eUnl3c/A4mbpNnImsVMVoqxw1yHBqUVX7C2Lb9lK+/YiXOny bAhw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1677637646; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=7cn5FYVeC2KQFYRWBJMiQUgkU1g+DHIoWLNV16kMAX8=; b=N9K+7OinWezP5yPwmngGNOTkg8aSn0SqC8ML8d745iOORoX45uNC+DH0z+8xO9FyQm j1CMv4ivCFteBaWp00hKvngs+tF3RnOsQIm7ileubnnmqkyhxf3HMsu4hndDlBLTWCf3 pxnuOUxyCT2jyPWrlHjnrdzS+eM87C/YqWjtNHdrXFReiIsK6MF4Y2OpBBy3DomgMTJP JokuaM6CWc7EmSYfSo341qjP692s0Vt8iQr98/tAXNJoZw0FPJDIdsKhfsRvPhp2wxaW TgdK5FN7aZkCw+UIutyJesxnv7gapC405vSX5nsbMB86FnaB5W0MkR7vysL6O4Af3KmZ bltg== X-Gm-Message-State: AO0yUKX0qMny4zxnk4A973NdNaHjyGrpAyWUeTkySjHXNcvJYw/SenTg nzAFddSdLnPiC1Oj+tlBPbCHhLBqmwU= X-Google-Smtp-Source: AK7set+bQp/cRKpaxZTq9IwTlkx2ibMJdRWhkaok19KZrfs1SDda57vKLaSk5U2QaFcJDDsrJULwQTMPDek= X-Received: from surenb-desktop.mtv.corp.google.com ([2620:15c:211:200:612b:820a:2225:ad82]) (user=surenb job=sendgmr) by 2002:a05:6902:10d:b0:a4b:a813:46de with SMTP id o13-20020a056902010d00b00a4ba81346demr2167842ybh.4.1677637646292; Tue, 28 Feb 2023 18:27:26 -0800 (PST) Date: Tue, 28 Feb 2023 18:27:20 -0800 In-Reply-To: <20230301022720.1380780-1-surenb@google.com> Mime-Version: 1.0 References: <20230301022720.1380780-1-surenb@google.com> X-Mailer: git-send-email 2.39.2.722.g9855ee24e9-goog Message-ID: <20230301022720.1380780-2-surenb@google.com> Subject: [PATCH 2/2] mm: document FAULT_FLAG_VMA_LOCK flag From: Suren Baghdasaryan To: akpm@linux-foundation.org Cc: sfr@canb.auug.org.au, error27@gmail.com, willy@infradead.org, david@redhat.com, Liam.Howlett@oracle.com, jgg@ziepe.ca, yuzhao@google.com, dhowells@redhat.com, hughd@google.com, mathieu.desnoyers@efficios.com, pasha.tatashin@soleen.com, laurent.dufour@fr.ibm.com, linux-mm@kvack.org, linux-kernel@vger.kernel.org, surenb@google.com X-Rspam-User: X-Rspamd-Server: rspam03 X-Stat-Signature: ewjhpa7uif8w4j6j1pq37arfcr3da79i X-Rspamd-Queue-Id: 1F5F71C0009 X-HE-Tag: 1677637646-864432 X-HE-Meta: U2FsdGVkX18y3l56VER1T+1edK1+WpooA5W2VeOJBsqDQikJigW5ZBzWAtazhxiUGKpH13mhYCQuKRafRghPDoKB1VjtRlWtXrw6SvkcoDICddMBlX35uKcRYU5x+svcWd0FWBjIm9J5Fh+l2FZr7mKIozP34alEHLdMi5cmzLwI87LKho9cSpWv3LRHQNvul6vHKMbJ812b84Y2ffFezLECH2So7ndgQlqV+ZZSLTNb293yvkaP7PaOT8yCpoc+SPCZZbkvXf9Y32xCEwb/GBCIcEyTyRaiKfgbo35jMtrCZKSjV/QOY45TQw8FVJWoJH0mlnz8zphXBapAXQdh6+UsW5rRxYZB1sG0Fo3HAgqVE0BtUTdfUk5XR6MdgdUBjsWsr1j0x1ROsrpE2NzG99vI/0ts00I+BZyeHefFuUwWKhIxBOPsm9Xr0IHPNwvgkNxlMj2msQ48vh6mtpQEHzjD5a9ih5XPmtim7lKxMT6g2zcODSHGoj+TGQDyL3IKcNI57wEU4pphZvWDPu3yNEQTFMtmpM2QVSJKPG2J71QUnr8VPM3N/go6kmxjmxJhENjahmWLyzR5pJ20/XI0zbQ0uZmx3nxz79t/Y3jKc8tPu8WclQz1wyTbp5rVq3/UUNZPX25AhV9g/42KKWW7pM6roY8fd50zrkI+Rw/kjLpRRf6CDZguTmlpBtHlyORi0B7nxL5JUmU/F1oORWRpl9DctCHtLs2pbOM2k0YPCRC4sL9KPTl/0mWhnu+WwZfylQvjjL/NLqH7y8Q/eBbhaB5LUTlKYKWyLxgjAt2DskG0bqUXxTV3wxHeVGAk22tZoDwgK3Ls+qWNGR25+FoFKY8JRcOJ3DSolL+ziXU4YY4nX7dQCxpsutc6tZYMEyyrjzf5YF76u+Fa5hVilv9/riWoytTGl4pkQqRAk4dt7G+//6eLUWuwwHWBrLq/UuGqOSL8D1oX6a3a9+TgleX 62pwmbs4 YSlejXQtGkEbLrUbT7aXBQ191WPHjOzcvemF+DNBLLPM5Ow5wMR5PcsOMNKhV/IXJlzDfzyHEq5pQOW2FQxs4m8fqmE/uqcJTyr3uIB5msbMqFMANBckSjJ5dv+tnm47V7bC721le8cM/58DKCQFxfSNC0Ifgy+X6O85tcrGxoPmEr0UBnWbSV/haB1f9lCW7N2DAi31fAtTcFwa3mbgbUpsgpNWFDgf2sOD+5xKuwInJDw3MaauAXkrNhS61BYo8sKH8A/tpHE0PA/MF/j/a5KCXAVeyIffUg/KPhAJ3TNdfche38pWfNzB8eeCMCJiXE+xhS2hd3CF30xu3LJl8BQsc/z2m57UOmgQeBUyQXXJHqgT1JEf3Nkm19IdZXlUoFLo4LW3gvAvDL15vIQrr3/JWhxbBxcc/uNI30b231F4T4DAbCUHv0KcLHh5nA+zYqwqyiul2san+s5X+iRp6ZIKQG+dfuaIspjEGB3eVWHIj347rhHe2mdMqeb3J71wDogyOfw18gNhXmz6seGs/tzmX7zEzrmMGNmozMg4YARtPBR91vl8FQzaxLIwlM6PYvO8J84VnPunh3FT1lgrJJ2P5twMHwap9kDFWnqBWELRLiAk4NVYwzf06MVBzmN3I0T3tMQmitwDcv5sIkjAq6pmWqzCRJSmoFynFZp8fLaNnB0Jr64sV+vz0BD6+OutuOAeiUTly7jojXGM8cjWYe9V2hQX5M0mLGUjPbz5qE/CDaGaRZys6NmKiHDScHYMwFRUK263Ijs6bVRsu9oW6zsrpzo7WQjNx+1BW X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: FAULT_FLAG_VMA_LOCK flag was introduced without proper description. Fix this by documenting it. Fixes: 863be34fc093 ("mm: add FAULT_FLAG_VMA_LOCK flag") Reported-by: Stephen Rothwell Link: https://lore.kernel.org/all/20230301113648.7c279865@canb.auug.org.au/ Signed-off-by: Suren Baghdasaryan --- Fix cleanly apply over mm-unstable, SHA in "Fixes" is from that tree. include/linux/mm_types.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/linux/mm_types.h b/include/linux/mm_types.h index 89bbf7d8a312..ef74ea892c5b 100644 --- a/include/linux/mm_types.h +++ b/include/linux/mm_types.h @@ -1064,6 +1064,7 @@ typedef struct { * mapped after the fault. * @FAULT_FLAG_ORIG_PTE_VALID: whether the fault has vmf->orig_pte cached. * We should only access orig_pte if this flag set. + * @FAULT_FLAG_VMA_LOCK: The fault is handled under VMA lock. * * About @FAULT_FLAG_ALLOW_RETRY and @FAULT_FLAG_TRIED: we can specify * whether we would allow page faults to retry by specifying these two