From patchwork Tue Sep 22 11:22:52 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 260400 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=-14.6 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, INCLUDES_PATCH, MAILING_LIST_MULTI, SIGNED_OFF_BY,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 85BF8C47420 for ; Tue, 22 Sep 2020 11:23:02 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 3CD7E23A1B for ; Tue, 22 Sep 2020 11:23:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1600773782; bh=g4d13BGuduKPDFBeIc0TlyYXYMgjU5xW76V6a9jLQR8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-ID:From; b=uQzu7xdho93A9L/CupFTF5a+gTGGN6CeZXSC4waSaXMq1j34giqqcPdeMP7KIgdpn tvWg8b4xBx2kGzfyXK81rhX1Vgv91W1AG5jKaaGRHmTzdFC937vhhnd8QDKhWkze6N VCLsKJx6zb0/FQNjHE/43S/4UoUkSh67uj8IYPUw= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726654AbgIVLXB (ORCPT ); Tue, 22 Sep 2020 07:23:01 -0400 Received: from mail.kernel.org ([198.145.29.99]:42108 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726610AbgIVLW7 (ORCPT ); Tue, 22 Sep 2020 07:22:59 -0400 Received: from mail.kernel.org (ip5f5ad5bc.dynamic.kabel-deutschland.de [95.90.213.188]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 4504A238A1; Tue, 22 Sep 2020 11:22:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1600773778; bh=g4d13BGuduKPDFBeIc0TlyYXYMgjU5xW76V6a9jLQR8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=qFAC4RZfT24s/PKljc7ePg9CEg6N48QFIfbVuvW7LSEciDZtp1roeIHpygS8F0xlk 0ACjF6eT9NgVwfNvgrOQdqYrAFMeCbUbnUHQViLke/7l05Cu+6EkKpgVTGyA/srih5 QPlW0Dyz0vLtinRbxAxNYsUbY9iAQiSCje7BZi+8= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kKgNr-0010Kg-Lx; Tue, 22 Sep 2020 13:22:55 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "David S. Miller" , "Jonathan Corbet" , Alexei Starovoitov , Andrii Nakryiko , Cong Wang , Eric Dumazet , Francesco Ruggeri , Jakub Kicinski , Jiri Pirko , Taehee Yoo , linux-kernel@vger.kernel.org, netdev@vger.kernel.org Subject: [PATCH 1/3] net: fix a new kernel-doc warning at dev.c Date: Tue, 22 Sep 2020 13:22:52 +0200 Message-Id: X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org kernel-doc expects the function prototype to be just after the kernel-doc markup, as otherwise it will get it all wrong: ./net/core/dev.c:10036: warning: Excess function parameter 'dev' description in 'WAIT_REFS_MIN_MSECS' Fixes: 0e4be9e57e8c ("net: use exponential backoff in netdev_wait_allrefs") Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Francesco Ruggeri --- net/core/dev.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/net/core/dev.c b/net/core/dev.c index a268ff35ad38..873b50ac9668 100644 --- a/net/core/dev.c +++ b/net/core/dev.c @@ -10021,6 +10021,8 @@ int netdev_refcnt_read(const struct net_device *dev) } EXPORT_SYMBOL(netdev_refcnt_read); +#define WAIT_REFS_MIN_MSECS 1 +#define WAIT_REFS_MAX_MSECS 250 /** * netdev_wait_allrefs - wait until all references are gone. * @dev: target net_device @@ -10033,8 +10035,6 @@ EXPORT_SYMBOL(netdev_refcnt_read); * We can get stuck here if buggy protocols don't correctly * call dev_put. */ -#define WAIT_REFS_MIN_MSECS 1 -#define WAIT_REFS_MAX_MSECS 250 static void netdev_wait_allrefs(struct net_device *dev) { unsigned long rebroadcast_time, warning_time;