From patchwork Mon Dec 13 23:32:16 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 12674847 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 A2E98C433F5 for ; Mon, 13 Dec 2021 23:32:44 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id EE8A86B0071; Mon, 13 Dec 2021 18:32:33 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id E70F36B0072; Mon, 13 Dec 2021 18:32:33 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D12016B0074; Mon, 13 Dec 2021 18:32:33 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0111.hostedemail.com [216.40.44.111]) by kanga.kvack.org (Postfix) with ESMTP id BBED86B0071 for ; Mon, 13 Dec 2021 18:32:33 -0500 (EST) Received: from smtpin18.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay04.hostedemail.com (Postfix) with ESMTP id 76AA38531A for ; Mon, 13 Dec 2021 23:32:23 +0000 (UTC) X-FDA: 78914372166.18.63C77C2 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) by imf09.hostedemail.com (Postfix) with ESMTP id E3B5214000C for ; Mon, 13 Dec 2021 23:32:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; 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=c6NimEb8nacoHNojq40XEIvYJUQz1Ji4kxQJAHaPodA=; b=lj2tglKSjGriJk6hAspc31tOJT QSugY5TIYWXHahXixBRndH7Auzlqt25u+3SAOxPNpvFsJlAeOX7juqSHO5EsGDiHo+Q27YUfmp5xs Py6OcrunoiZNa8yGqk2cTgBou/TlaQCkBptpSnvxfZObyE1LFJBKy6gRbsDZczT8cugVQpWDJlu2l 8+ZPMOWVKnzCoS1QudRv93J40XXeZL4ibeVYfu3Dye80OWCZOkqE2G+oQmk5XQDnOEFUMQA4KvjxX fzqZaD+Dz5GqTwo7IpQxJnhaADnX2EseGr5mkOmLoC0udK/FgJtq8mK8QPfxNCf/83aZLitxDUajD U4bTN9nA==; Received: from [2601:1c0:6280:3f0::aa0b] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1mwunr-00BzPI-9i; Mon, 13 Dec 2021 23:32:19 +0000 From: Randy Dunlap To: linux-mm@kvack.org Cc: Randy Dunlap , Andrew Morton Subject: [PATCH -mm -next] mm/mempolicy: fix all kernel-doc warnings Date: Mon, 13 Dec 2021 15:32:16 -0800 Message-Id: <20211213233216.5477-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Authentication-Results: imf09.hostedemail.com; dkim=pass header.d=infradead.org header.s=bombadil.20210309 header.b=lj2tglKS; dmarc=none; spf=none (imf09.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 198.137.202.133) smtp.mailfrom=rdunlap@infradead.org X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: E3B5214000C X-Stat-Signature: fbck66iyp37q6mxewy8g6wjopqdqqprg X-HE-Tag: 1639438338-130854 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: Fix kernel-doc warnings in mempolicy.c: mempolicy.c:139: warning: No description found for return value of 'numa_map_to_online_node' mempolicy.c:2165: warning: Excess function parameter 'node' description in 'alloc_pages_vma' mempolicy.c:2973: warning: No description found for return value of 'mpol_parse_str' Signed-off-by: Randy Dunlap Cc: Andrew Morton --- mm/mempolicy.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) --- next-2021-1210.orig/mm/mempolicy.c +++ next-2021-1210/mm/mempolicy.c @@ -134,6 +134,8 @@ static struct mempolicy preferred_node_p * @node: Node id to start the search * * Lookup the next closest node by distance if @nid is not online. + * + * Return: this @node if it is online, otherwise the closest node by distance */ int numa_map_to_online_node(int node) { @@ -2150,7 +2152,6 @@ static struct page *alloc_pages_preferre * @order: Order of the GFP allocation. * @vma: Pointer to VMA or NULL if not available. * @addr: Virtual address of the allocation. Must be inside @vma. - * @node: Which node to prefer for allocation (modulo policy). * @hugepage: For hugepages try only the preferred node if possible. * * Allocate a page for a specific address in @vma, using the appropriate @@ -2967,7 +2968,7 @@ static const char * const policy_modes[] * Format of input: * [=][:] * - * On success, returns 0, else 1 + * Return: %0 on success, else %1 */ int mpol_parse_str(char *str, struct mempolicy **mpol) {