From patchwork Thu Mar 14 16:16:19 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Qian Cai X-Patchwork-Id: 10853273 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 4EFFA1515 for ; Thu, 14 Mar 2019 16:16:39 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 35FFD2A5E9 for ; Thu, 14 Mar 2019 16:16:39 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 28D662A5EB; Thu, 14 Mar 2019 16:16:39 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.2 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 7DD7F2A5E9 for ; Thu, 14 Mar 2019 16:16:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To: References:List-Owner; bh=o67unt9JHF2H9XuftulE2pdz4zgiqMgKXRqPFHDeWPg=; b=Jka XqvoBytq7BIU20fkJj7vvhToXySidlhvd1SxV5hIXvvmGPVqnJ9KRx4fB1SVZ+nkK+AFmZXnjicMC 40w0O9Gh/ajRPHfGEgmsKqEo4uvZHA48aa4aWkHNes+lGyOPXQMKwbGqA9PQnxLhLDUx+GLxlruAu 0Nd1obzwKjcxs4jf6OcSJ1Sc9Fu8Q9whvZxVFc5NBePnvhNma3TcSIDfPT+tUq6/e4YpIqifH+e3s XzE1gQ9KgCTh6gOD3Q7Dffvo8bpskE2mG1Y8+HCcrzqB4niZHVdDN1w4CL4TN1NXduU8JS2vNDpcv K8uxA+9MtFt23r3WZ3awmQnW5ePDk1A==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1h4T25-0002ch-5g; Thu, 14 Mar 2019 16:16:37 +0000 Received: from mail-qt1-x841.google.com ([2607:f8b0:4864:20::841]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1h4T20-0002bw-Fv for linux-arm-kernel@lists.infradead.org; Thu, 14 Mar 2019 16:16:34 +0000 Received: by mail-qt1-x841.google.com with SMTP id w30so1391759qta.8 for ; Thu, 14 Mar 2019 09:16:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lca.pw; s=google; h=from:to:cc:subject:date:message-id; bh=QQNK9efwVJSB5uWRv4DAz7KZYo3HiH/2ic9hILiosDs=; b=ZLFBQ9krK541EM+bNOaYVDfMPUfeqwoUd3z2SaG0VFLqHe0jIjso43DCHNErb2tFe+ TVerLtNhGW9uIV2t5yRm6nrNCyMCkVxkSU7Swa2DJKByUOfPKKlmEOJOcVwtRe7nv8oq tAVs/S90AGI4uvrwzaSI2PMAB1G8VolV5DONPwGhCNIFX2DZBEN3aLiZiuXLRySyR50z mtxzXO8m9Uh1l3D2Lbyg3rQxlCFSbrbkzp+U2K+R9OWl2239+C0bvPHo+y9pmAvAM2vM W5MuxBPiCNGihuv5fDfbQqqAP1BvPC2JWBlpSQYpL3uC3Y0H55ebrWk6H63pIJCz3yfK LX6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=QQNK9efwVJSB5uWRv4DAz7KZYo3HiH/2ic9hILiosDs=; b=nr/d1/bI5Vm/y/JgBLvRSBhJx/GhDiej3cAxsp5aWQZD6NmNz9bNtvn8k68Fyt4AqC 0x3z2JLnqptoPJFKcaJKGrnx1sZ9r0q2xJLhiWWsFz5mfgmvLl/E7cLxWk7vt+phapPh mBzHLYLOZWn3wsWj+832yqAjLOlBIx4MbGrguLfaLG2I+ctlXCUus1x0TLvAngu8+KpH fEGSG1lCpVwCCR178sSqBltUJHZCyMWXg8IOnzxKqbiSD+9XLoXb/zxSQ4aA1c2ic9s+ KuvBhq0dK0owBqIGxv/IUfk5B36kcGqySkAz3ZxyAECCw9yxL3AD4YrXFN5EdF8je8K0 KZQQ== X-Gm-Message-State: APjAAAX9720KOR+nGOAEW0suCcwasEcAsuLCTTNjrnt1c93aNiglWQYD Zr9gyonmAlqsDkpBFTNsnvwnGQ== X-Google-Smtp-Source: APXvYqxaqnmJcuTJMYnkCI7zUdnrYaFofUNmxXXia2QIbvVj4gcell+/qSFrzIgPgXfa6FnG4gL/mg== X-Received: by 2002:ac8:2b51:: with SMTP id 17mr38804708qtv.328.1552580190237; Thu, 14 Mar 2019 09:16:30 -0700 (PDT) Received: from ovpn-121-103.rdu2.redhat.com (pool-71-184-117-43.bstnma.fios.verizon.net. [71.184.117.43]) by smtp.gmail.com with ESMTPSA id x15sm8710530qts.21.2019.03.14.09.16.29 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 14 Mar 2019 09:16:29 -0700 (PDT) From: Qian Cai To: catalin.marinas@arm.com, will.deacon@arm.com Subject: [PATCH] arm64/mm: fix kernel-doc comments Date: Thu, 14 Mar 2019 12:16:19 -0400 Message-Id: <20190314161619.59909-1-cai@lca.pw> X-Mailer: git-send-email 2.17.2 (Apple Git-113) X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20190314_091632_581286_E96459D3 X-CRM114-Status: GOOD ( 14.26 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Qian Cai , linux-arm-kernel@lists.infradead.org, gkulkarni@cavium.com, linux-kernel@vger.kernel.org MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP Build a kernel with W=1 generated several warnings due to abuse of kernel-doc comments, so tidy up comments there a bit. arch/arm64/mm/numa.c:281: warning: Cannot understand * on line 281 - I thought it was a doc line Fixes: 1a2db300348b ("arm64, numa: Add NUMA support for arm64 platforms.") Signed-off-by: Qian Cai --- arch/arm64/mm/numa.c | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/arch/arm64/mm/numa.c b/arch/arm64/mm/numa.c index 06a6f264f2dd..5202f63c29c9 100644 --- a/arch/arm64/mm/numa.c +++ b/arch/arm64/mm/numa.c @@ -124,7 +124,7 @@ static void __init setup_node_to_cpumask_map(void) } /* - * Set the cpu to node and mem mapping + * Set the cpu to node and mem mapping */ void numa_store_cpu_info(unsigned int cpu) { @@ -200,7 +200,7 @@ void __init setup_per_cpu_areas(void) #endif /** - * numa_add_memblk - Set node id to memblk + * numa_add_memblk() - Set node id to memblk * @nid: NUMA node ID of the new memblk * @start: Start address of the new memblk * @end: End address of the new memblk @@ -223,7 +223,7 @@ int __init numa_add_memblk(int nid, u64 start, u64 end) return ret; } -/** +/* * Initialize NODE_DATA for a node on the local memory */ static void __init setup_node_data(int nid, u64 start_pfn, u64 end_pfn) @@ -257,7 +257,7 @@ static void __init setup_node_data(int nid, u64 start_pfn, u64 end_pfn) NODE_DATA(nid)->node_spanned_pages = end_pfn - start_pfn; } -/** +/* * numa_free_distance * * The current table is freed. @@ -277,10 +277,8 @@ void __init numa_free_distance(void) numa_distance = NULL; } -/** - * +/* * Create a new NUMA distance table. - * */ static int __init numa_alloc_distance(void) { @@ -311,7 +309,7 @@ static int __init numa_alloc_distance(void) } /** - * numa_set_distance - Set inter node NUMA distance from node to node. + * numa_set_distance() - Set inter node NUMA distance from node to node. * @from: the 'from' node to set distance * @to: the 'to' node to set distance * @distance: NUMA distance @@ -321,7 +319,6 @@ static int __init numa_alloc_distance(void) * * If @from or @to is higher than the highest known node or lower than zero * or @distance doesn't make sense, the call is ignored. - * */ void __init numa_set_distance(int from, int to, int distance) { @@ -347,7 +344,7 @@ void __init numa_set_distance(int from, int to, int distance) numa_distance[from * numa_distance_cnt + to] = distance; } -/** +/* * Return NUMA distance @from to @to */ int __node_distance(int from, int to) @@ -422,13 +419,15 @@ static int __init numa_init(int (*init_func)(void)) } /** - * dummy_numa_init - Fallback dummy NUMA init + * dummy_numa_init() - Fallback dummy NUMA init * * Used if there's no underlying NUMA architecture, NUMA initialization * fails, or NUMA is disabled on the command line. * * Must online at least one node (node 0) and add memory blocks that cover all * allowed memory. It is unlikely that this function fails. + * + * Return: 0 on success, -errno on failure. */ static int __init dummy_numa_init(void) { @@ -454,9 +453,9 @@ static int __init dummy_numa_init(void) } /** - * arm64_numa_init - Initialize NUMA + * arm64_numa_init() - Initialize NUMA * - * Try each configured NUMA initialization method until one succeeds. The + * Try each configured NUMA initialization method until one succeeds. The * last fallback is dummy single node config encomapssing whole memory. */ void __init arm64_numa_init(void)