From patchwork Thu Nov 26 13:38:47 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 332969 Delivered-To: patch@linaro.org Received: by 2002:a17:906:4755:0:0:0:0 with SMTP id j21csp152614ejs; Thu, 26 Nov 2020 05:39:38 -0800 (PST) X-Google-Smtp-Source: ABdhPJzYjwPYPFvJd6EMAEi6PlTDmNmafluW8e8Fe5YoDG6cwHg4/WvSuprzI9yFz3vcoHXka1C5 X-Received: by 2002:a17:906:b143:: with SMTP id bt3mr2762224ejb.318.1606397978243; Thu, 26 Nov 2020 05:39:38 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1606397978; cv=none; d=google.com; s=arc-20160816; b=VDLLIBbqA10FVS/LwSlFFvaszi4yRctwez8KB0WEXbqHFVSmYq7ez7DyD3LWAtXte2 Ulob58QJuT7dHaS5z243/BvfhbDxqEUGeBL+5ObFJo0ec+897xYJZmZThw9PXQ6IhJ5S 5bdaoz3XCEX1/Jy59kuGJunvsnFtt0V2/lwwU8/ZB63bqvC+mmfFeS4R22iS/N4wSnN5 UQzeir/JChKNBWZDCVeosDihkaQdIVyVJVbcZwMX/lfH4CGfQBVLAD6nS/9U8atGc8mR o/1kawTjnCDzINSPgY3X7ewjUqZuKbhQRFtcAwIMZ6Db4S4A6S4dmElaGBde0Sxy0ajx oA0w== 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=PvDQ8jiSdggfocg7QevhSStHyCThX2E8vELTACyHnVM=; b=DTsHuiuWygNxnKVoe1lC4rJYki9MMwRlwVTVWWBT5MPutYRPaYFcBxKScjcHM6WmcQ 47vI8FGBMPgPy15LxCzFhhe7W9TVlUn4F7dPZc3ZqWfpmSuvqarnApSPQgkDBjvVBb9E 0qbd3pG258BydMuj1/V/nJ2doMt4xZztlNWuepTbleA5vg+laKrO00WItuHaAiL0hIYc e1Vs46h43NYaBF/1ZaHEsgVQ5FLx5AeK7JVf06kBN9GX/DwVSGD6jczV5+8yDgmOklbR Y5IWBuzvdPwYhRBN5GFo0P9ve4XbZTfeXbv9q0VoVI4SEms3hX/BPWpEMvAp+J4qbkjJ JgJQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=hfIUxVh9; 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 bt20si3037473edb.405.2020.11.26.05.39.38; Thu, 26 Nov 2020 05:39:38 -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=hfIUxVh9; 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 S2390444AbgKZNjD (ORCPT + 8 others); Thu, 26 Nov 2020 08:39:03 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58202 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2390368AbgKZNjB (ORCPT ); Thu, 26 Nov 2020 08:39:01 -0500 Received: from mail-wr1-x444.google.com (mail-wr1-x444.google.com [IPv6:2a00:1450:4864:20::444]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3FEA5C0617A7 for ; Thu, 26 Nov 2020 05:39:01 -0800 (PST) Received: by mail-wr1-x444.google.com with SMTP id l1so2176186wrb.9 for ; Thu, 26 Nov 2020 05:39:01 -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=PvDQ8jiSdggfocg7QevhSStHyCThX2E8vELTACyHnVM=; b=hfIUxVh9cOOEk1+Xnm9Js0JYx8f+4mDVffWLE+RpCmxL0UzygV22nLn5ImHdR94WtJ V84dJowMWFbBc/vOV5VcNtNwABoiSipolRFrT0sotRub7aAlqP7agQXikgVrvCdA2QhE 1XMvyzZ2DaV11usuc9FgvVwCcGCAeKOuUfuG2YhlvYZaw/Cosi3dFUAOofTHESywFkhR lXBStbyPFd9fMWdFbVbWSRWZUoZaIwrvHuPNfaOuddOq/VwH+UM2FYbBPeQvNclUYX3v bWqIk2ZR8IZOZymlbf8n4zvsR+avPkwgP+ylWMDUOng9/e7F1EqjwxWl5IwWm0RAijtc 4L4A== 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=PvDQ8jiSdggfocg7QevhSStHyCThX2E8vELTACyHnVM=; b=HhsYUMgcWbloGxgSF/tZokFM0BiavONcoTCgyTFAeld9sB9IN/o+0e0psA7BIE6yP/ pgMS014q8vbToQI7XwyaCrCoPHzzYF2ulQ20V5x/p1XH3W0maabOzS3IE1b8rxCQW9WC rPbDxgX5unB75mzAdQrfwTaIP6pFHP/bpSaetvO87P/x+xPOKjQmYJRf5BFrarGWdOA4 v3U6oFv9p39GEuIH/cFNZmmUvLnN6cqQVeV8diBTQyNzshiY9TWbQG+siF1+MQNOtomd taJEEcMSu4hRuQyQt2rUHvkorj8cc51hAvaFV6LW19muGynMyYWhaOfRetNUMJodJ2tE zhww== X-Gm-Message-State: AOAM531pfXdtXzGpkqlN7HaXA5i3arEMzQgxeBtonsZUvs2tiAyzkAzo GK2z9wmy5BF/H2OIisedgua+cw== X-Received: by 2002:adf:ed12:: with SMTP id a18mr3939773wro.5.1606397940009; Thu, 26 Nov 2020 05:39:00 -0800 (PST) Received: from dell.default ([91.110.221.235]) by smtp.gmail.com with ESMTPSA id s133sm7035825wmf.38.2020.11.26.05.38.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 26 Nov 2020 05:38:59 -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 Subject: [PATCH 2/8] net: xen-netback: xenbus: Demote nonconformant kernel-doc headers Date: Thu, 26 Nov 2020 13:38:47 +0000 Message-Id: <20201126133853.3213268-3-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201126133853.3213268-1-lee.jones@linaro.org> References: <20201126133853.3213268-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 Signed-off-by: Lee Jones --- drivers/net/xen-netback/xenbus.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) -- 2.25.1 Reviewed-by: Andrew Lunn diff --git a/drivers/net/xen-netback/xenbus.c b/drivers/net/xen-netback/xenbus.c index f1c1624cec8f5..de1b5471d929b 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, @@ -992,7 +992,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. */