From patchwork Fri Aug 18 20:06:27 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 13358304 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 803F9EE4992 for ; Fri, 18 Aug 2023 20:06:42 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C04BF940075; Fri, 18 Aug 2023 16:06:40 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id BB2C8940012; Fri, 18 Aug 2023 16:06:40 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id AA24A940075; Fri, 18 Aug 2023 16:06:40 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 9A064940012 for ; Fri, 18 Aug 2023 16:06:40 -0400 (EDT) Received: from smtpin15.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id 739C18119A for ; Fri, 18 Aug 2023 20:06:39 +0000 (UTC) X-FDA: 81138308118.15.17F4B7F Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf30.hostedemail.com (Postfix) with ESMTP id BC16E80022 for ; Fri, 18 Aug 2023 20:06:37 +0000 (UTC) Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=nCMQUJtk; dmarc=none; spf=none (imf30.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692389197; a=rsa-sha256; cv=none; b=tMr2f9x+XO86Vrtvsmb5ZgjBWFhni/FMoiGndKaxhadS5HYDM1GyMDQP3TF2THTbN5xsOB YcDvsF4uBts57sOf8nkt36WuR9AmEfuMo6psfTAWvYwIqZuEjpPRzZBzSjVvwkH2zsKIpQ sVLlnA3ee1QV8llIcgsJQkRKU5ZNtlM= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=nCMQUJtk; dmarc=none; spf=none (imf30.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692389197; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=hBTE4z1qFRK8GKVkm74TePYQyzNHYl26/C9WeYlReVs=; b=M9fsjCAjvD3njLCbeoAYTl/+CuL96yZ5fZQ1WICbbZtozBWt+ISwkODc0aD4yiUwKYWUnU upHQ83puCXX8AjUrhRR5lBKsF7L/9IZzVFt60HvluDJdnjr7ptnKylAAZSfvfMEmpIMhZ5 5pbiDC9ScJkC8AzWzBE4do6QDAkkK2o= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=hBTE4z1qFRK8GKVkm74TePYQyzNHYl26/C9WeYlReVs=; b=nCMQUJtkYsiL9VLEqUAbyMPRNU FkMc5ws1uHU5C7DeZssEFP6ua822AKo3VO0PvVhd6XFmc4viXKfWrynUKg+8rvSUk/rbq6DZa6JZY Pk82WHNbCI/6AjlbREUTYzzcPcFkqTBS4vZ4YzaclfawVnVQ7A1nM7TYp/okctf3RoFGtFPkGXXw5 cNLUdxTup4Yqp9SiwXSKm/JuLnPYGad0o84JGBV04hdcelsREQakr7eapSVsU5hOV8vKRQUzfYAev V58r161EPRq1WZ+sNB3X/ELtxoGemEq849+vHpH1TzzZJfT2nk7dVfoDJfWoCm0WRLzWAO+CjdI7+ iNXer5Mw==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1qX5js-00BPV8-HE; Fri, 18 Aug 2023 20:06:32 +0000 From: "Matthew Wilcox (Oracle)" To: Andrew Morton Cc: "Matthew Wilcox (Oracle)" , linux-mm@kvack.org, Mike Rapoport , linux-doc@vger.kernel.org, cgroups@vger.kernel.org Subject: [PATCH 1/4] mm: Fix kernel-doc warning from tlb_flush_rmaps() Date: Fri, 18 Aug 2023 21:06:27 +0100 Message-Id: <20230818200630.2719595-2-willy@infradead.org> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20230818200630.2719595-1-willy@infradead.org> References: <20230818200630.2719595-1-willy@infradead.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: BC16E80022 X-Stat-Signature: y9erjewtor1abqkjwfyjxym8csh6baqb X-HE-Tag: 1692389197-753542 X-HE-Meta: U2FsdGVkX18MrjXIYLPh2PHjxTsJ7uN6ifda6I+br30v3uK6acB93uYPDRGoLqrXUACwdcOKBH1qy2N/t8RjiVCl6is0pgkuQemiiB05bW1NcydE/VogFm0tQguv0dIWpqda1haIQkBnKAfdDTC/5uT1Qv+ABq805tS2WFOru9NmuDHVsF+CA98bfDdVuyCDXKPo9tWP78gYX5vOf2FXf6H05AjtsRDCXOLdGjKVHoj+lts4XzHt5sELz6cfta0kOKQZLrV0KtjxHH51MhP+BNBx1b5hAu7sXCpzeg4ex1I53mxb8dSBNskQmRUEX/5ASz5+l/nakS24/ZWWTXOX6h4XsJxLoX7kr76XSvywJk0fw82kLx1ifiyMIa71rO1GL12m0xwlVybQxaSMTSNhRc7V23BhWbhPpy439AuZsYRN+f1wC2xsvS9j3O+/EEW7NGXlI8v/74yQVQnEFHa0s4CzOGfbqzy79rohvNXU2rH9qFFnKrIGO4G0aoP7YMg3j6sKJqU5HBEdhOYrF+x7+zI2m2K9xlGnU6B74h2FX9WNzvS4BR2xQsp4pdfGpttFkSc3TAIJ9pqkT2FjgvVoC+ACmhdQX0CccVxc3nR1ajdb4yokVXu2m/MrSKgNwqiMiNL6skpLWrvqtFeC29mgMNLgm0vsGsoyewRUpK7KnK6fDwC1Kric+fLVv7jEYPXS5pFXmrp5xWF5P2z5pL5PX55ofgWbqTVZrhrH7Tp1LCB3r6qmLDqGFKYWaOT4cHmsiRPXqv1ZUKsUCcfN3dRoWhjFsK994QQ4TpUcFcPoymHy0bsynMwmxFi8lYaNADiYtr+qEYdLApG0Zm9vWFvQkPtnG8z2JcOYi5D2ZHIot2p6NEtoszFqxG/YSg7O7ZJi0wDSIfMPuvLL9DwR0Xdo/Jj1rar186HhVYH1tTERJYAa/PwdXaztuk6PdsxsV4NccYAjSlTbELK3q8/RJTP 4+R1++qU Ck3LPPRyb3QBQaxTgtZ7QONl9DfjWwJOjdnMZ7zWEXYkc4k3W2fKlAzgpb8slsSv1rYY+ObakJpNmp8WqMX9uM/IBxIGP7lNvndkX5XIYEi3fW8/EGO90T734MiKpIgYrJnlbrrslg3VAdQ1KwF03N0naLtpFfNkmZTR9pIutqeoGbnWMHh3IvVsuiKkWS70pHF7xEThbqui+bZxQ97LVnX65Pk/DBWkRBhLf 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: The vma parameter wasn't described. Signed-off-by: Matthew Wilcox (Oracle) Acked-by: Randy Dunlap Acked-by: Mike Rapoport (IBM) --- mm/mmu_gather.c | 1 + 1 file changed, 1 insertion(+) diff --git a/mm/mmu_gather.c b/mm/mmu_gather.c index ea9683e12936..4f559f4ddd21 100644 --- a/mm/mmu_gather.c +++ b/mm/mmu_gather.c @@ -63,6 +63,7 @@ static void tlb_flush_rmap_batch(struct mmu_gather_batch *batch, struct vm_area_ /** * tlb_flush_rmaps - do pending rmap removals after we have flushed the TLB * @tlb: the current mmu_gather + * @vma: The memory area from which the pages are being removed. * * Note that because of how tlb_next_batch() above works, we will * never start multiple new batches with pending delayed rmaps, so From patchwork Fri Aug 18 20:06:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 13358305 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 AC7A8EE4998 for ; Fri, 18 Aug 2023 20:06:44 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 26913940076; Fri, 18 Aug 2023 16:06:43 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 217A3940012; Fri, 18 Aug 2023 16:06:43 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0902C940076; Fri, 18 Aug 2023 16:06:42 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id E13D7940012 for ; Fri, 18 Aug 2023 16:06:42 -0400 (EDT) Received: from smtpin13.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id C022CB2D9C for ; Fri, 18 Aug 2023 20:06:42 +0000 (UTC) X-FDA: 81138308244.13.F29A9FF Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf01.hostedemail.com (Postfix) with ESMTP id 20B8A40012 for ; Fri, 18 Aug 2023 20:06:40 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=DtFJI03c; dmarc=none; spf=none (imf01.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692389201; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=H22wfoU9WmEkYEOI01RrpJTB8uzVeuDiXA5dlaT4Dc0=; b=U/KXYT0dD178gPuPG26LQYsln0hmNPTbzUhIZlOQt03IebCj2WxyHha0djBM3PIflfq8Q4 r8T3d6fKpJt+oquVLmr3otoA45vy+dhYOottJs0+GnL+u00cjA9TYx0/K7q4uSBkGpfGOU D9cWbnj4/N+xlQakDgt+qGjCaEWvh6Q= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=DtFJI03c; dmarc=none; spf=none (imf01.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692389201; a=rsa-sha256; cv=none; b=2jPTikZvQsJt3SXslFTuDrExJ49EEgh7qxNsNeEIKk+dCtaDCupr3jUn9l0v7XBzoBHLgP EKDSHN1ElqTXsVzeKu17gDO5ydBjCoIL2BRsR0xl1TzTqiFw5tBrKGHkBfpmKxKCOG9QsG tk9eHfozWF7fcP+qkYX2sSWloxPEWv8= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=H22wfoU9WmEkYEOI01RrpJTB8uzVeuDiXA5dlaT4Dc0=; b=DtFJI03cyruQ7/gwxPDSCMj7Mt P7ih/uMjbC/Hacz5WgyFcuMutT4pErsivhRTYQEcszmURU+a9Y575Pn7GK61xVl5JRekPeoM89EVX ZoP1r+vGiVM1o3Yd71Zr+SowTe+QhoRKq6QridfZAiz2n1aXhpZ0Ny31IQVbh7NUlF/bxVDWiLhN+ /hsHBY5hsZ/kkSh0S1MTJJXm+CnVRW8d8B/yOBOPvVua6tf9awy+XGYc0GMzJTUej9x7JAz4+lbPQ O34tQw0e2/7/EDgYoKrsvSRiHAUmoGY2PoF+R50Ie/03rQ+AYed5NnsHzh3enTnSwUNnxNyUVafeP dg+Tw5yQ==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1qX5js-00BPVA-Jw; Fri, 18 Aug 2023 20:06:32 +0000 From: "Matthew Wilcox (Oracle)" To: Andrew Morton Cc: "Matthew Wilcox (Oracle)" , linux-mm@kvack.org, Mike Rapoport , linux-doc@vger.kernel.org, cgroups@vger.kernel.org Subject: [PATCH 2/4] mm: Fix get_mctgt_type() kernel-doc Date: Fri, 18 Aug 2023 21:06:28 +0100 Message-Id: <20230818200630.2719595-3-willy@infradead.org> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20230818200630.2719595-1-willy@infradead.org> References: <20230818200630.2719595-1-willy@infradead.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 20B8A40012 X-Rspam-User: X-Rspamd-Server: rspam02 X-Stat-Signature: fqby73m3515qk6gg9cpkihedbr4ye7j7 X-HE-Tag: 1692389200-4618 X-HE-Meta: U2FsdGVkX189XcZK+9qoEyQ2g2owTRb3rxMA7tT8q73alEa81vt59rdQ42p8c0zXnOMmeI4dKJKH3qQZ4DkoJ/n3HZ+Nnxduam7ng5hQLmkJYZjb8ptsWTuLh2T2gcV9Fn7+p6ZK+LmEr0NUG1x4KXbhnBRT47dhHMmHGugdFQW9BY3HMk51PHxooHaM1T8+VBmLAU5eFSH+ElmIfLNzAzJmnilIiFZeGUh9ZwrgpWK9NlzMX1c4FNPQXTbqMSvgrYhNq64X2Him0LyH3Ng8THkyD/HVVB0u0HoOIlp8cNp9wcUMpG2qjUXn7z+56QfyGO6HJT+ElTnZV7fYO3nmzn6L2Ww37aYXDSXsSCN9VCLij935VqvtdiVvq/HjrdrxD4cLZ8dT+XOpz5BfkjlemOewhuBLXz7fsBtj07sv8IOhzVmYel1zYvoI6mD64IGfDt/VnXhQ/53v5Opg7+GoNoeGCXeh5KPmzPDu3mdEwT6JtT1rfCQAlcMVpQgRH23bVomR3nri+LJgOOeAjqUDlKUBhki580ZpOFJvoqEW1flzWb7RCT1cc4jGTgvWF2QSwj1p/k7sq6Uz12xzwqUmsUpS1sXtvgY7GVq2Mf+UoeYYRyPODhS2oY5npC8ODkVBuqvkraJxgIBuHYDeWd9cWP7KhadfxuDy7SwnDfdsXNVGagURbaiN0sW6rYWz3TDcMVd+WQwvC0KhQ1bnzkw1XGV6poCamnq3gDOKLV1yswW0rd5pNNbuP/RO1QGrsYgc9PwCaLtma8oJccot7hXS/BR2czWF1VJo6BHk4WxCOda+yZdJfVra3IvOG9tSgIIHeomnnpMdnHjoD5uLH6/jwwDYAnpoMbdMU6d/zc+oStYoxLOkloZHgYe9JbmI97K3zr0H7W8aPs7UgY1E7iEPIjpfmWpoj0J5ZqEaLtZxKdsAyk/iZXiBrnHAk6/lMbeX9e7fQvr+Jvl3ZcgQLse KmXWC3ks KMwBsKKDHtHoQFNjt4fEujarpagKDNB+6ufRoTluTFR/q0ZaKHz9ISRHD8EpTsMtbbIEAwZWsDkkG4M9kJH7E3SdFdTpvik1/cWuACuhY1so7x+qee6helX9z5uYq//j27mXk0CT+AhB8KUhwn26X+MyHFesSQ1qBVSmXwWzpM/bB9lC3ewO/nFMHUtImDcSEPHQ23HikVLwU54ni45bAI5zwxIMi8AKWiY+m 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: Convert the return values to an ReST list and tidy up the wording while I'm touching it. Signed-off-by: Matthew Wilcox (Oracle) Reviewed-by: Randy Dunlap Acked-by: Mike Rapoport (IBM) --- mm/memcontrol.c | 31 +++++++++++++------------------ 1 file changed, 13 insertions(+), 18 deletions(-) diff --git a/mm/memcontrol.c b/mm/memcontrol.c index e041ba827e59..cd8b3ae6b8d9 100644 --- a/mm/memcontrol.c +++ b/mm/memcontrol.c @@ -5850,25 +5850,20 @@ static int mem_cgroup_move_account(struct page *page, * @ptent: the pte to be checked * @target: the pointer the target page or swap ent will be stored(can be NULL) * - * Returns - * 0(MC_TARGET_NONE): if the pte is not a target for move charge. - * 1(MC_TARGET_PAGE): if the page corresponding to this pte is a target for - * move charge. if @target is not NULL, the page is stored in target->page - * with extra refcnt got(Callers should handle it). - * 2(MC_TARGET_SWAP): if the swap entry corresponding to this pte is a - * target for charge migration. if @target is not NULL, the entry is stored - * in target->ent. - * 3(MC_TARGET_DEVICE): like MC_TARGET_PAGE but page is device memory and - * thus not on the lru. - * For now we such page is charge like a regular page would be as for all - * intent and purposes it is just special memory taking the place of a - * regular page. - * - * See Documentations/vm/hmm.txt and include/linux/hmm.h - * - * Called with pte lock held. + * Context: Called with pte lock held. + * Return: + * * MC_TARGET_NONE - If the pte is not a target for move charge. + * * MC_TARGET_PAGE - If the page corresponding to this pte is a target for + * move charge. If @target is not NULL, the page is stored in target->page + * with extra refcnt got (Callers should handle it). + * * MC_TARGET_SWAP - If the swap entry corresponding to this pte is a + * target for charge migration. if @target is not NULL, the entry is stored + * in target->ent. + * * MC_TARGET_DEVICE - Like MC_TARGET_PAGE but page is device memory and + * thus not on the lru. For now such page is charged like a regular page + * would be as it is just special memory taking the place of a regular page. + * See Documentations/vm/hmm.txt and include/linux/hmm.h */ - static enum mc_target_type get_mctgt_type(struct vm_area_struct *vma, unsigned long addr, pte_t ptent, union mc_target *target) { From patchwork Fri Aug 18 20:06:29 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 13358307 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 1AE0CEE4997 for ; Fri, 18 Aug 2023 20:06:49 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id ACD01940078; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id A7A8C940012; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 91BC8940078; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 7F09C940012 for ; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 411761211C3 for ; Fri, 18 Aug 2023 20:06:48 +0000 (UTC) X-FDA: 81138308496.09.D169BCE Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf07.hostedemail.com (Postfix) with ESMTP id 92C1840005 for ; Fri, 18 Aug 2023 20:06:46 +0000 (UTC) Authentication-Results: imf07.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=rkSXXrRq; dmarc=none; spf=none (imf07.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692389206; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=vsBXmbIBGjgL8OAsP8lhIU5HpuKdHOAcVbKVff35yq0=; b=fYiOcY8LW4RHW/zndsW3PhmYiu6C1FVeNkHxHBUw/HtZ0sCKg5GjKLd7d36PwS4yFODthU Otn+gZMSpdSIIb73LQbdbsOp/fTWX89ZnTgmaUEaKjOg0Ml8TmkXlvWU5LOvrop4w3cftk ZDT3xuFkxeb5l6RZq8I72UfcD5WCi4Q= ARC-Authentication-Results: i=1; imf07.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=rkSXXrRq; dmarc=none; spf=none (imf07.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692389206; a=rsa-sha256; cv=none; b=4oxk4GNN5qmDUw05VvRUGhNBTZlWCBfYxsfnoDtZJbY2Y2EA36rUgssTY3vp4p+mzA2Y7Y 6k7ysgBMLNUpYw3M5NG+FOL6XUyRdg675a/C+Fcvld9jIE7K6Gpryb+jUzHg8CcFbJyt7w AqHRI1KWjyxLnukoL4RObhx6HJ1TYkA= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=vsBXmbIBGjgL8OAsP8lhIU5HpuKdHOAcVbKVff35yq0=; b=rkSXXrRqZSDngZsXaXS1lbcvKi QcxZl8fRtvl2u5og3DaZCgWwOd8wNJiUmPuNozZFhK4Rp2yqmIrBH6RtwP++DppbgOZSGlhwnIezt e1vasqNE2W4aZU+QTDwKwQiw25UEVta9LR0f40lR26wYW8zzUOaRhROTU2QP+RCM811qjbWcygzK2 7Vuyv70yxpieq2E6NKpJanmkNqbcKLdBa6fsqSwE7FViFyinr4zEmkSFCp68hihuKk5XIqq9+GNHL fGl5oRgErGTMT2HUat8VgevjzrG6L30Rgiwy1OXl6ZCChibpTt3+MbcOEm7yqywAdIuemdd9xrcze 90jN3SXw==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1qX5js-00BPVC-MY; Fri, 18 Aug 2023 20:06:32 +0000 From: "Matthew Wilcox (Oracle)" To: Andrew Morton Cc: "Matthew Wilcox (Oracle)" , linux-mm@kvack.org, Mike Rapoport , linux-doc@vger.kernel.org, cgroups@vger.kernel.org Subject: [PATCH 3/4] mm: Fix clean_record_shared_mapping_range kernel-doc Date: Fri, 18 Aug 2023 21:06:29 +0100 Message-Id: <20230818200630.2719595-4-willy@infradead.org> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20230818200630.2719595-1-willy@infradead.org> References: <20230818200630.2719595-1-willy@infradead.org> MIME-Version: 1.0 X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: 92C1840005 X-Stat-Signature: e3aoyb33rwzcw3s5eigirdg499pmsew6 X-Rspam-User: X-HE-Tag: 1692389206-930601 X-HE-Meta: U2FsdGVkX18oT+l5v15Op0NysL1Lbi07vbiGPbZT2Bl0+DyinngKC0LCpb+UX3+xnD/1qpYn4TzcFRYI+rHkyr+vIJl1faHBjEHWqvE3NHq3vLLscyXUjoVP+Qe5CE+cZKGrvce296Ts1ZX+lu/IrRyOVRIwlp9CZx/+VMk9l9eLtVvJrwiEJIHae+3852yOnxY8OJe3NLZC9Dv0IbhobLH31zIdxa2I4100kcoaZkEnO19wq1Kc/0MrtE0+UcpuVDXBD7yB/B5m6M4ze56IPxpeTRb5vwxvKC7Bw4igFWHVpjDw6IVVFUGxjBxcrTh+a5/mLpfmVEqrU6kFKsNANtQE4AG9ZVhjXOruyV0Gr02RqK1E8HYcoEHG//jEu4rcAjThlInGcTH9Hf2xGijDH8ScMDGnLx2iKMZJpu/L8OOsxQ2fRHajGypE+DaWk31Gg3JfsCSWSyx+OzYfEri4+NNan89clpZ77FW5VWUc/O5BRGDj94OuRgR+hmWtY7nMOtBBw9cb2nxZj3DTtU+wc9ykLXqzzpX8r+rtiFXSJ1+ELHKxl9cWfWl3sL+T0X/0ioGaU0xaFm8YBfd9LBkuT6cIPZh7k16U7MbpwTOQ0TOC55o2IxYDjjUTV9Sc5Oaamsa7YpqJUeAyuhZvkMQtpwNClt34er1Ss0YPvUoqqKRsYVHNc8W4deMsmcLzcfdMicMVeFNc995gat76titOBlJ7UwGmIKxFTy2jX6KNwc7QNLWdaUDBL7nGgjyaLDyn6th74HbOW7gS2mXg9C8oPTckrxuVNPP+w0v/YSVSCiu/ge6jxPR5jeouxNtqSC3b4u31wiuhhgMlsndg+eFxKActt5RVvSvg4G58OEAIw06qYomnH5Li/4zxl4uXKBNcTjM+gb4e7QPc2u/ldDnKCGOGDcAyAi73UAs6iyDBR7kQ5omRS4zadUPaosI69O1qNW403+e/QX6cCE/Sj8Y 7UYA7YKn XIkPc2sA6J+sp+cqGawqGLQTjSkCw5yAZ7vp2p7HqSOlOx7eaK3nR413x8rjnsXzBdT/3CbLgM0402AT6SY5omY1cVRdkMJFeuIvCOq1yix+Rx9T8/14lO2u4THdv1IIuNuUq2VWxtKqRGRAbQPcjXdllZEJHn4GUYNySDAf52kzQ/wJz6cLYeQQrOgSg5SHWuez9CJN4I4dkKK7YQ5AJdJ4rmD8FsK6lwTsP 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: Turn the a), b) into an unordered ReST list and remove the unnecessary 'Note:' prefix. Signed-off-by: Matthew Wilcox (Oracle) Acked-by: Randy Dunlap Acked-by: Mike Rapoport (IBM) --- mm/mapping_dirty_helpers.c | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/mm/mapping_dirty_helpers.c b/mm/mapping_dirty_helpers.c index a26dd8bcfcdb..2f8829b3541a 100644 --- a/mm/mapping_dirty_helpers.c +++ b/mm/mapping_dirty_helpers.c @@ -288,13 +288,14 @@ EXPORT_SYMBOL_GPL(wp_shared_mapping_range); * @end: Pointer to the number of the last set bit in @bitmap. * none set. The value is modified as new bits are set by the function. * - * Note: When this function returns there is no guarantee that a CPU has + * When this function returns there is no guarantee that a CPU has * not already dirtied new ptes. However it will not clean any ptes not * reported in the bitmap. The guarantees are as follows: - * a) All ptes dirty when the function starts executing will end up recorded - * in the bitmap. - * b) All ptes dirtied after that will either remain dirty, be recorded in the - * bitmap or both. + * + * * All ptes dirty when the function starts executing will end up recorded + * in the bitmap. + * * All ptes dirtied after that will either remain dirty, be recorded in the + * bitmap or both. * * If a caller needs to make sure all dirty ptes are picked up and none * additional are added, it first needs to write-protect the address-space From patchwork Fri Aug 18 20:06:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 13358303 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 EDC49EE498F for ; Fri, 18 Aug 2023 20:06:40 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 54C24940074; Fri, 18 Aug 2023 16:06:40 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4FD2E940012; Fri, 18 Aug 2023 16:06:40 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3C536940074; Fri, 18 Aug 2023 16:06:40 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id E6E69940012 for ; Fri, 18 Aug 2023 16:06:39 -0400 (EDT) Received: from smtpin13.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id B49771CA310 for ; Fri, 18 Aug 2023 20:06:39 +0000 (UTC) X-FDA: 81138308118.13.68B74E5 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf15.hostedemail.com (Postfix) with ESMTP id 97784A0023 for ; Fri, 18 Aug 2023 20:06:35 +0000 (UTC) Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=fOFUrOiJ; dmarc=none; spf=none (imf15.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692389197; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=HEUqudgPIORhVtUepujoEAHkjLRlCh4kIh4ylDVS334=; b=NRn+lo3L5DO0XRl8qumxccTizg9GvwNcQeUvTe3+7+RiZ1fzkKbI8ZE/BaskvaG8CBo+2V hdOQLKxyYcdF4+28+v033KCaOrAqfXffkz0hTgvk92N8wot4CuN4Kb9NxxhRVjMeztPncL BpSm6AeuBIgzhKP/VwJB2QYJugQXXao= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=fOFUrOiJ; dmarc=none; spf=none (imf15.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692389197; a=rsa-sha256; cv=none; b=kg1JiZhIVnm+NVzfROL4b4SS2wJwZP8DbKzvNge2FowH322cxiN+L9nssCkJ+dM68APzEG frammFNCCtbSNHUpOf/Es78zBW31Iqgb4Z/IJfSVVUOPtPAnLruup0ZQCoopmouhDqNR6j 1xR2+nJFAYBAB+zsaLUr5FWx028viH8= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=HEUqudgPIORhVtUepujoEAHkjLRlCh4kIh4ylDVS334=; b=fOFUrOiJoU+PYtWXIoWPp0biHN 1Iq2DbevP7Pj0Xo/lF1SpR5VllaM/JQGPznG3Hqk5Xwy0HQgNVBF0kqx56qtEkZ9YveSgLQD5ltey HeNAHPvW1If7K5JSc3kmmXIjsUGO4iKiKBZQUwC3r8p9h2WDYgK3axUogZZCbsRn9hyNh1W20nr5P jSNtiUDZRYo/5plPR1Q6xFGlrqFsptza3FrnkXM1My+Io2Fq3aTUTxMGlURxE9wEeOvYOOEmk1ZYz VuC0LdL2kbXOmnQwLGUSJJ+Ewit+QsdinLFP3OXV0FInJsbi4m5MR5SvQm02k8nwnErrrcqgx38am qKtG6Lqw==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1qX5js-00BPVE-PK; Fri, 18 Aug 2023 20:06:32 +0000 From: "Matthew Wilcox (Oracle)" To: Andrew Morton Cc: "Matthew Wilcox (Oracle)" , linux-mm@kvack.org, Mike Rapoport , linux-doc@vger.kernel.org, cgroups@vger.kernel.org Subject: [PATCH 4/4] mm: Add orphaned kernel-doc to the rst files. Date: Fri, 18 Aug 2023 21:06:30 +0100 Message-Id: <20230818200630.2719595-5-willy@infradead.org> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20230818200630.2719595-1-willy@infradead.org> References: <20230818200630.2719595-1-willy@infradead.org> MIME-Version: 1.0 X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: 97784A0023 X-Stat-Signature: 9urd4f64j4rpbkrcoqjoc1tytkcwtgoa X-Rspam-User: X-HE-Tag: 1692389195-852095 X-HE-Meta: U2FsdGVkX1+Da0DFP7GH43EFmQgfmih7Xn8dpLyzIEbs4Z/nwVqHZX/+Zam8a8HuNgTpqGGlETH8MuhCGea9IHTEPILJNKp7fLWXq4PyHQezaZzj12qMrxh63SuBp1Mn0uOWwx13+/CzXxR3h3kP55jOG4Rh6/P9aBPFM/LYSWvbh0x8kw0MCW6jV33zk69cnnErF465SC0ipp3pfjHa/MgJ7M5oT2fngNMeWuFdrfc/AXXEh7od5Et/fFGYzGCap4PLEEDDouMeqhf/QIZH41cBDg2hSWqXYLAqc4e/6V5YKr4+atbksN9YgEpA4wotHUDe5sk0hK5N/IRk3XTAAwSTe7tMFraKRSLyltZjHSH1DfFMCMXd09PfvYjUznirWmy9g2K8e6afN/WT9UHBj23ce3tZSpI+PH8jk+C2jJeeGI4tHTOFwD025Uei/j3DjR9Aay705F4rjJKIJkqro3q74PV8tukq0UG0tgxzJRliyTAsSfig+Aup7PiAcKPtAXp8nlUvSw4+zz2Hv3yQHV4lfkpx/lfcGHujFiwoJ+2KJjjZEAbD4DF+Q7eKlYNm1bpX5azJlYNnWMM4uLlqgzxbTUloQ3vZhWH9nvIMpCSK/DHUva6/A6SRYo+/wx6OsiF8WcJGJRgcVs+OTKcNu8IQaGM3RYw3otHjKBhzgd6vJ9hEnmE9tLMbWNVF7jz+xIWYltsEQ51MEy7jj9ZBOnAGDR3VdOz3xLJbkTjZOh7im/vnNDEYNPngRJsRi0nob7LGBSDflM3fiPMtNgyvys3SZLeLIZByqqzpvSM+DWj4mW50eetz/pvNtbgIIBI+3+1L2EawALPDt83cKPv7WaIUb6tpwUu/rAR9VVvOkSul3HR7RyPAyfcmx5ad8lkTiYuen+NVvFp3skaSnzxp3U57lOBV5RiIyrmhKdyZkR5tjsMi1z2pNxrNLet2g2ZDBkJPjHR2Zi91gj6DIui UUwqx40L OneICyP+Ce7a+2Edig23jfLp6COvBOi4KFlkFA8hTiWmtc0EgKDKWLR54JTILr+ua8tJHyOdFZlrGJ1IvT67LZSsmUwXLbFf65u26mYxY2HB/zj9p0IS6slDkRK7c3myAaG04/FoZFCixXqX6+pA7zIXsQbYnZw/uaJhukHLTWXQf45oAjcdVfgOF3GxF4QYi6jAda7dkjXzoBQU6Y+OF5dx39OTxfSd1kXJLcv/Nbv4tZRg= 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: There are many files in mm/ that contain kernel-doc which is not currently published on kernel.org. Some of it is easily categorisable, but most of it is going into the miscellaneous documentation section to be organised later. Some files aren't ready to be included; they contain documentation with build errors. Or they're nommu.c which duplicates documentation from "real" MMU systems. Those files are noted with a # mark (although really anything which isn't a recognised directive would do to prevent inclusion) Signed-off-by: Matthew Wilcox (Oracle) Acked-by: Mike Rapoport (IBM) --- Documentation/core-api/mm-api.rst | 25 +++++++++++++++++++++++++ Documentation/mm/highmem.rst | 1 + Documentation/mm/zsmalloc.rst | 5 +++++ 3 files changed, 31 insertions(+) diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst index f5dde5bceaea..2d091c873d1e 100644 --- a/Documentation/core-api/mm-api.rst +++ b/Documentation/core-api/mm-api.rst @@ -115,3 +115,28 @@ More Memory Management Functions .. kernel-doc:: include/linux/mmzone.h .. kernel-doc:: mm/util.c :functions: folio_mapping + +.. kernel-doc:: mm/rmap.c +.. kernel-doc:: mm/migrate.c +.. kernel-doc:: mm/mmap.c +.. kernel-doc:: mm/kmemleak.c +.. #kernel-doc:: mm/hmm.c (build warnings) +.. kernel-doc:: mm/memremap.c +.. kernel-doc:: mm/hugetlb.c +.. kernel-doc:: mm/swap.c +.. kernel-doc:: mm/zpool.c +.. kernel-doc:: mm/memcontrol.c +.. #kernel-doc:: mm/memory-tiers.c (build warnings) +.. kernel-doc:: mm/shmem.c +.. kernel-doc:: mm/migrate_device.c +.. #kernel-doc:: mm/nommu.c (duplicates kernel-doc from other files) +.. kernel-doc:: mm/mapping_dirty_helpers.c +.. #kernel-doc:: mm/memory-failure.c (build warnings) +.. kernel-doc:: mm/percpu.c +.. kernel-doc:: mm/maccess.c +.. kernel-doc:: mm/vmscan.c +.. kernel-doc:: mm/memory_hotplug.c +.. kernel-doc:: mm/mmu_notifier.c +.. kernel-doc:: mm/balloon_compaction.c +.. kernel-doc:: mm/huge_memory.c +.. kernel-doc:: mm/io-mapping.c diff --git a/Documentation/mm/highmem.rst b/Documentation/mm/highmem.rst index fe68e02fc8ff..9d92e3f2b3d6 100644 --- a/Documentation/mm/highmem.rst +++ b/Documentation/mm/highmem.rst @@ -209,4 +209,5 @@ Functions ========= .. kernel-doc:: include/linux/highmem.h +.. kernel-doc:: mm/highmem.c .. kernel-doc:: include/linux/highmem-internal.h diff --git a/Documentation/mm/zsmalloc.rst b/Documentation/mm/zsmalloc.rst index a3c26d587752..76902835e68e 100644 --- a/Documentation/mm/zsmalloc.rst +++ b/Documentation/mm/zsmalloc.rst @@ -263,3 +263,8 @@ is heavy internal fragmentation and zspool compaction is unable to relocate objects and release zspages. In these cases, it is recommended to decrease the limit on the size of the zspage chains (as specified by the CONFIG_ZSMALLOC_CHAIN_SIZE option). + +Functions +========= + +.. kernel-doc:: mm/zsmalloc.c