From patchwork Wed Jul 8 12:01:55 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235095 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp371600ilg; Wed, 8 Jul 2020 05:04:43 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy99BzRC3SCOwb/lMSTyDyF1RTY1909elwdf+KvqJSNwpH104oUARAbRQ8Td6nHuT9xbJEQ X-Received: by 2002:a17:906:4f16:: with SMTP id t22mr50253534eju.179.1594209883747; Wed, 08 Jul 2020 05:04:43 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594209883; cv=none; d=google.com; s=arc-20160816; b=ds4ry6OhO/1R9c+r4X5J/mRC6JCT1PFCSLnr0YtscvVbhx62zLSxH5dM7fWhbDt6dt Sro6CGy2zF7U7f2H9Y0cRcBYs74LktqahxfqnGAZH+lJMmSMT9IH6XoYCzcqCL+ln1Xu AZoC1nzaWIHE+bVHK6xpY2WhsepEwab5HY9dHW6fii3iOEUAFINAnqD/VXGNaw3rY8Yw 0x49+Q1oIfTuTngcLnug/w5gvAVk8hYKufJ1ChN0ZFxbvkGx3+h3sgFgf971wnb0G497 Mk2HUZ89UAxDiTmLcj3xjkUx5rlrQ5EOQH5jCVWBLk9Kmz8j7TJSjcUMILYye7eGu2fh d91Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=zj88WzcC8Hp115aJ2vlTY+pxEWRybRaihV1rme1nf/Q=; b=qaEDTopSo2yt2ac67k8cYKtnqbQB+qLwJhZ9RmrctojCMGuRqr7cD3/xmq4fqWJVPG JGlAj/1VoZgME3R7DHPUys1k0CP5tm4jVS5Dd4F4T+3Opz9WZ235VzWh0wsdfj2niNwz cD4waQMzl6i2FgTGJ9s/zRWgR0Eaq/a2nMBt+IFZ1v8I8HAWAiODDg1QKT9obC+OFGtp B7cxSzoRrBTRI6qGXGpHkhp8QUboLmRWLufqWRoPj1a/ThuFpPjN8FjhHrmVJe1qJ40U YDBosX8MjtvI8tkmfU4uvnUe0OfgAvFnwfMFmVVLy6p4dT0VpoPUqyAsm+xbNek0D1/V HOHQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=J5+Dp0He; spf=pass (google.com: domain of linux-scsi-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-scsi-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 a8si945803edr.123.2020.07.08.05.04.43 for ; Wed, 08 Jul 2020 05:04:43 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-scsi-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=J5+Dp0He; spf=pass (google.com: domain of linux-scsi-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-scsi-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 S1729196AbgGHMEn (ORCPT ); Wed, 8 Jul 2020 08:04:43 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55344 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728637AbgGHMCd (ORCPT ); Wed, 8 Jul 2020 08:02:33 -0400 Received: from mail-wr1-x442.google.com (mail-wr1-x442.google.com [IPv6:2a00:1450:4864:20::442]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 97DCBC08C5DC for ; Wed, 8 Jul 2020 05:02:31 -0700 (PDT) Received: by mail-wr1-x442.google.com with SMTP id z2so26408658wrp.2 for ; Wed, 08 Jul 2020 05:02:31 -0700 (PDT) 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=zj88WzcC8Hp115aJ2vlTY+pxEWRybRaihV1rme1nf/Q=; b=J5+Dp0HeyJVdvuXj8D7pcksR0L060RA13hVnHzmEuUSfmb+fExnpI95v2doAH5bgpM AerHZM65Y5A43lh6M1KxDXUEp7uKPcGChM5mNKuVi3J2s/d1jP9qF2+s6bEzGns8Gpbd Jmgw64cyc8ozeKeyLOd/7/FBN6QkujrHYgO05n3G7zRfFHGttwVLyAcKDQ529LKnV+3x BhFTJvTjrVfGMyRGZIzRGNg3ZHzByWbBxAmtupuVxhxMyhn+R5C6bbj7VYoBDPNzAJ9P TxkzDB4rciwtDU4q+WjZF/2KbEI/vScIQhTbz7KWw5oVcW1vCF4ORMZ6LQZA1UHiwD23 atzQ== 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=zj88WzcC8Hp115aJ2vlTY+pxEWRybRaihV1rme1nf/Q=; b=X4y+/6TPiPc4LjKujM0JVucolykGJ+pM7b/IS44T1y1Ce7xWC1dfDvcqkO5Fysgb2f +NGNYAX6HwO+VqBo/JGE1ZRk8bohYDhAPib4u6XYQHwW/RwBQMgqTDXTqMYiWWk8Mq/X eX6eKt3LNEYHOLzKI6daLni8FDOGhThVoIcqQ5i2TyDcPdC7Cu3iVCHlEG07ugsSCTjo GBkJ7GA2Bm3xV9FHbT1QSmGozZ9vfZP6p8bo2VNXtAEslpKa6vNO7Jg8J66jARIMo8Xf /mehlACNcCcxRnsNKYNeCyqsW7IFrO6TTfZbvEpiAj3lTPPrhnQsAbMG6H+2w9akKkuA rnZA== X-Gm-Message-State: AOAM531u9Sr+b5QlL8czBf4Wlp01itlz9tW9mIo3fNbaHM+q7dVkzPKx l+KCmpSq6OJLy/q2tCGANCaQCA== X-Received: by 2002:adf:82e1:: with SMTP id 88mr37661923wrc.376.1594209750242; Wed, 08 Jul 2020 05:02:30 -0700 (PDT) Received: from localhost.localdomain ([2.27.35.206]) by smtp.gmail.com with ESMTPSA id m62sm3964997wmm.42.2020.07.08.05.02.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 08 Jul 2020 05:02:29 -0700 (PDT) From: Lee Jones To: jejb@linux.ibm.com, martin.petersen@oracle.com Cc: linux-kernel@vger.kernel.org, linux-scsi@vger.kernel.org, Lee Jones , Hannes Reinecke Subject: [PATCH 04/30] scsi: fcoe: fcoe: Fix various kernel-doc infringements Date: Wed, 8 Jul 2020 13:01:55 +0100 Message-Id: <20200708120221.3386672-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200708120221.3386672-1-lee.jones@linaro.org> References: <20200708120221.3386672-1-lee.jones@linaro.org> MIME-Version: 1.0 Sender: linux-scsi-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org A couple of headers make no attempt to document their associated function parameters. Others looks as if they are suffering with a little bitrot. Fixes the following W=1 kernel build warning(s): drivers/scsi/fcoe/fcoe.c:654: warning: Function parameter or member 'lport' not described in 'fcoe_netdev_features_change' drivers/scsi/fcoe/fcoe.c:654: warning: Function parameter or member 'netdev' not described in 'fcoe_netdev_features_change' drivers/scsi/fcoe/fcoe.c:2039: warning: Function parameter or member 'ctlr_dev' not described in 'fcoe_ctlr_mode' drivers/scsi/fcoe/fcoe.c:2039: warning: Excess function parameter 'cdev' description in 'fcoe_ctlr_mode' drivers/scsi/fcoe/fcoe.c:2144: warning: Function parameter or member 'fcoe' not described in 'fcoe_dcb_create' drivers/scsi/fcoe/fcoe.c:2144: warning: Excess function parameter 'netdev' description in 'fcoe_dcb_create' drivers/scsi/fcoe/fcoe.c:2144: warning: Excess function parameter 'port' description in 'fcoe_dcb_create' drivers/scsi/fcoe/fcoe.c:2627: warning: Function parameter or member 'lport' not described in 'fcoe_elsct_send' drivers/scsi/fcoe/fcoe.c:2627: warning: Function parameter or member 'did' not described in 'fcoe_elsct_send' drivers/scsi/fcoe/fcoe.c:2627: warning: Function parameter or member 'fp' not described in 'fcoe_elsct_send' drivers/scsi/fcoe/fcoe.c:2627: warning: Function parameter or member 'op' not described in 'fcoe_elsct_send' drivers/scsi/fcoe/fcoe.c:2627: warning: Function parameter or member 'resp' not described in 'fcoe_elsct_send' drivers/scsi/fcoe/fcoe.c:2627: warning: Function parameter or member 'arg' not described in 'fcoe_elsct_send' drivers/scsi/fcoe/fcoe.c:2627: warning: Function parameter or member 'timeout' not described in 'fcoe_elsct_send' Cc: Hannes Reinecke Signed-off-by: Lee Jones --- drivers/scsi/fcoe/fcoe.c | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/fcoe/fcoe.c b/drivers/scsi/fcoe/fcoe.c index cb41d166e0c0f..0f9274960dc6b 100644 --- a/drivers/scsi/fcoe/fcoe.c +++ b/drivers/scsi/fcoe/fcoe.c @@ -645,7 +645,7 @@ static int fcoe_lport_config(struct fc_lport *lport) return 0; } -/** +/* * fcoe_netdev_features_change - Updates the lport's offload flags based * on the LLD netdev's FCoE feature flags */ @@ -2029,7 +2029,7 @@ static int fcoe_ctlr_enabled(struct fcoe_ctlr_device *cdev) /** * fcoe_ctlr_mode() - Switch FIP mode - * @cdev: The FCoE Controller that is being modified + * @ctlr_dev: The FCoE Controller that is being modified * * When the FIP mode has been changed we need to update * the multicast addresses to ensure we get the correct @@ -2136,9 +2136,7 @@ static bool fcoe_match(struct net_device *netdev) /** * fcoe_dcb_create() - Initialize DCB attributes and hooks - * @netdev: The net_device object of the L2 link that should be queried - * @port: The fcoe_port to bind FCoE APP priority with - * @ + * @fcoe: The new FCoE interface */ static void fcoe_dcb_create(struct fcoe_interface *fcoe) { @@ -2609,7 +2607,7 @@ static void fcoe_logo_resp(struct fc_seq *seq, struct fc_frame *fp, void *arg) fc_lport_logo_resp(seq, fp, lport); } -/** +/* * fcoe_elsct_send - FCoE specific ELS handler * * This does special case handling of FIP encapsualted ELS exchanges for FCoE,