From patchwork Fri Jan 15 20:08:59 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 363747 Delivered-To: patch@linaro.org Received: by 2002:a02:ccad:0:0:0:0:0 with SMTP id t13csp171148jap; Fri, 15 Jan 2021 12:11:52 -0800 (PST) X-Google-Smtp-Source: ABdhPJzyjpihAqtOUM4i3e5MC5z5HVmr7MxrCStPbcSLJJ0hlHYgudHSB18KFJmLjBjoa8zr8s7p X-Received: by 2002:aa7:c802:: with SMTP id a2mr10801073edt.120.1610741512017; Fri, 15 Jan 2021 12:11:52 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1610741512; cv=none; d=google.com; s=arc-20160816; b=Ipzp35oV8F63tl/fDDb6WzQdKhI0b8/oCHQl9g0xW5U08WFyqVWwkQupmBsFnBulwq ZImcwGUDKw7mF78IIBMqrIH75FhrstoJtoLG859EGkmj65CGRJtBRu/xHGxLUarUhPag CoJkpbauQl420vUi65Njh9SQPqIV949dfsiPTWRe5wD+je/LPaF2pfv5lIiOVlU0I68b SS3kdwNKzpHiA2yo8nEpSiSwh2ZHJChsllR7HqmxPNAaE5Jn9zlUdYGRjGJPEF5jptZv 9rjXodDx3iWgLmjng2QGR9smhCDqGmnu6ApyrPOas+IBRhVca7f2xwxBlRjpQxJrINjS lKqA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=ruuzqVcibszll2eFO33TUxrB4tXdgXcWaZZEtfFtK0U=; b=JYRIW4GfRzYMpztwL8f2t/PONooTmohz4ZdMwsuPYuMpgOF0yIz6eiP1w7jAMzxbzW 3AV4A48LOgtVzulpVSIHs+sdrTSAqVjk6H5mGdQG/vCtLDEqlqBM4RJmSel5bOKqsI0+ u8C2HQ1fA1UWwX3TjOkYXUHm1dRagBRTa4iim4w47fMd03moCt2sTGR5p6f9yr150vog Ehs4LH9OPqbSCT7b9kHFDX4a2onmCkydcC9R7jCjmT7dTsU0yq1YToIGAJ4HL1v9OyWm vJYdY2l+hCqeWjuNC1N2tR3w5jikNQ889MVcb2y0tTPxkLZbCJwflJUh9CkE0qyePcuE bZcw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=K0QIJJrt; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v3si4089359eje.650.2021.01.15.12.11.51; Fri, 15 Jan 2021 12:11:52 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=K0QIJJrt; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388231AbhAOUKb (ORCPT + 7 others); Fri, 15 Jan 2021 15:10:31 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53172 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727278AbhAOUJ5 (ORCPT ); Fri, 15 Jan 2021 15:09:57 -0500 Received: from mail-wm1-x32c.google.com (mail-wm1-x32c.google.com [IPv6:2a00:1450:4864:20::32c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0A710C061794 for ; Fri, 15 Jan 2021 12:09:17 -0800 (PST) Received: by mail-wm1-x32c.google.com with SMTP id k10so8473123wmi.3 for ; Fri, 15 Jan 2021 12:09:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=ruuzqVcibszll2eFO33TUxrB4tXdgXcWaZZEtfFtK0U=; b=K0QIJJrtbTVVGnm0417IN5WqEh5ppaxUlhR0OqXfdBdbiKbbRwer5uHYKYJTtXAktz gZZZbU8CVeAvuoa7EVilbQ8aU8UYprMBp5p4uFXlXWES8OaLPrh/7vL3XPX0+52nQF+u q9GKE9sELVG7doX8KkvQ0b023p8qEDOF8KJPtEERAgZnhE+A5t0UHh15EIcRYASV5oix HLry1ARTaBQiDDOB3mDQuMcltIu00Xjswrs8gGEQTjmXfkBz65sq1E82JK49LYpUh5wE QkXeVB5s/d03vawDvs/XAtoNa5DI0QNCH8+HYQTP2g5sg1Xt+5qJ2XKUJfHyxCQkhMX5 WKzg== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=ruuzqVcibszll2eFO33TUxrB4tXdgXcWaZZEtfFtK0U=; b=A7B0IzRqgNgSuwQ7qHG4R2syN5dzhl5zYmDX3fiEs9BlhaOjHEAt009pPd3yISplf4 ZtIO77q/n3c64JIv4ObWhQikJXBk1oBtgh+1TbdrD+2ABg4hOkmeSK28FEJ4GE4RAbfK 7scnPtvbosPmwxaGE1xsWgzZmGZPIyeeUOQY5bS5+9mfj3UD+wrZqjKIu4c4AbRfQAze G7d5A37qiatcaGWXUFjrWpMmH0E06nA9Jjg5zyUnNjZ9tFhAytBRJWhZ4lUTU60WoTw9 rdD3f72p+JPrVqjmYRcbdRQdyVqp3zDJH8usTsZR9sCm2acWr7MjOLlrbIQyP1V0gc9k GO/A== X-Gm-Message-State: AOAM531FMPT2yQaAKchz1plmHCWwp+5N+RvWfecS4nJrRp/x78RiRRY7 mcaAIGNzhi/egG+u9LxZ325GVg== X-Received: by 2002:a7b:c415:: with SMTP id k21mr8222932wmi.96.1610741355781; Fri, 15 Jan 2021 12:09:15 -0800 (PST) Received: from dell.default ([91.110.221.158]) by smtp.gmail.com with ESMTPSA id d85sm9187863wmd.2.2021.01.15.12.09.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jan 2021 12:09:15 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Nicolas Pitre , "David S. Miller" , Jakub Kicinski , Erik Stahlman , Peter Cammaert , Daris A Nevil , Russell King , netdev@vger.kernel.org Subject: [PATCH 1/7] net: ethernet: smsc: smc91x: Fix function name in kernel-doc header Date: Fri, 15 Jan 2021 20:08:59 +0000 Message-Id: <20210115200905.3470941-2-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210115200905.3470941-1-lee.jones@linaro.org> References: <20210115200905.3470941-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/ethernet/smsc/smc91x.c:2200: warning: Function parameter or member 'dev' not described in 'try_toggle_control_gpio' drivers/net/ethernet/smsc/smc91x.c:2200: warning: Function parameter or member 'desc' not described in 'try_toggle_control_gpio' drivers/net/ethernet/smsc/smc91x.c:2200: warning: Function parameter or member 'name' not described in 'try_toggle_control_gpio' drivers/net/ethernet/smsc/smc91x.c:2200: warning: Function parameter or member 'index' not described in 'try_toggle_control_gpio' drivers/net/ethernet/smsc/smc91x.c:2200: warning: Function parameter or member 'value' not described in 'try_toggle_control_gpio' drivers/net/ethernet/smsc/smc91x.c:2200: warning: Function parameter or member 'nsdelay' not described in 'try_toggle_control_gpio' Cc: Nicolas Pitre Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Erik Stahlman Cc: Peter Cammaert Cc: Daris A Nevil Cc: Russell King Cc: netdev@vger.kernel.org Signed-off-by: Lee Jones --- drivers/net/ethernet/smsc/smc91x.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/net/ethernet/smsc/smc91x.c b/drivers/net/ethernet/smsc/smc91x.c index 742a1f7a838c9..891b49281bc64 100644 --- a/drivers/net/ethernet/smsc/smc91x.c +++ b/drivers/net/ethernet/smsc/smc91x.c @@ -2191,7 +2191,7 @@ static const struct of_device_id smc91x_match[] = { MODULE_DEVICE_TABLE(of, smc91x_match); /** - * of_try_set_control_gpio - configure a gpio if it exists + * try_toggle_control_gpio - configure a gpio if it exists * @dev: net device * @desc: where to store the GPIO descriptor, if it exists * @name: name of the GPIO in DT From patchwork Fri Jan 15 20:09:00 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 364367 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=-18.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_CR_TRAILER, INCLUDES_PATCH, MAILING_LIST_MULTI, SPF_HELO_NONE, SPF_PASS, URIBL_BLOCKED, USER_AGENT_GIT autolearn=unavailable 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 728BDC433E9 for ; Fri, 15 Jan 2021 20:10:43 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 3F66E23A75 for ; Fri, 15 Jan 2021 20:10:43 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388697AbhAOUKd (ORCPT ); Fri, 15 Jan 2021 15:10:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53186 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2388198AbhAOUKF (ORCPT ); Fri, 15 Jan 2021 15:10:05 -0500 Received: from mail-wm1-x32c.google.com (mail-wm1-x32c.google.com [IPv6:2a00:1450:4864:20::32c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DF068C061796 for ; Fri, 15 Jan 2021 12:09:18 -0800 (PST) Received: by mail-wm1-x32c.google.com with SMTP id c124so8462618wma.5 for ; Fri, 15 Jan 2021 12:09:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=aiJUe/D+M6zdYoqU8/tCGnMlqOxFrCNb2GHwWBgB6XE=; b=dSqWxy5oJbUPhoGZ0kJkRd2cNEx5u2GKs2BvohoeKfNCcPJhr2Eu60z6vjzxq/40aN glgoqChgxqONYcrADHOUNx2SAbmIdyugzHGjcwAfK+IGJbWjyqOFoCOnNrJsRyuZ73GM ajB7yxsGQvusQMPlxvi6EQSO7extZO99Jze3AkqqxSQlrR9cBUH7LFx9BHVjWO4NVWZI EiRX3iCscVdNpnfjJCMuIQEvt/MdUGmvt9JbNZuSoBP+A2j09IlgIriYQv58JVaXSLpB eWTUAgMgNSZG8vtSDnHBneQoIxOiEZXrirrBiXBWfYRfCWc7r1+5ZlnwZDhU1hIS7a/5 b5Gg== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=aiJUe/D+M6zdYoqU8/tCGnMlqOxFrCNb2GHwWBgB6XE=; b=Zfsr+k8sNhj9UJELgIQTWATCOUWi/C2FcnaFUMFooIRIQeOc3IhU7fpPGx9a8K1x8q nDU8UDvaR8SMy1D73uTP6zGPCWSTl+gQiOZdk+oZjN/uJa5lZSiksfM/cmT2eGXI6/n8 W3V7yENZ4b/+EpjO620s0lCJpUyjgna1cap/bFntzT+duAiehNwOYx+lXErKlxz9X4sA DdXURptvJbR6A9NEAxynxh3GhquaBeoJGCYBXKOHhxDf8VxpwD6yZkyZbtaV+7w8rnEm ZO522UpjVgVxu2uYjtAuyHJ71WSDarEF7D2NJ5XlluEQv6NV4CWK9KKtm1FrR4xzr8ys Ez/Q== X-Gm-Message-State: AOAM5320uKZMuOIydB75OXizMqMpsCVj01IWAytJ4xzpLgp/1IcNbBnN NYEK8mXNhzXnJw23H4+SMm+oEw== X-Google-Smtp-Source: ABdhPJz6z8ooRqEJMuEtAZ3z0VQGV3ToTw4T17vOw6fkh1inINUIw2LGxPtLCYYvw9uakPUqYWmMKw== X-Received: by 2002:a7b:cb54:: with SMTP id v20mr10484579wmj.148.1610741357695; Fri, 15 Jan 2021 12:09:17 -0800 (PST) Received: from dell.default ([91.110.221.158]) by smtp.gmail.com with ESMTPSA id d85sm9187863wmd.2.2021.01.15.12.09.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jan 2021 12:09:16 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Wei Liu , Paul Durrant , "David S. Miller" , Jakub Kicinski , Alexei Starovoitov , Daniel Borkmann , Jesper Dangaard Brouer , John Fastabend , Rusty Russell , xen-devel@lists.xenproject.org, netdev@vger.kernel.org, bpf@vger.kernel.org, Andrew Lunn Subject: [PATCH 2/7] net: xen-netback: xenbus: Demote nonconformant kernel-doc headers Date: Fri, 15 Jan 2021 20:09:00 +0000 Message-Id: <20210115200905.3470941-3-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210115200905.3470941-1-lee.jones@linaro.org> References: <20210115200905.3470941-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/xen-netback/xenbus.c:419: warning: Function parameter or member 'dev' not described in 'frontend_changed' drivers/net/xen-netback/xenbus.c:419: warning: Function parameter or member 'frontend_state' not described in 'frontend_changed' drivers/net/xen-netback/xenbus.c:1001: warning: Function parameter or member 'dev' not described in 'netback_probe' drivers/net/xen-netback/xenbus.c:1001: warning: Function parameter or member 'id' not described in 'netback_probe' Cc: Wei Liu Cc: Paul Durrant Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Alexei Starovoitov Cc: Daniel Borkmann Cc: Jesper Dangaard Brouer Cc: John Fastabend Cc: Rusty Russell Cc: xen-devel@lists.xenproject.org Cc: netdev@vger.kernel.org Cc: bpf@vger.kernel.org Reviewed-by: Andrew Lunn Signed-off-by: Lee Jones --- drivers/net/xen-netback/xenbus.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/drivers/net/xen-netback/xenbus.c b/drivers/net/xen-netback/xenbus.c index 6f10e0998f1ce..a5439c130130f 100644 --- a/drivers/net/xen-netback/xenbus.c +++ b/drivers/net/xen-netback/xenbus.c @@ -411,7 +411,7 @@ static void read_xenbus_frontend_xdp(struct backend_info *be, vif->xdp_headroom = headroom; } -/** +/* * Callback received when the frontend's state changes. */ static void frontend_changed(struct xenbus_device *dev, @@ -996,7 +996,7 @@ static int netback_remove(struct xenbus_device *dev) return 0; } -/** +/* * Entry point to this code when a new device is created. Allocate the basic * structures and switch to InitWait. */ From patchwork Fri Jan 15 20:09:01 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 363748 Delivered-To: patch@linaro.org Received: by 2002:a02:ccad:0:0:0:0:0 with SMTP id t13csp171171jap; Fri, 15 Jan 2021 12:11:53 -0800 (PST) X-Google-Smtp-Source: ABdhPJzZqdh8V6O7Gw79VIQ5HqXihglCpZL0aHur8L/Zk6fazlzbWPJ71WRvuiD9363F2LJPONj1 X-Received: by 2002:a17:906:9381:: with SMTP id l1mr2639461ejx.433.1610741513316; Fri, 15 Jan 2021 12:11:53 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1610741513; cv=none; d=google.com; s=arc-20160816; b=bn4btWlZvE4Mlw65ohAZyVSL962H5y3YEJfEqOBLkcj8Ko7iJ2d0qd7Gl2NP8hSP31 /hyShH8iJM2qJiIjdL375UaijcmFhtT/iK38WfItel/yLOiquUFUpLHOKfjoZvyP/tL8 v9xEAmXb12q5wFG3tFfrp+TBFKC9OKrD5lTWyuiJCYq3nxw62qxbP41Z80HmfAPKAblt 1AaNSKbpeFqLteZPMAOIPnFE8FJ4t5gIs/w3jnMoz4Ei9VRdGwGwKiKCcjnNMx/h09/K tuyz96h3B/U2U5S5gJvejnjol5flXjCgbtUzbFaCaj/nkGuBwod/Ho4OB6O8s4+p3ryS DLMA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=G08JJuzSVjauD2w7RKeXQ1nSbD1Rkjm71UkTsB/zD7Y=; b=1HOVe4y2QRRHG10OepQN6/VHnbcFon5hatrI6uwT/fVrIdRsuzASi1jV9bny7Ibn2r Fj2oTNfeRhXbHmSCBc73535xFX+oQYJ1/Q8Zw0QUXqVf0VP/rEZC9wODEnTUCgeXlf+/ 39xZwpSLroou0Yx/eQ+zX5trGglS/OJcL0zB1ewsGtIDTd5UDlwVX31CJHEeIMWsRYHr sMkF5DuTHv+k7SgLgQp6mHkpbS0qIc0XAuATL5UhiBGmn4T6b7yE2HfGeIlCiLl1Nv2C nJgnw0FgskGeHUNmwZdBfvBDrwFQwY53gZFa0knzk+MhcGeev8SSorTc0x7SDqHlNic7 34tA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=D2amWQb9; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v3si4089359eje.650.2021.01.15.12.11.52; Fri, 15 Jan 2021 12:11:53 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=D2amWQb9; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388518AbhAOUKl (ORCPT + 7 others); Fri, 15 Jan 2021 15:10:41 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53328 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2388376AbhAOUKh (ORCPT ); Fri, 15 Jan 2021 15:10:37 -0500 Received: from mail-wr1-x42b.google.com (mail-wr1-x42b.google.com [IPv6:2a00:1450:4864:20::42b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4BA92C06179B for ; Fri, 15 Jan 2021 12:09:20 -0800 (PST) Received: by mail-wr1-x42b.google.com with SMTP id v15so6823354wrx.4 for ; Fri, 15 Jan 2021 12:09:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=G08JJuzSVjauD2w7RKeXQ1nSbD1Rkjm71UkTsB/zD7Y=; b=D2amWQb9S98u/P5DUNkplruHJE6hVhzLyueXRjLidi8RMYlvYJAhCpbqxHg8k2MQjo 1S5+7meCyWYbaXQZbhA1FJq7SfDR4nLyt3j+Jt6tJEev8HvJlVpqybhK+MTf4jK6+e2h HS9/myq1P0yBGJaqe2Pdye8TlfM5DlRC8+TwEZ7Z/eiUi1viUgUJV0tIxTxisRLNHbl8 mizOpFQFPPkvu5KawxfqOWdEdA8g3UnjMV4D+VIDsTy6ig7B1lsk04d/E48bCNSbazJh Jhh4KjgIY+FL2YJRew11Mc6SL7julFqzizygkgUi6ACy04C3SN41sqQ8XmA7gQqzqJ0g uRDg== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=G08JJuzSVjauD2w7RKeXQ1nSbD1Rkjm71UkTsB/zD7Y=; b=C0e02Ynqt6bm9UZCym13KmtoYuNqLVjJAVI8157XsrUXtBLPFE3T9/hrN8muUieiFp bPdTtBOVsl+aIU50vZVYzbxYOAxM0NT6uJJ8xfMDr+74e+5lQCIwPvvwASWql5Jr8YVS rfhPR8cFOkz88drCusQV27CZ/llrXuRYzK6d4gJaplvNLUgr7wND1/49d4mpN2oaEhPI BFcTabJ9HdE+r32SqwmOuU2zZMKccdEL7Jq6tcYwDuFk+gGlQ+VlyhF7TxqIMH5hU+q+ 7j2U5GLJMfGgORs2x0G+Jm5bogsyuVrFn34J0Ueigvf7kIYX/jj8D3cWt3PmXnVBOPiO ou3w== X-Gm-Message-State: AOAM533W6tngQBgaO1OpvVWRxFHv2EH77bKC8Xv4hypVWfirkxaFpI5A 00cRyMhyanJhV4DvsJGKtMikECbOdLrLYmYV X-Received: by 2002:adf:e9d2:: with SMTP id l18mr14392232wrn.179.1610741359077; Fri, 15 Jan 2021 12:09:19 -0800 (PST) Received: from dell.default ([91.110.221.158]) by smtp.gmail.com with ESMTPSA id d85sm9187863wmd.2.2021.01.15.12.09.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jan 2021 12:09:18 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "David S. Miller" , Jakub Kicinski , Ivan Khoronzhuk , "Gustavo A. R. Silva" , netdev@vger.kernel.org, Andrew Lunn Subject: [PATCH 3/7] net: ethernet: ti: am65-cpsw-qos: Demote non-conformant function header Date: Fri, 15 Jan 2021 20:09:01 +0000 Message-Id: <20210115200905.3470941-4-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210115200905.3470941-1-lee.jones@linaro.org> References: <20210115200905.3470941-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/ethernet/ti/am65-cpsw-qos.c:364: warning: Function parameter or member 'ndev' not described in 'am65_cpsw_timer_set' drivers/net/ethernet/ti/am65-cpsw-qos.c:364: warning: Function parameter or member 'est_new' not described in 'am65_cpsw_timer_set' Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Ivan Khoronzhuk Cc: "Gustavo A. R. Silva" Cc: netdev@vger.kernel.org Reviewed-by: Andrew Lunn Signed-off-by: Lee Jones --- drivers/net/ethernet/ti/am65-cpsw-qos.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/net/ethernet/ti/am65-cpsw-qos.c b/drivers/net/ethernet/ti/am65-cpsw-qos.c index 3bdd4dbcd2ff1..ebcc6386cc34a 100644 --- a/drivers/net/ethernet/ti/am65-cpsw-qos.c +++ b/drivers/net/ethernet/ti/am65-cpsw-qos.c @@ -356,7 +356,7 @@ static void am65_cpsw_est_set_sched_list(struct net_device *ndev, writel(~all_fetch_allow & AM65_CPSW_FETCH_ALLOW_MSK, ram_addr); } -/** +/* * Enable ESTf periodic output, set cycle start time and interval. */ static int am65_cpsw_timer_set(struct net_device *ndev, From patchwork Fri Jan 15 20:09:02 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 363750 Delivered-To: patch@linaro.org Received: by 2002:a02:ccad:0:0:0:0:0 with SMTP id t13csp171186jap; Fri, 15 Jan 2021 12:11:54 -0800 (PST) X-Google-Smtp-Source: ABdhPJzaG+Mbb8dskenhASZgU7QDTZLV2GLxPLBWEw1Y8m1BVc/gkdqC2bcBKo746QH7O8o4zvwG X-Received: by 2002:a50:a086:: with SMTP id 6mr3577719edo.70.1610741514521; Fri, 15 Jan 2021 12:11:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1610741514; cv=none; d=google.com; s=arc-20160816; b=DxQE1R+th3pE2cduqtQpNbC2V+HuG19uSsim2P8c5prn2idhCejOiyK1QCqxdIEDvd 2gPYVNnkZ3d2kIQl/X1y9rKWXJ5uadRuQUpPWOQicxikMLTUhbHBwGFj11/POe2fXqlV wlFLBs4du6XsPRcIyGLa+JAF7xgMxFXce0DU80zeYdNkV0JTmCBKlAX3Y+Z7wGu7pvn2 PGlurEWq7+FqmN2quPbyTbWucNbWvs72HkwlHWrZPLVhXxvyFlnr9ylYFBu/uctAQiyZ VbElC42iCqLyPKGuFttqYPwAr1WKALT8Msc6w5W5lFOly7ans+HLboUhx9slXxLeM1vG c4uQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=Z1CB49mzZZUw/61JRz0eEUr9QqVKx7SA3GZtjiem/4A=; b=ZnBBTl3kYhLALxcQFThnbRrcbqwr6J9iRGFvvK9SAPVOWtdaj1KQzGzvC2uqJuzV2y HiGp5Nak8HS7RxH2tq7asQe8qyjGmfL60LB6rAucPGgbpT/rFi6OVr3ZQhxpFYkHW7rp i8+xnkzkI2tdF0E7ld1t/Nb13fLNaDuyZv3oz7uEupLGnQfG6t2yDh294iTjp/NlmcoS /r6EHyQUaF3bBjbX6Tk8RJZ9aluTui1LXogK4X1VjVjGNdFnVBLtrLniET4A9TgZzQnh ieej8WGwuru5cARLAa5DeE+D2Ktif5pEu0cHq8d0NxImda05BYi11OIpyQ67y7ew/qt0 o1RA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=XZVdyPcl; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v3si4089359eje.650.2021.01.15.12.11.54; Fri, 15 Jan 2021 12:11:54 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=XZVdyPcl; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388755AbhAOUKz (ORCPT + 7 others); Fri, 15 Jan 2021 15:10:55 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53332 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2388402AbhAOUKi (ORCPT ); Fri, 15 Jan 2021 15:10:38 -0500 Received: from mail-wr1-x42f.google.com (mail-wr1-x42f.google.com [IPv6:2a00:1450:4864:20::42f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D2392C06179C for ; Fri, 15 Jan 2021 12:09:21 -0800 (PST) Received: by mail-wr1-x42f.google.com with SMTP id v15so6823415wrx.4 for ; Fri, 15 Jan 2021 12:09:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=Z1CB49mzZZUw/61JRz0eEUr9QqVKx7SA3GZtjiem/4A=; b=XZVdyPclrbT2uhxikgAxnyIS/ZX1qGmCB8LbBl3vmin7FjsAsxRottUyPI83R0g3lU +4Q7EX9573V1O6kGhPJdJJKT6hRRq96wUP4l95wA8rl3xpo90ptufBd2CZWkbmugECIw bfjO1EOjYV6zg0/S5sBgJjUeFp9vLqAB8vc7Oy2Y6M8wZBTfGqdfw4VI/6NIO5I0y/c0 INaxZ8czTplEQT+SU1KBPk5SbbbO3giYgFjXLHrXLtukvEywqvOsUCxmO1tHSjKSLQj8 0uoJ8Pj7N0SlrVletx9yTWLzIHNMPfbq/KjdpRTwEySsiVz6JzCVlrVrflyFcM2Tp2In E6Eg== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=Z1CB49mzZZUw/61JRz0eEUr9QqVKx7SA3GZtjiem/4A=; b=E8ZtTaLlfBU2u5eDPd93pEkONNYHdBJUCR3/AoGZTYH5P5SnLrQhNRpab2uVFWIgZX jceQxOGtXPADmm4qk8mmc1KdOL9rvXiwCVQGbjSIIaAUGAwfwEgF00Z+cBQTVlYW6c4j AkIDvFhRW5w2XK/FRL1wSnZoEGbOeOk77PIVmUlqY23179g3VAW8y0zzKO5xpLxIL4J1 GQdzHWOLSafzsM/2vFuCI95B6IPZUm42jY/PffJyu2HDjG1N4SOHtMEDEKRelL1l5GvD 7feLTsbptz7u6cvCmZQIc2mALQGUlPcdSmhdAL8LuA3Z3MaBKVt+TZ1M+8tTmQDlK/3W 1omQ== X-Gm-Message-State: AOAM531zPR86H8gpbZ9zdfm6s1ONQ5bS5CSB0wt+OAmRLvsGTJmDd5zV 6o02M9JFslEBpys9KGNMtkbTvw== X-Received: by 2002:adf:c64f:: with SMTP id u15mr14322350wrg.270.1610741360557; Fri, 15 Jan 2021 12:09:20 -0800 (PST) Received: from dell.default ([91.110.221.158]) by smtp.gmail.com with ESMTPSA id d85sm9187863wmd.2.2021.01.15.12.09.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jan 2021 12:09:19 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "David S. Miller" , Jakub Kicinski , Grygorii Strashko , Kurt Kanzenbach , netdev@vger.kernel.org, Andrew Lunn Subject: [PATCH 4/7] net: ethernet: ti: am65-cpts: Document am65_cpts_rx_enable()'s 'en' parameter Date: Fri, 15 Jan 2021 20:09:02 +0000 Message-Id: <20210115200905.3470941-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210115200905.3470941-1-lee.jones@linaro.org> References: <20210115200905.3470941-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/ethernet/ti/am65-cpts.c:736: warning: Function parameter or member 'en' not described in 'am65_cpts_rx_enable' drivers/net/ethernet/ti/am65-cpts.c:736: warning: Excess function parameter 'skb' description in 'am65_cpts_rx_enable' Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Grygorii Strashko Cc: Kurt Kanzenbach Cc: netdev@vger.kernel.org Reviewed-by: Andrew Lunn Signed-off-by: Lee Jones --- drivers/net/ethernet/ti/am65-cpts.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/net/ethernet/ti/am65-cpts.c b/drivers/net/ethernet/ti/am65-cpts.c index 5dc60ecabe561..9caaae79fc957 100644 --- a/drivers/net/ethernet/ti/am65-cpts.c +++ b/drivers/net/ethernet/ti/am65-cpts.c @@ -727,7 +727,7 @@ static long am65_cpts_ts_work(struct ptp_clock_info *ptp) /** * am65_cpts_rx_enable - enable rx timestamping * @cpts: cpts handle - * @skb: packet + * @en: enable * * This functions enables rx packets timestamping. The CPTS can timestamp all * rx packets. From patchwork Fri Jan 15 20:09:03 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 363751 Delivered-To: patch@linaro.org Received: by 2002:a02:ccad:0:0:0:0:0 with SMTP id t13csp171217jap; Fri, 15 Jan 2021 12:11:56 -0800 (PST) X-Google-Smtp-Source: ABdhPJye6SjPi6mb9DPOg4NYaIgf6vmT0NAoKsrAiGCpCSSL68hvGXe2E37QLXrWWX6HmjCEtXOH X-Received: by 2002:a05:6402:78f:: with SMTP id d15mr3177896edy.362.1610741516078; Fri, 15 Jan 2021 12:11:56 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1610741516; cv=none; d=google.com; s=arc-20160816; b=B8dwxs4xxbLPej0JMn/jBvVYEDLxs6HEcDE6yN8tIpG2TXFZdMyVz2utkTf4u4LETJ B1gxsMp1b9udPuU+K/hIjSmh34+sC1BbXPCq1qKlqHkNfo+ldwT3V0om3VAzPoAiY32g 8A7pKZsIfHR+qJD3q9ob1v611SXJwBF3IqFt76hn3SVognUTX8a1Zyg82h6ckWvNEgt2 xfbUvgsqv+Oq+nkIbAZLoJCK/3u2pyKnVISozasoQSWp9N4IREPeldrKXKoN7yRP3JO+ oerrLjDSD0SMsRq3cYGUjtkOuQTUmrDN4xrWnl5ZBlgvA35OWFUFSAvlcshvjpOHRRsc B4hw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=yDzb65IKn3nwovbfX3R0K/7WXOxWh6GWTqzLuh+BAmI=; b=uVYBlng6ofggLf9E8Dk74Y3/dOLIEepzO0kVFSMGnfD+THA3cRifABkAmMIERXCZaH iHDBKTB31NK/I8JVB3yPUnR4+zmC+vly1PrbQ9WlY19rqxMMDdGbSsR8SIxNsgZ73dC2 LgEgyqLRxA9V81xVUK6c0MnrSLgLkYmsxiMbPOCGVeaoRjZ8Ep1cZ1PCUktk+OqDojNC kMFERV0cuJfj4y78iy2+PC9h76KN7KlvBxkpWR/kE1yXO9Id1zDukRf708KcrzVlpV6V XymjTad7BBOSHbzInQqQWoEfTxFLXa02oaG0Nh1nxNIvJuasmWRGYFiIR6tfAzorsXfF DWyA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=pZsRMv5b; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v3si4089359eje.650.2021.01.15.12.11.55; Fri, 15 Jan 2021 12:11:56 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=pZsRMv5b; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388419AbhAOUKx (ORCPT + 7 others); Fri, 15 Jan 2021 15:10:53 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53334 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2388405AbhAOUKi (ORCPT ); Fri, 15 Jan 2021 15:10:38 -0500 Received: from mail-wm1-x331.google.com (mail-wm1-x331.google.com [IPv6:2a00:1450:4864:20::331]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 86F81C06179E for ; Fri, 15 Jan 2021 12:09:23 -0800 (PST) Received: by mail-wm1-x331.google.com with SMTP id g10so8646009wmh.2 for ; Fri, 15 Jan 2021 12:09:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=yDzb65IKn3nwovbfX3R0K/7WXOxWh6GWTqzLuh+BAmI=; b=pZsRMv5bhHtvqYJamsuJ75nikyt6zcEJQlYa5vQNiBCiISvirtV/ccexo7zQxCL1hu FyMdw6tJFzSL+XN4ohF9JDJi5bNXyHBfqEqyKGKVtQFvIof1HSwxObDjQ06yYJD+Ny56 MKCOrA9dCzWddMH10Sre5X+JgsGLmIc++r0XDgmiQQ/UVjhhhmCg2myrmmjsK0CckMSX aKr2n65VSUKW1Facr/jNVjR4IeSnYHdw2rTWy//Bt6I1nB7nbCnmxCW/lkikEvkBxrgY MzhZpHTN2iXSiKX9uLQIRu6p2MsCvQzueB4ji7GPjK5Z4qOIpiZbDuW1S0rybK4pqPFZ o0aw== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=yDzb65IKn3nwovbfX3R0K/7WXOxWh6GWTqzLuh+BAmI=; b=NOW6zKVO1xuY2DnX3LXGuPPhxX5fUgzbXkghMcTbsEF4Od0oJMTEAuYFCNYtR/qPtl H25bj/tl4B5/XQepqgKgNkbCcOLtYlEwyjh0sdlLiYqO0PtkN1pIuXnDLChbBz2lAAOz j8sCQlRVSt7HioWVL+BYaqNsMFprWe/2eVCY3l92kE0fpXwREzbDcDxlSoozzt9HmvS2 SmGOSyR2wGiRXni0o01aEh17KPAxFiKor3nn7AezsV9gDK1JENEMUxmTfgEGxxjAkCVQ FbFnPhgoQGiBFPfy/ANsXlBha9acsJf+HbAg1UmSNt/qBo8gAOO4BX3q/SL+1ELaXmAG mPzA== X-Gm-Message-State: AOAM5300Be0JH9PlztMWStLODHFsc5JDiiZ8eZ6RX3JOSTGgEo0m6es9 tUxevrT3IwxjWmptRY60jYo/8Q== X-Received: by 2002:a05:600c:d1:: with SMTP id u17mr7533052wmm.20.1610741362266; Fri, 15 Jan 2021 12:09:22 -0800 (PST) Received: from dell.default ([91.110.221.158]) by smtp.gmail.com with ESMTPSA id d85sm9187863wmd.2.2021.01.15.12.09.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jan 2021 12:09:21 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Dany Madden , Lijun Pan , Sukadev Bhattiprolu , Michael Ellerman , Benjamin Herrenschmidt , Paul Mackerras , "David S. Miller" , Jakub Kicinski , Santiago Leon , Thomas Falcon , John Allen , netdev@vger.kernel.org, linuxppc-dev@lists.ozlabs.org Subject: [PATCH 5/7] net: ethernet: ibm: ibmvnic: Fix some kernel-doc misdemeanours Date: Fri, 15 Jan 2021 20:09:03 +0000 Message-Id: <20210115200905.3470941-6-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210115200905.3470941-1-lee.jones@linaro.org> References: <20210115200905.3470941-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): from drivers/net/ethernet/ibm/ibmvnic.c:35: inlined from ‘handle_vpd_rsp’ at drivers/net/ethernet/ibm/ibmvnic.c:4124:3: drivers/net/ethernet/ibm/ibmvnic.c:1362: warning: Function parameter or member 'hdr_field' not described in 'build_hdr_data' drivers/net/ethernet/ibm/ibmvnic.c:1362: warning: Function parameter or member 'skb' not described in 'build_hdr_data' drivers/net/ethernet/ibm/ibmvnic.c:1362: warning: Function parameter or member 'hdr_len' not described in 'build_hdr_data' drivers/net/ethernet/ibm/ibmvnic.c:1362: warning: Function parameter or member 'hdr_data' not described in 'build_hdr_data' drivers/net/ethernet/ibm/ibmvnic.c:1423: warning: Function parameter or member 'hdr_field' not described in 'create_hdr_descs' drivers/net/ethernet/ibm/ibmvnic.c:1423: warning: Function parameter or member 'hdr_data' not described in 'create_hdr_descs' drivers/net/ethernet/ibm/ibmvnic.c:1423: warning: Function parameter or member 'len' not described in 'create_hdr_descs' drivers/net/ethernet/ibm/ibmvnic.c:1423: warning: Function parameter or member 'hdr_len' not described in 'create_hdr_descs' drivers/net/ethernet/ibm/ibmvnic.c:1423: warning: Function parameter or member 'scrq_arr' not described in 'create_hdr_descs' drivers/net/ethernet/ibm/ibmvnic.c:1474: warning: Function parameter or member 'txbuff' not described in 'build_hdr_descs_arr' drivers/net/ethernet/ibm/ibmvnic.c:1474: warning: Function parameter or member 'num_entries' not described in 'build_hdr_descs_arr' drivers/net/ethernet/ibm/ibmvnic.c:1474: warning: Function parameter or member 'hdr_field' not described in 'build_hdr_descs_arr' drivers/net/ethernet/ibm/ibmvnic.c:1832: warning: Function parameter or member 'adapter' not described in 'do_change_param_reset' drivers/net/ethernet/ibm/ibmvnic.c:1832: warning: Function parameter or member 'rwi' not described in 'do_change_param_reset' drivers/net/ethernet/ibm/ibmvnic.c:1832: warning: Function parameter or member 'reset_state' not described in 'do_change_param_reset' drivers/net/ethernet/ibm/ibmvnic.c:1911: warning: Function parameter or member 'adapter' not described in 'do_reset' drivers/net/ethernet/ibm/ibmvnic.c:1911: warning: Function parameter or member 'rwi' not described in 'do_reset' drivers/net/ethernet/ibm/ibmvnic.c:1911: warning: Function parameter or member 'reset_state' not described in 'do_reset' Cc: Dany Madden Cc: Lijun Pan Cc: Sukadev Bhattiprolu Cc: Michael Ellerman Cc: Benjamin Herrenschmidt Cc: Paul Mackerras Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Santiago Leon Cc: Thomas Falcon Cc: John Allen Cc: netdev@vger.kernel.org Cc: linuxppc-dev@lists.ozlabs.org Signed-off-by: Lee Jones --- drivers/net/ethernet/ibm/ibmvnic.c | 27 +++++++++++++-------------- drivers/net/xen-netfront.c | 6 +++--- 2 files changed, 16 insertions(+), 17 deletions(-) -- 2.25.1 diff --git a/drivers/net/ethernet/ibm/ibmvnic.c b/drivers/net/ethernet/ibm/ibmvnic.c index aed985e08e8ad..4c4252e68de5a 100644 --- a/drivers/net/ethernet/ibm/ibmvnic.c +++ b/drivers/net/ethernet/ibm/ibmvnic.c @@ -1384,10 +1384,10 @@ static int ibmvnic_close(struct net_device *netdev) /** * build_hdr_data - creates L2/L3/L4 header data buffer - * @hdr_field - bitfield determining needed headers - * @skb - socket buffer - * @hdr_len - array of header lengths - * @tot_len - total length of data + * @hdr_field: bitfield determining needed headers + * @skb: socket buffer + * @hdr_len: array of header lengths + * @hdr_data: buffer to write the header to * * Reads hdr_field to determine which headers are needed by firmware. * Builds a buffer containing these headers. Saves individual header @@ -1444,11 +1444,11 @@ static int build_hdr_data(u8 hdr_field, struct sk_buff *skb, /** * create_hdr_descs - create header and header extension descriptors - * @hdr_field - bitfield determining needed headers - * @data - buffer containing header data - * @len - length of data buffer - * @hdr_len - array of individual header lengths - * @scrq_arr - descriptor array + * @hdr_field: bitfield determining needed headers + * @hdr_data: buffer containing header data + * @len: length of data buffer + * @hdr_len: array of individual header lengths + * @scrq_arr: descriptor array * * Creates header and, if needed, header extension descriptors and * places them in a descriptor array, scrq_arr @@ -1496,10 +1496,9 @@ static int create_hdr_descs(u8 hdr_field, u8 *hdr_data, int len, int *hdr_len, /** * build_hdr_descs_arr - build a header descriptor array - * @skb - socket buffer - * @num_entries - number of descriptors to be sent - * @subcrq - first TX descriptor - * @hdr_field - bit field determining which headers will be sent + * @txbuff: tx buffer + * @num_entries: number of descriptors to be sent + * @hdr_field: bit field determining which headers will be sent * * This function will build a TX descriptor array with applicable * L2/L3/L4 packet header descriptors to be sent by send_subcrq_indirect. @@ -1925,7 +1924,7 @@ static int ibmvnic_set_mac(struct net_device *netdev, void *p) return rc; } -/** +/* * do_reset returns zero if we are able to keep processing reset events, or * non-zero if we hit a fatal error and must halt. */ diff --git a/drivers/net/xen-netfront.c b/drivers/net/xen-netfront.c index b01848ef46493..811ddc8a94eea 100644 --- a/drivers/net/xen-netfront.c +++ b/drivers/net/xen-netfront.c @@ -1582,7 +1582,7 @@ static struct net_device *xennet_create_dev(struct xenbus_device *dev) return ERR_PTR(err); } -/** +/* * Entry point to this code when a new device is created. Allocate the basic * structures and the ring buffers for communication with the backend, and * inform the backend of the appropriate details for those. @@ -1659,7 +1659,7 @@ static void xennet_disconnect_backend(struct netfront_info *info) } } -/** +/* * We are reconnecting to the backend, due to a suspend/resume, or a backend * driver restart. We tear down our netif structure and recreate it, but * leave the device-layer structures intact so that this is transparent to the @@ -2305,7 +2305,7 @@ static int xennet_connect(struct net_device *dev) return 0; } -/** +/* * Callback received when the backend's state changes. */ static void netback_changed(struct xenbus_device *dev, From patchwork Fri Jan 15 20:09:04 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 363749 Delivered-To: patch@linaro.org Received: by 2002:a02:ccad:0:0:0:0:0 with SMTP id t13csp171177jap; Fri, 15 Jan 2021 12:11:53 -0800 (PST) X-Google-Smtp-Source: ABdhPJyboagg5q4JxF9LMd6t9FKaNCay1aTGunb8hB3MkDydK3n3sAeuuAovgFRY2NCx/Jua/Sd9 X-Received: by 2002:a17:906:4a04:: with SMTP id w4mr2100605eju.46.1610741513686; Fri, 15 Jan 2021 12:11:53 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1610741513; cv=none; d=google.com; s=arc-20160816; b=lNlBjVlboYuyUZgLHYquEVywZ6L/Hd6DVGNKp651/maAm+Mn1z6NCeQs3It5QZTRMV g1hwajvYnG07v59wIEEyVAR+LoEFEdubvG7wI5KzU4HRzojUDBmxIeDpa20nnqHPW0U8 4KxPtIHy0ByJbaskpb1GYAfi1wgV3V7xsXWVZB7aZ5hUXUwS6jtm/xgTh/cVBIPXiSvJ mDQJugTalTivryAu86OLoshTyoO7+JrQ6wGvkNJFPTbo/nb94hqALn+6AkUctS615oHK pDhrSz01RdyZDeCaDzWeEFSJPQG4q93/hgv5JVsrPFS8kSY8fVzbe10X4Y79bVJ3/R0Q K5dQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=+qXCFwBbPWtbGR33uyQvB+16QfHJsg8zQueyUlEuj0c=; b=GrAFQn1swjCpdP6CJhc/XOA/h/oKighRXn4wLFP75kNWHrFSr9OXBbvVWZMOVGTOPm iM7fJ6M6nKj33SY5DgtdS2QZocNmZR6chS21TftCx/Jr4e2oni5Ux1TwyB89mgawX7Rp RfbeZJMxgCpPSq278Dw7IdXKut4lHPM9hG6sv7X95dfrfIH7WhrKv9lu9OBq8EKfOZVE EV+CwTH7N0NQyZ3HPIb8zm/oaUz0D8lQl0Ah2HgxTJnajAWZn4gruW1iLyRO3ekPXj9i GlTJXNRKsmYfsrS8TiRXX35ACxuJKO657HB+FEqNloAmoCRuZugceWi/A6rAQb77Or8E K+PA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=r4oAoo9y; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v3si4089359eje.650.2021.01.15.12.11.53; Fri, 15 Jan 2021 12:11:53 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=r4oAoo9y; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388622AbhAOUKt (ORCPT + 7 others); Fri, 15 Jan 2021 15:10:49 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53346 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728081AbhAOUKp (ORCPT ); Fri, 15 Jan 2021 15:10:45 -0500 Received: from mail-wm1-x334.google.com (mail-wm1-x334.google.com [IPv6:2a00:1450:4864:20::334]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DA619C0617A1 for ; Fri, 15 Jan 2021 12:09:24 -0800 (PST) Received: by mail-wm1-x334.google.com with SMTP id e15so2246936wme.0 for ; Fri, 15 Jan 2021 12:09:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=+qXCFwBbPWtbGR33uyQvB+16QfHJsg8zQueyUlEuj0c=; b=r4oAoo9yjHlPOAHenr5g1EEQfCJWwxaNTfc1ja5O6o5T1ZICU4yaeYLTltJ1ZwhWt1 hYVV2trVas9eLp1262M7RtfrYIEz7l+5afdXAZLDAVgmpGypz488LOz8xh5YUONIahkt eE1JpBPouAfU6ZbgapMKocnQObleFyJlMh17sdT9uSaDfAJK1H4RLL3fR/jf1vPbZSl2 3ZXGy84XFr6wdgvBhg4tUDvEZEEb9HvFdLNJXx4pfxdQa+bod0l65TCpu6pNojaqfRmz GZBTnODZc6DO9w3kWfCa8POUDB0h8esIyL2gH/Yx7pqneNMukxKM+5ngce4TNsbAFuly uH2Q== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=+qXCFwBbPWtbGR33uyQvB+16QfHJsg8zQueyUlEuj0c=; b=JK0G0IQiIGNe8AOKHrxZudn507nWqcWsBXhSQjo0GKLCVKFExNLYOi+bi2kvKMtEOu zt9m0+SDyJc49ZIn29h5M6KWSlXj4cGToqiYFEHgTJZjer3Q4cnjYMMgcBgGj0LSU85t HzYzaLInoIWBVaxzSs0zut/XjkF/jFP0bOeJI3CHf4TpmNNky6qbP+QKn4kaP+dBS8Af ND/NNRL1Y4AFfBdOEdGIxqn7TEl6Hy/5SmrdKzLAvjr+yTFQQ3AkjrY+sIScGG9dOg95 n1q/vYLCdoEuZ3RVX4vZT9JCicTb8BpKEL3ApOgvdaY/Jtm/Hlhi7xfQeDzs2Xx6bB1t GSUA== X-Gm-Message-State: AOAM533pywnaUi/1Nn+w6z2g7ur2VkV4cCwqzS995hdnS6i+Pm7KwCd+ 3LYVdjDYPiz5IFuUhJ30uCO1E6ph86FufXWf X-Received: by 2002:a1c:1f86:: with SMTP id f128mr10246918wmf.174.1610741363617; Fri, 15 Jan 2021 12:09:23 -0800 (PST) Received: from dell.default ([91.110.221.158]) by smtp.gmail.com with ESMTPSA id d85sm9187863wmd.2.2021.01.15.12.09.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jan 2021 12:09:22 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Geoff Levand , "David S. Miller" , Jakub Kicinski , Michael Ellerman , Benjamin Herrenschmidt , Paul Mackerras , Utz Bacher , Jens Osterkamp , netdev@vger.kernel.org, linuxppc-dev@lists.ozlabs.org, Andrew Lunn Subject: [PATCH 6/7] net: ethernet: toshiba: ps3_gelic_net: Fix some kernel-doc misdemeanours Date: Fri, 15 Jan 2021 20:09:04 +0000 Message-Id: <20210115200905.3470941-7-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210115200905.3470941-1-lee.jones@linaro.org> References: <20210115200905.3470941-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/ethernet/toshiba/ps3_gelic_net.c:1107: warning: Function parameter or member 'irq' not described in 'gelic_card_interrupt' drivers/net/ethernet/toshiba/ps3_gelic_net.c:1107: warning: Function parameter or member 'ptr' not described in 'gelic_card_interrupt' drivers/net/ethernet/toshiba/ps3_gelic_net.c:1407: warning: Function parameter or member 'txqueue' not described in 'gelic_net_tx_timeout' drivers/net/ethernet/toshiba/ps3_gelic_net.c:1439: warning: Function parameter or member 'napi' not described in 'gelic_ether_setup_netdev_ops' drivers/net/ethernet/toshiba/ps3_gelic_net.c:1639: warning: Function parameter or member 'dev' not described in 'ps3_gelic_driver_probe' drivers/net/ethernet/toshiba/ps3_gelic_net.c:1795: warning: Function parameter or member 'dev' not described in 'ps3_gelic_driver_remove' Cc: Geoff Levand Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Michael Ellerman Cc: Benjamin Herrenschmidt Cc: Paul Mackerras Cc: Utz Bacher Cc: Jens Osterkamp Cc: netdev@vger.kernel.org Cc: linuxppc-dev@lists.ozlabs.org Reviewed-by: Andrew Lunn Signed-off-by: Lee Jones --- drivers/net/ethernet/toshiba/ps3_gelic_net.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) -- 2.25.1 diff --git a/drivers/net/ethernet/toshiba/ps3_gelic_net.c b/drivers/net/ethernet/toshiba/ps3_gelic_net.c index 3d1fc8d2ca667..55e652624bd76 100644 --- a/drivers/net/ethernet/toshiba/ps3_gelic_net.c +++ b/drivers/net/ethernet/toshiba/ps3_gelic_net.c @@ -1100,7 +1100,7 @@ static int gelic_net_poll(struct napi_struct *napi, int budget) return packets_done; } -/** +/* * gelic_card_interrupt - event handler for gelic_net */ static irqreturn_t gelic_card_interrupt(int irq, void *ptr) @@ -1400,6 +1400,7 @@ static void gelic_net_tx_timeout_task(struct work_struct *work) /** * gelic_net_tx_timeout - called when the tx timeout watchdog kicks in. * @netdev: interface device structure + * @txqueue: unused * * called, if tx hangs. Schedules a task that resets the interface */ @@ -1431,6 +1432,7 @@ static const struct net_device_ops gelic_netdevice_ops = { /** * gelic_ether_setup_netdev_ops - initialization of net_device operations * @netdev: net_device structure + * @napi: napi structure * * fills out function pointers in the net_device structure */ @@ -1632,7 +1634,7 @@ static void gelic_card_get_vlan_info(struct gelic_card *card) dev_info(ctodev(card), "internal vlan %s\n", card->vlan_required? "enabled" : "disabled"); } -/** +/* * ps3_gelic_driver_probe - add a device to the control of this driver */ static int ps3_gelic_driver_probe(struct ps3_system_bus_device *dev) @@ -1787,7 +1789,7 @@ static int ps3_gelic_driver_probe(struct ps3_system_bus_device *dev) return result; } -/** +/* * ps3_gelic_driver_remove - remove a device from the control of this driver */ From patchwork Fri Jan 15 20:09:05 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 363752 Delivered-To: patch@linaro.org Received: by 2002:a02:ccad:0:0:0:0:0 with SMTP id t13csp171220jap; Fri, 15 Jan 2021 12:11:56 -0800 (PST) X-Google-Smtp-Source: ABdhPJzTIf6IHHeltfF4Vbtvjr/8j5dYs5aDW3k074M4A5NYpG/KzKo62hZNhnZF2v+wQUKxfUve X-Received: by 2002:a17:906:7e49:: with SMTP id z9mr6268938ejr.447.1610741516513; Fri, 15 Jan 2021 12:11:56 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1610741516; cv=none; d=google.com; s=arc-20160816; b=g51u8mXQLAc53islAO6l05VpyF+/Saysr2MR9Kt7bZk4GChJk+ItvwVzvAnmjWNfXT ikRzz5wCoJvXd4LfV9uIJf/d+Bry03XbKEHjO7KbDa6EG2iJgh1z9OZARU9G3S7cv0Yo bqJHTCgwtPZIPPvXMzoxAWMKJH0dBcxdqV73IzA7/sigcwyJlf5G1ARVskNir2HNK1Hj m2trMh0aanjgj/LC0ZAgefab9diU8w0N5hpd2oUoD2TMk+yMlZxJBOQFZdVzHiZ9vh63 agVw5D7G0t5P5xveyQVwTmaiJshpogPhJtqC/QMOGWOu/TiaB+ohqohETliqIou6rmYD 3JKg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=ChGB+JX2oknD3GU9F+oPlQzChiJ0MNf1JzMjKC1b9JA=; b=yn1qMIFAAkCywUYpz0jDaWXjPhCuXjKSXmoVEj9wrxE8F91mo1SvQrMmeyJNJ32SOQ Gtswnr3GtuavaPGo9FJ7KqzzPBOjhGkn949NRoHo89qKEC7M68CA4n838v4aSQBPW46V lKH0S/DSc67NhKOnqxeG8q9kVT+KD4ZUhLZTb7OPH4YKlqG9acaTr5eGh2ncs5vBv5tc 8c5EXiVdec0cknY1Yy15Pt/SW4070Il/uuUc7iFCCouKAzCw4DW097eMgPTi9elJeV4r tZ6mNPQ4yxhaZQtazRNs51y3czigZRPowQBvlSazZlFenQ1Piyqey0yFU7AhmjwnwUna I6EA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=hHi5eCMS; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v3si4089359eje.650.2021.01.15.12.11.56; Fri, 15 Jan 2021 12:11:56 -0800 (PST) Received-SPF: pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=hHi5eCMS; spf=pass (google.com: domain of netdev-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=netdev-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388665AbhAOUKw (ORCPT + 7 others); Fri, 15 Jan 2021 15:10:52 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53348 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2388220AbhAOUKj (ORCPT ); Fri, 15 Jan 2021 15:10:39 -0500 Received: from mail-wm1-x32d.google.com (mail-wm1-x32d.google.com [IPv6:2a00:1450:4864:20::32d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3E36AC0617A2 for ; Fri, 15 Jan 2021 12:09:26 -0800 (PST) Received: by mail-wm1-x32d.google.com with SMTP id o10so2520434wmc.1 for ; Fri, 15 Jan 2021 12:09:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=ChGB+JX2oknD3GU9F+oPlQzChiJ0MNf1JzMjKC1b9JA=; b=hHi5eCMSCKRIHZs+AW6PVjhBGk5PWZBITFLeeaKh02RUYGNWd0XuWAmygYxQpSiMLo /IvW0bfnHYArnuKkoy6CXoAGaWY8H6k725azzyJjS2Fh4zVgdjHEMiJTXNrf6YQNkbPD C+7hiAeDdU5YHHsQa3cEfg9kJVWfwjlmESJyu2CVsSPC/bsrps5ZLiueS2vnWR+Tuy/R z1ZuMPcgf4zaHO2wZo2rclu7WKsBfImD3PGT91PkoVoA+U4EB/2blW1dbDyp7SYouhvk UO2HkHXxHfglxvTYwYktfI1KP5fnDKgbPN8gSCC4WG5I3hlgBZmbFxZeFFkhA44N7sr5 Cvow== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=ChGB+JX2oknD3GU9F+oPlQzChiJ0MNf1JzMjKC1b9JA=; b=IubMVr5dtKT2l2FHMFwhgZJG1oQuLeptrIcLN0Ek+BfF802j9AQndFPfwllCb1Owb/ 07GWVkK8yezunM5WAS2fM8NDgGl6hNisC3Qe1TU7EjeJDjV2yx3u44dU7ZfbyqEz/e45 05LbwxaTlxPW1NgEohhinmK8If0hskfyU/bEhkmMC8qdfevtk9/DlMHGwYRnqAIefxGM 3WILTfscaALqJ7J2/TRTLw6/Xd4cPnmNi39jjdp5FGwM4GjO7KWYnhzeCNAi5QKehNeJ Mz873GiLrfI3Z/d7fB6hrgMkwxc01zUCVCzt9CGO31ejU0RoSLcVhcvuErfdWMGaV26r e4YQ== X-Gm-Message-State: AOAM531igCwezNIyYK5WG5lNQdgUqZka2ItkuPokzCcQvddM7vnF52v9 Ai8gwCxMuWbTKChyMajDWQg0gg== X-Received: by 2002:a1c:10c:: with SMTP id 12mr10286793wmb.186.1610741364928; Fri, 15 Jan 2021 12:09:24 -0800 (PST) Received: from dell.default ([91.110.221.158]) by smtp.gmail.com with ESMTPSA id d85sm9187863wmd.2.2021.01.15.12.09.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Jan 2021 12:09:24 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Ishizaki Kou , "David S. Miller" , Jakub Kicinski , Utz Bacher , Jens Osterkamp , netdev@vger.kernel.org, Andrew Lunn Subject: [PATCH 7/7] net: ethernet: toshiba: spider_net: Document a whole bunch of function parameters Date: Fri, 15 Jan 2021 20:09:05 +0000 Message-Id: <20210115200905.3470941-8-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210115200905.3470941-1-lee.jones@linaro.org> References: <20210115200905.3470941-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/net/ethernet/toshiba/spider_net.c:263: warning: Function parameter or member 'hwdescr' not described in 'spider_net_get_descr_status' drivers/net/ethernet/toshiba/spider_net.c:263: warning: Excess function parameter 'descr' description in 'spider_net_get_descr_status' drivers/net/ethernet/toshiba/spider_net.c:554: warning: Function parameter or member 'netdev' not described in 'spider_net_get_multicast_hash' drivers/net/ethernet/toshiba/spider_net.c:902: warning: Function parameter or member 't' not described in 'spider_net_cleanup_tx_ring' drivers/net/ethernet/toshiba/spider_net.c:902: warning: Excess function parameter 'card' description in 'spider_net_cleanup_tx_ring' drivers/net/ethernet/toshiba/spider_net.c:1074: warning: Function parameter or member 'card' not described in 'spider_net_resync_head_ptr' drivers/net/ethernet/toshiba/spider_net.c:1234: warning: Function parameter or member 'napi' not described in 'spider_net_poll' drivers/net/ethernet/toshiba/spider_net.c:1234: warning: Excess function parameter 'netdev' description in 'spider_net_poll' drivers/net/ethernet/toshiba/spider_net.c:1278: warning: Function parameter or member 'p' not described in 'spider_net_set_mac' drivers/net/ethernet/toshiba/spider_net.c:1278: warning: Excess function parameter 'ptr' description in 'spider_net_set_mac' drivers/net/ethernet/toshiba/spider_net.c:1350: warning: Function parameter or member 'error_reg1' not described in 'spider_net_handle_error_irq' drivers/net/ethernet/toshiba/spider_net.c:1350: warning: Function parameter or member 'error_reg2' not described in 'spider_net_handle_error_irq' drivers/net/ethernet/toshiba/spider_net.c:1968: warning: Function parameter or member 't' not described in 'spider_net_link_phy' drivers/net/ethernet/toshiba/spider_net.c:1968: warning: Excess function parameter 'data' description in 'spider_net_link_phy' drivers/net/ethernet/toshiba/spider_net.c:2149: warning: Function parameter or member 'work' not described in 'spider_net_tx_timeout_task' drivers/net/ethernet/toshiba/spider_net.c:2149: warning: Excess function parameter 'data' description in 'spider_net_tx_timeout_task' drivers/net/ethernet/toshiba/spider_net.c:2182: warning: Function parameter or member 'txqueue' not described in 'spider_net_tx_timeout' Cc: Ishizaki Kou Cc: "David S. Miller" Cc: Jakub Kicinski Cc: Utz Bacher Cc: Jens Osterkamp Cc: netdev@vger.kernel.org Reviewed-by: Andrew Lunn Signed-off-by: Lee Jones --- drivers/net/ethernet/toshiba/spider_net.c | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) -- 2.25.1 diff --git a/drivers/net/ethernet/toshiba/spider_net.c b/drivers/net/ethernet/toshiba/spider_net.c index 5f5b33e6653b2..d5a75ef7e3ca9 100644 --- a/drivers/net/ethernet/toshiba/spider_net.c +++ b/drivers/net/ethernet/toshiba/spider_net.c @@ -254,7 +254,7 @@ spider_net_set_promisc(struct spider_net_card *card) /** * spider_net_get_descr_status -- returns the status of a descriptor - * @descr: descriptor to look at + * @hwdescr: descriptor to look at * * returns the status as in the dmac_cmd_status field of the descriptor */ @@ -542,6 +542,7 @@ spider_net_alloc_rx_skbs(struct spider_net_card *card) /** * spider_net_get_multicast_hash - generates hash for multicast filter table + * @netdev: interface device structure * @addr: multicast address * * returns the hash value. @@ -890,7 +891,7 @@ spider_net_xmit(struct sk_buff *skb, struct net_device *netdev) /** * spider_net_cleanup_tx_ring - cleans up the TX ring - * @card: card structure + * @t: timer context used to obtain the pointer to net card data structure * * spider_net_cleanup_tx_ring is called by either the tx_timer * or from the NAPI polling routine. @@ -1063,6 +1064,7 @@ static void show_rx_chain(struct spider_net_card *card) /** * spider_net_resync_head_ptr - Advance head ptr past empty descrs + * @card: card structure * * If the driver fails to keep up and empty the queue, then the * hardware wil run out of room to put incoming packets. This @@ -1220,7 +1222,7 @@ spider_net_decode_one_descr(struct spider_net_card *card) /** * spider_net_poll - NAPI poll function called by the stack to return packets - * @netdev: interface device structure + * @napi: napi device structure * @budget: number of packets we can pass to the stack at most * * returns 0 if no more packets available to the driver/stack. Returns 1, @@ -1268,7 +1270,7 @@ static int spider_net_poll(struct napi_struct *napi, int budget) /** * spider_net_set_mac - sets the MAC of an interface * @netdev: interface device structure - * @ptr: pointer to new MAC address + * @p: pointer to new MAC address * * Returns 0 on success, <0 on failure. Currently, we don't support this * and will always return EOPNOTSUPP. @@ -1340,6 +1342,8 @@ spider_net_link_reset(struct net_device *netdev) * spider_net_handle_error_irq - handles errors raised by an interrupt * @card: card structure * @status_reg: interrupt status register 0 (GHIINT0STS) + * @error_reg1: interrupt status register 1 (GHIINT1STS) + * @error_reg2: interrupt status register 2 (GHIINT2STS) * * spider_net_handle_error_irq treats or ignores all error conditions * found when an interrupt is presented @@ -1961,8 +1965,7 @@ spider_net_open(struct net_device *netdev) /** * spider_net_link_phy - * @data: used for pointer to card structure - * + * @t: timer context used to obtain the pointer to net card data structure */ static void spider_net_link_phy(struct timer_list *t) { @@ -2140,7 +2143,7 @@ spider_net_stop(struct net_device *netdev) /** * spider_net_tx_timeout_task - task scheduled by the watchdog timeout * function (to be called not under interrupt status) - * @data: data, is interface device structure + * @work: work context used to obtain the pointer to net card data structure * * called as task when tx hangs, resets interface (if interface is up) */ @@ -2174,6 +2177,7 @@ spider_net_tx_timeout_task(struct work_struct *work) /** * spider_net_tx_timeout - called when the tx timeout watchdog kicks in. * @netdev: interface device structure + * @txqueue: unused * * called, if tx hangs. Schedules a task that resets the interface */