From patchwork Thu Jun 17 20:43:23 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 12329521 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=-16.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT 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 A8D86C2B9F4 for ; Thu, 17 Jun 2021 20:44:19 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 42481613FE for ; Thu, 17 Jun 2021 20:44:19 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 42481613FE Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 89B0B6B0070; Thu, 17 Jun 2021 16:44:18 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 824266B0071; Thu, 17 Jun 2021 16:44:18 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 6A0BF6B0072; Thu, 17 Jun 2021 16:44:18 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0053.hostedemail.com [216.40.44.53]) by kanga.kvack.org (Postfix) with ESMTP id 324A26B0070 for ; Thu, 17 Jun 2021 16:44:18 -0400 (EDT) Received: from smtpin08.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay03.hostedemail.com (Postfix) with ESMTP id C472C8248D51 for ; Thu, 17 Jun 2021 20:44:17 +0000 (UTC) X-FDA: 78264393354.08.820396C Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf26.hostedemail.com (Postfix) with ESMTP id 3E4574202A0A for ; Thu, 17 Jun 2021 20:44:17 +0000 (UTC) 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: Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:Content-ID: Content-Description:In-Reply-To:References; bh=TGQuTGgAWX1MM2s4JV1XEEtRQArGGvuBOcpKDMQ5/Nc=; b=BYHggXlPKzcsmbzFerS/z59nzR Z744Xj99f9e4UCQq4DebaUN3nuLpq90UoaRa6XyvIhI9OTqbKsLln7Xm68ajNapaAyc7TgWE9ar99 Cv1s7xYsF6wmkkENy8sB2y4v6JZ8RnWrE8Ps36IEOwqbjktViDf1J3E7sVvdQnqa9++yN7czhMFgP h1h9Caq9YBM+PYBtJhtr+xR49S13YlXfHGNa1VQ6wLH9IU2fJ506ESkJ7E0hnCbrDQCgJrlorQDXm s8crUJ/V8OjSs+AzK8c+vJ28IIuEVEtzGxd11aIeyh3mePYaO0HWnHicuJbsdXwuqXaPl3NVqGhef QwBbimgQ==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1ltyrK-009Yoa-52; Thu, 17 Jun 2021 20:43:47 +0000 From: "Matthew Wilcox (Oracle)" To: linux-mm@kvack.org, linux-doc@vger.kernel.org Cc: "Matthew Wilcox (Oracle)" Subject: [PATCH 1/3] mm/doc: Include compressed memory kernel-doc Date: Thu, 17 Jun 2021 21:43:23 +0100 Message-Id: <20210617204325.2278730-1-willy@infradead.org> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Authentication-Results: imf26.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=BYHggXlP; spf=none (imf26.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none X-Stat-Signature: 9r1wf3o4jc4mo5igrp9gu8bhtgb4hp5u X-Rspamd-Queue-Id: 3E4574202A0A X-Rspamd-Server: rspam06 X-HE-Tag: 1623962657-226754 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: People have gone to a lot of trouble to write all this documentation; include it as part of the htmldocs. Signed-off-by: Matthew Wilcox (Oracle) --- Documentation/vm/z3fold.rst | 5 +++++ Documentation/vm/zsmalloc.rst | 7 +++++++ 2 files changed, 12 insertions(+) diff --git a/Documentation/vm/z3fold.rst b/Documentation/vm/z3fold.rst index 224e3c61d686..1e1fd3c46290 100644 --- a/Documentation/vm/z3fold.rst +++ b/Documentation/vm/z3fold.rst @@ -28,3 +28,8 @@ handle which encodes actual location of the allocated object. Keeping effective compression ratio close to zsmalloc's, z3fold doesn't depend on MMU enabled and provides more predictable reclaim behavior which makes it a better fit for small and response-critical systems. + +Functions and structures +======================== + +.. kernel-doc:: mm/z3fold.c diff --git a/Documentation/vm/zsmalloc.rst b/Documentation/vm/zsmalloc.rst index 6e79893d6132..32bda5f31e6b 100644 --- a/Documentation/vm/zsmalloc.rst +++ b/Documentation/vm/zsmalloc.rst @@ -80,3 +80,10 @@ Similarly, we assign zspage to: * ZS_ALMOST_FULL when n > N / f * ZS_EMPTY when n == 0 * ZS_FULL when n == N + +Functions and structures +======================== + +.. kernel-doc:: mm/zsmalloc.c +.. kernel-doc:: mm/zbud.c +.. kernel-doc:: mm/zpool.c From patchwork Thu Jun 17 20:43:24 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 12329523 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=-16.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT 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 1F42DC48BE5 for ; Thu, 17 Jun 2021 20:44:40 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id B9DD4610A7 for ; Thu, 17 Jun 2021 20:44:38 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org B9DD4610A7 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 5409D6B0071; Thu, 17 Jun 2021 16:44:38 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4EF136B0072; Thu, 17 Jun 2021 16:44:38 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 390936B0073; Thu, 17 Jun 2021 16:44:38 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0019.hostedemail.com [216.40.44.19]) by kanga.kvack.org (Postfix) with ESMTP id 02A006B0071 for ; Thu, 17 Jun 2021 16:44:37 -0400 (EDT) Received: from smtpin10.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay05.hostedemail.com (Postfix) with ESMTP id 8B1F5181AEF0B for ; Thu, 17 Jun 2021 20:44:37 +0000 (UTC) X-FDA: 78264394194.10.FCB8175 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf11.hostedemail.com (Postfix) with ESMTP id ECCC6200109D for ; Thu, 17 Jun 2021 20:44:36 +0000 (UTC) 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=8xywp7LiKcGCaFvvwvOAeZj1J6iQDYcpbrJsJxe4LF4=; b=pBisYjD+W/gukGr/TNGVdFUgdL cV651SZgZWQgVFh4IK80PCPCfKnc42/v7cgNVmA6++p0V/dY3De0C8w2m+61WiGMv+f3B7PxhvfRL ptHR+L5pe2oyS6R/VYoOuIFTtEl7580h+NKJ/ByYtE7Fd81asY8Kbp0WQdqlLMf/E23QokxXTSBWM DCo7E94Crd4F1foBsrhNeGos/xbMp87Vzb1Z3T/lv18NnXYNfuKlq4J3sGRo8kIekzj1QnSyQKTJH eNOJUTj+2nwQwuJ26NvCP1oohTilAkeF4CGcqeDo6vKoDSowFkRNNW9FLP2nyQjhJebl9XD/475k4 Y2EB2XDg==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1ltyro-009YpW-NU; Thu, 17 Jun 2021 20:44:08 +0000 From: "Matthew Wilcox (Oracle)" To: linux-mm@kvack.org, linux-doc@vger.kernel.org Cc: "Matthew Wilcox (Oracle)" Subject: [PATCH 2/3] mm/doc: Add some more missing kernel-doc Date: Thu, 17 Jun 2021 21:43:24 +0100 Message-Id: <20210617204325.2278730-2-willy@infradead.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210617204325.2278730-1-willy@infradead.org> References: <20210617204325.2278730-1-willy@infradead.org> MIME-Version: 1.0 Authentication-Results: imf11.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=pBisYjD+; spf=none (imf11.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none X-Stat-Signature: 8qsia4rbspx3od9i6esxd775ikzjoj6b X-Rspamd-Queue-Id: ECCC6200109D X-Rspamd-Server: rspam06 X-HE-Tag: 1623962676-563664 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: All these functions have kernel-doc that's not being included. Signed-off-by: Matthew Wilcox (Oracle) --- Documentation/core-api/mm-api.rst | 4 ++++ Documentation/vm/transhuge.rst | 6 ++++++ 2 files changed, 10 insertions(+) diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst index a42f9baddfbf..e46f01c4b200 100644 --- a/Documentation/core-api/mm-api.rst +++ b/Documentation/core-api/mm-api.rst @@ -66,6 +66,8 @@ File Mapping and Page Cache .. kernel-doc:: mm/page-writeback.c :export: +.. kernel-doc:: mm/backing-dev.c + :export: .. kernel-doc:: mm/truncate.c :export: @@ -93,6 +95,8 @@ More Memory Management Functions .. kernel-doc:: mm/page_alloc.c .. kernel-doc:: mm/mempolicy.c +.. kernel-doc:: mm/vmscan.c + :export: .. kernel-doc:: include/linux/mm_types.h :internal: .. kernel-doc:: include/linux/mm.h diff --git a/Documentation/vm/transhuge.rst b/Documentation/vm/transhuge.rst index 216db1d67d04..550dea445528 100644 --- a/Documentation/vm/transhuge.rst +++ b/Documentation/vm/transhuge.rst @@ -185,3 +185,9 @@ a THP crosses a VMA boundary. The function deferred_split_huge_page() is used to queue a page for splitting. The splitting itself will happen when we get memory pressure via shrinker interface. + +Functions and structures +======================== + +.. kernel-doc:: mm/huge_memory.c +.. kernel-doc:: mm/khugepaged.c From patchwork Thu Jun 17 20:43:25 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthew Wilcox X-Patchwork-Id: 12329525 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=-16.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT 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 F1B43C2B9F4 for ; Thu, 17 Jun 2021 20:44:53 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 9EF38613FE for ; Thu, 17 Jun 2021 20:44:53 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 9EF38613FE Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 42DCC6B0072; Thu, 17 Jun 2021 16:44:53 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3DDA96B0073; Thu, 17 Jun 2021 16:44:53 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 27FD16B0074; Thu, 17 Jun 2021 16:44:53 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0078.hostedemail.com [216.40.44.78]) by kanga.kvack.org (Postfix) with ESMTP id EC0456B0072 for ; Thu, 17 Jun 2021 16:44:52 -0400 (EDT) Received: from smtpin37.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay02.hostedemail.com (Postfix) with ESMTP id 911C21EA2E for ; Thu, 17 Jun 2021 20:44:52 +0000 (UTC) X-FDA: 78264394824.37.E068B9C Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf01.hostedemail.com (Postfix) with ESMTP id 136885001707 for ; Thu, 17 Jun 2021 20:44:51 +0000 (UTC) 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=aHLaziIx2roUv+C+UqM4fNifK6D3E4TjbK3gKooQSwY=; b=nqhBd1ctIJc/X/VbQiq/lhJSaS MZczerdedDQcHDi8hHwigQpC2tZtpqujageiXZf1KcUX+oC84eK9O1RZP21D73D1e7vPeT00b7+2U 05pBzb3VPnlopUgikGJLCNfD/8b79migAZ2AHXIQ5S8XZM387rcGxivSWwCux7ZrShCfWBn55DBkl AJL+B3hqjNddEcWE407psE4OdluNf3s6fO8irCtVi7i/7p2m14MkZ6q5r+HZ8rA2LtNa9cLGZsUtT uSE33X6+Z+/WMg2KJctbV3yQT9Y6CvQ00Vi2w7oeB+yiMldb5rF5evekvHiHc9JdRbrhry/ADT4w1 zHX5I4MQ==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1ltysC-009Yr1-14; Thu, 17 Jun 2021 20:44:30 +0000 From: "Matthew Wilcox (Oracle)" To: linux-mm@kvack.org, linux-doc@vger.kernel.org Cc: "Matthew Wilcox (Oracle)" Subject: [PATCH 3/3] mm/doc: Include percpu documentation in html docs Date: Thu, 17 Jun 2021 21:43:25 +0100 Message-Id: <20210617204325.2278730-3-willy@infradead.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210617204325.2278730-1-willy@infradead.org> References: <20210617204325.2278730-1-willy@infradead.org> MIME-Version: 1.0 X-Rspamd-Server: rspam05 X-Rspamd-Queue-Id: 136885001707 X-Stat-Signature: rb99twofdffs97az1a4rm7uhtgysntq3 Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=nqhBd1ct; 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 X-HE-Tag: 1623962691-563842 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000092, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: The kernel-doc was written, but not included in the html documentation. Signed-off-by: Matthew Wilcox (Oracle) Acked-by: Dennis Zhou --- Documentation/core-api/mm-api.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst index e46f01c4b200..89a53ac00249 100644 --- a/Documentation/core-api/mm-api.rst +++ b/Documentation/core-api/mm-api.rst @@ -87,6 +87,12 @@ DMA pools .. kernel-doc:: mm/dmapool.c :export: +Per-CPU memory allocation +========================= + +.. kernel-doc:: mm/percpu.c + :export: + More Memory Management Functions ================================