From patchwork Mon Jul 13 07:46:17 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235335 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611631ilg; Mon, 13 Jul 2020 00:48:50 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyCnwhVnL5izFFfbFOR051OzKty97Qmu+hd1+s1xl7SZvh576ONnOiL7DmS11anVnhB7gnN X-Received: by 2002:a17:906:4145:: with SMTP id l5mr71652263ejk.334.1594626530218; Mon, 13 Jul 2020 00:48:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626530; cv=none; d=google.com; s=arc-20160816; b=NSH5thfgL15kv3wFwyrvawfp5IT2X6E2HrI9si2v8MhU+qRX7e8+2sE1S1E6x6uSXi snUK6R3IY8Oc6ZVpTYny8FgfPCqK+nTNUptj47ypD07DXwXqBtc2EDvZzqRk5L9lMVwA QX6VPq5ovXMAsOiaRDmeXiFplOhOTFTS7HIcAJOVhYK+JwkPfnP1qQUqXgsmbsfDSjmW rJ7pNvmX6daH8q1xgYRjV0aTBQKBhVy01re7uYybvqc10UscDVGUDSC5FrnNPUprqIKA 8n2VLNAET/DpKEv1Kfj3GIIIaDHEw8p9WF0CmQeLmK9ljk9cxEGlJsml0TQXrvNO+q7C 6p2Q== 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=OYcU6QrkQ8vEFK16KZ0JwglvYSsa1RsL+nSDllm7Llo=; b=iD4hdeqKVQzflRMQuTrA8xHcR8JjSqMBoknsclRi/gd91RskwCyiROdx3+WsuuINB8 qVbHd/7hM1GDntfPbP4KzBy1MGyAb2v7qIq2T78M8Ew+9n+t96eZrWzrYlR8it6PeUCZ AYRnprmxajLNC7p4sW67EynI9mdBcGwmeWJQYiX3JJ4+MYvvqh5nJA1z4DUWOF6RBel9 Jfg4HKc3RrLlPGJu7OJFZ+qfyjpybdRKf3tsUtn+83684qT0q9MjnEjVSG3hlB7GqMZY PqZl0DEEhFiEK1rw8FJRT1ingvlyigI8shhdsR3NFyTYiMALwUzCbs6+Ft9kDNTenzA9 dLag== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=uKjnZBDe; 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 la26si8093218ejb.587.2020.07.13.00.48.50 for ; Mon, 13 Jul 2020 00:48:50 -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=uKjnZBDe; 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 S1728950AbgGMHqv (ORCPT ); Mon, 13 Jul 2020 03:46:51 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50294 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728924AbgGMHqu (ORCPT ); Mon, 13 Jul 2020 03:46:50 -0400 Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3884FC061755 for ; Mon, 13 Jul 2020 00:46:50 -0700 (PDT) Received: by mail-wm1-x342.google.com with SMTP id o2so12176471wmh.2 for ; Mon, 13 Jul 2020 00:46:50 -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=OYcU6QrkQ8vEFK16KZ0JwglvYSsa1RsL+nSDllm7Llo=; b=uKjnZBDeRyG1EknaFH0tWOPAPon6eULfa3m5fG1bU65epw0uIKT1OznCzv4UwRgUqZ S0C2ZTHAALw5KBHRlcQ6tQ4tIoZ5JR6aWHfn2UGJ925S8pXbmooOT1SrFsCJi7DTVOq/ jBuic+m7tzQpyDe3+0X4jCTcOAB5l9KSZ8BC1bEyt4ztVxYtX3GLy6et1SEr4P+q2wLV 5uz/DGRedkh1YS9IVBL/NOlcE9c4+tWnxSMHfTgfB+Iy8kXmj0gfQkUi3a1sZUUh1rvu KsDAf8i6JIbuWr049BRZQWS9WQYgQ8p1k6rz5M/rCYHVxEPAi7WSm9twDYhA/J028FnR XqNA== 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=OYcU6QrkQ8vEFK16KZ0JwglvYSsa1RsL+nSDllm7Llo=; b=Kh7yKrFXqOxkQm9outbL4WkMhXP/41vXr1dWqGMyPMnV+7NFazDmN8WW2El4jAgZN9 swH+hSpCA8rpbZM0ml16m+vWaRvCnjHxR1h3RZtyAF5ZKJk6Ann9Xn60pN2ZBuGNHw9Q UUmHvFxU2iq7q/M1pgfcW28qRmuoH2AUtl8Sw9nnnAiFlEARKnTqkk1rBkaWn2f8pL8V f8hoJXu4QB0nE+LbnF06Yoyy8hF2MYLrj2TCJRjF0sHXl0toZOelObcNTA7BqxVByOQT B/UDBO74SFbVgvkJb3gy8b3uINx0ODCuqaLUr9e7islz9KLvgs/ZfmwPMOYzvJ9+ey6H 7udw== X-Gm-Message-State: AOAM533tLi7udoydu5GHw9XTkBRWqNihn6Du6nbphE3vpSe79C+VASLj FeRhv5ynD0ShJQ9YBKfinAjvVbPTlp8= X-Received: by 2002:a1c:28a:: with SMTP id 132mr17366357wmc.109.1594626408932; Mon, 13 Jul 2020 00:46:48 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:48 -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 v2 01/29] scsi: libfc: fc_exch: Supply some missing kerneldoc struct/function attributes/params Date: Mon, 13 Jul 2020 08:46:17 +0100 Message-Id: <20200713074645.126138-2-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Fixes the following W=1 kernel build warning(s): drivers/scsi/libfc/fc_exch.c:66: warning: Function parameter or member 'left' not described in 'fc_exch_pool' drivers/scsi/libfc/fc_exch.c:66: warning: Function parameter or member 'right' not described in 'fc_exch_pool' drivers/scsi/libfc/fc_exch.c:100: warning: Function parameter or member 'lport' not described in 'fc_exch_mgr' drivers/scsi/libfc/fc_exch.c:727: warning: Function parameter or member 'ep' not described in 'fc_invoke_resp' drivers/scsi/libfc/fc_exch.c:727: warning: Function parameter or member 'sp' not described in 'fc_invoke_resp' drivers/scsi/libfc/fc_exch.c:727: warning: Function parameter or member 'fp' not described in 'fc_invoke_resp' Cc: Hannes Reinecke Signed-off-by: Lee Jones --- drivers/scsi/libfc/fc_exch.c | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/libfc/fc_exch.c b/drivers/scsi/libfc/fc_exch.c index 52e8666598531..16eb3b60ed582 100644 --- a/drivers/scsi/libfc/fc_exch.c +++ b/drivers/scsi/libfc/fc_exch.c @@ -49,6 +49,8 @@ static struct workqueue_struct *fc_exch_workqueue; * @total_exches: Total allocated exchanges * @lock: Exch pool lock * @ex_list: List of exchanges + * @left: Cache of free slot in exch array + * @right: Cache of free slot in exch array * * This structure manages per cpu exchanges in array of exchange pointers. * This array is allocated followed by struct fc_exch_pool memory for @@ -60,7 +62,6 @@ struct fc_exch_pool { u16 next_index; u16 total_exches; - /* two cache of free slot in exch array */ u16 left; u16 right; } ____cacheline_aligned_in_smp; @@ -74,6 +75,7 @@ struct fc_exch_pool { * @ep_pool: Reserved exchange pointers * @pool_max_index: Max exch array index in exch pool * @pool: Per cpu exch pool + * @lport: Local exchange port * @stats: Statistics structure * * This structure is the center for creating exchanges and sequences. @@ -702,6 +704,9 @@ int fc_seq_exch_abort(const struct fc_seq *req_sp, unsigned int timer_msec) /** * fc_invoke_resp() - invoke ep->resp() + * @ep: The exchange to be operated on + * @fp: The frame pointer to pass through to ->resp() + * @sp: The sequence pointer to pass through to ->resp() * * Notes: * It is assumed that after initialization finished (this means the From patchwork Mon Jul 13 07:46:18 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235336 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611679ilg; Mon, 13 Jul 2020 00:48:57 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxTAN5GY6pDCVZHBaNHvirHwCTsDNyelwLLNlQFM1Jo0/DAn1g2HD0oQ8Y23DrWRQFasodh X-Received: by 2002:a50:8e53:: with SMTP id 19mr74616486edx.185.1594626537490; Mon, 13 Jul 2020 00:48:57 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626537; cv=none; d=google.com; s=arc-20160816; b=vS7JW4jqZYNVckfyEL65DR3Unlos+muIlOZIgsW8rbt6IEGrnkbxUbyHuSiLI3A3kP bRKXytLWlc+ubOpE6wTQzrHz2ek8uNBmc8syGgx6LCtob2n+ZV8d1UhuAlMdAVZfqDEr JFUPqO+FWpNdc4bA4PndKTZRatOZP8Qx4ZucgMSVQih+33TRTnlRhOQPy9BE419b9evD Cc/fWqvNHXExIKWTZtnTbp+iRZj6V164UUptEzqGikKtWXZyrK2KCZgIes7T01RGaruy VTfe1tDjHlctbGJGwNzvIIlhKqW1ZF02UcUuZFjK3plUG7DcksFtulKZbhyJimcokP5e 4e1w== 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=Oudq2oeculi6K4POMA0xfQMiSgZLhEbNGoOFwG0ADmE=; b=Df/K3TJLuTsRMGGMNUMAKzodcrHhFSIc7YcnTqJtBOZGNGOtHBuNXZnoszynnCi2vb 0eVmyQeU+kb8QEagqJvMHcjeNvxIypv8NLrHnYJtS/LqumZqUqkkc/rlCxXkxQEErVVR i1Mu7Lsh1rQJ0vlyvqNw2winBgV3xymKMAPZaThmzwo/OOodGUW8BAKSRIcuYntMgPqs pYKWC5WOfraNuIM/8OBIuDgg84pgX7o2fjsPlGVvGobY6R5sZg5euwp/lxrXHcYQr1QP aNSKXnBMlqJXtkJy6zInsNl/v/WjnPLm9e543SowKHHrWDBB/EqDt74DYe2lWzyga+kA 2k7A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=VLiZTK1Y; 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 u6si7592311ejf.218.2020.07.13.00.48.57 for ; Mon, 13 Jul 2020 00:48:57 -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=VLiZTK1Y; 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 S1729370AbgGMHst (ORCPT ); Mon, 13 Jul 2020 03:48:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50302 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728942AbgGMHqv (ORCPT ); Mon, 13 Jul 2020 03:46:51 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 32D95C08C5DB for ; Mon, 13 Jul 2020 00:46:51 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id 22so12326014wmg.1 for ; Mon, 13 Jul 2020 00:46:51 -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=Oudq2oeculi6K4POMA0xfQMiSgZLhEbNGoOFwG0ADmE=; b=VLiZTK1YdPounijVnkxQ3ZjJXAksw6WHoLAGOcJ3PPwwLBAgKzsO6C68bpRtW2oM8l P23zcEDL2q+LbLvngUYT6ZEFO7pKZl7Sl1hb8WA9PtC+MBlZViu3jYskVRT8pEhii/rA tV+xAXEneOWp4sRcXUk2nE9UUDl6b6sYd/KiRLeEDlJ81hehGArRGwNbA4NyHz3zCFqH tfE0GL0v7JUnk1UakZgNbPJy2wlhfqHB95cb8DXF1OJn4bVgYFRygsN/fEKxc3w7QUFP Xdsjd76DNvdjJGLL0aHhfKkP13hnEqjI/fB9oeAOTc13rdVgfP6fz5eoFK4fU/FTsCoB ZjXQ== 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=Oudq2oeculi6K4POMA0xfQMiSgZLhEbNGoOFwG0ADmE=; b=ruqXx0nQEi8u/w7uPBv1+OnW9tP31zAuqfaV4Q3HcNg1+wFTfFra5mrftLhF+TEM3h 4IGVS+fGhgRGbUIIWjGYu8x3ODIujBi2axZE0swg3V9Z5CUB+HaXNdRMjtLkbTbUlacM XEqR4kr68wFEXmQwnr0BDP0pdGh0usxfJYD4ea/oymIn7OYPYbGEzPQet8aCscO5Dnt9 R14pON9CyB7RU3mYbeH78BBaZ4F1D0mD73MGWTpZ+Ql1GT9jXxSIu7YNZS/OXpLl5cFx VIuQEtqVR8JsiZ1Y04ppYiy6xcKfi+r3dwkeATbwdgK1hF2kyfvHG+qUThYQyS94ga75 apuA== X-Gm-Message-State: AOAM533XbgXGFWBT8igL5Pxtlfk2G5jhn/j+VSPB6Rfq9gxATJUSGdZj 1b8q4VmobxzgEOgvsSHUFNgoeg== X-Received: by 2002:a1c:4d11:: with SMTP id o17mr17317622wmh.134.1594626409906; Mon, 13 Jul 2020 00:46:49 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:49 -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 Subject: [PATCH v2 02/29] include: scsi: scsi_transport_fc: Match HBA Attribute Length with HBAAPI V2.0 definitions Date: Mon, 13 Jul 2020 08:46:18 +0100 Message-Id: <20200713074645.126138-3-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 According to 'include/scsi/scsi_transport_fc.h': "Attributes are based on HBAAPI V2.0 definitions" ... so it seems sane to match the 'HBA Attribute Length' to them. If we don't, the compiler complains that the copied data will be truncated. Fixes the following W=1 kernel build warning(s): In file included from include/linux/bitmap.h:9, from include/linux/cpumask.h:12, from include/linux/smp.h:13, from include/linux/percpu.h:7, from include/scsi/libfc.h:13, from drivers/scsi/libfc/fc_elsct.c:17: In function ‘strncpy’, inlined from ‘fc_ct_ms_fill.constprop’ at include/scsi/fc_encode.h:263:3: include/linux/string.h:297:30: warning: ‘__builtin_strncpy’ output may be truncated copying 64 bytes from a string of length 79 [-Wstringop-truncation] 297 | #define __underlying_strncpy __builtin_strncpy | ^ include/linux/string.h:307:9: note: in expansion of macro ‘__underlying_strncpy’ 307 | return __underlying_strncpy(p, q, size); | ^~~~~~~~~~~~~~~~~~~~ In function ‘strncpy’, inlined from ‘fc_ct_ms_fill.constprop’ at include/scsi/fc_encode.h:275:3: include/linux/string.h:297:30: warning: ‘__builtin_strncpy’ output may be truncated copying 64 bytes from a string of length 79 [-Wstringop-truncation] 297 | #define __underlying_strncpy __builtin_strncpy | ^ include/linux/string.h:307:9: note: in expansion of macro ‘__underlying_strncpy’ 307 | return __underlying_strncpy(p, q, size); | ^~~~~~~~~~~~~~~~~~~~ Signed-off-by: Lee Jones --- include/scsi/fc/fc_ms.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/include/scsi/fc/fc_ms.h b/include/scsi/fc/fc_ms.h index 800d53dc94705..9e273fed0a85f 100644 --- a/include/scsi/fc/fc_ms.h +++ b/include/scsi/fc/fc_ms.h @@ -63,8 +63,8 @@ enum fc_fdmi_hba_attr_type { * HBA Attribute Length */ #define FC_FDMI_HBA_ATTR_NODENAME_LEN 8 -#define FC_FDMI_HBA_ATTR_MANUFACTURER_LEN 64 -#define FC_FDMI_HBA_ATTR_SERIALNUMBER_LEN 64 +#define FC_FDMI_HBA_ATTR_MANUFACTURER_LEN 80 +#define FC_FDMI_HBA_ATTR_SERIALNUMBER_LEN 80 #define FC_FDMI_HBA_ATTR_MODEL_LEN 256 #define FC_FDMI_HBA_ATTR_MODELDESCR_LEN 256 #define FC_FDMI_HBA_ATTR_HARDWAREVERSION_LEN 256 From patchwork Mon Jul 13 07:46:19 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235334 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611609ilg; Mon, 13 Jul 2020 00:48:48 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy7rmyWWQcuMcyJ9yuQx5Q/8NM0IHkXLT6/qhGQfAjJoCXXZhyAygZC59eEd/3vfF/3ep4B X-Received: by 2002:aa7:c606:: with SMTP id h6mr88814801edq.363.1594626528595; Mon, 13 Jul 2020 00:48:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626528; cv=none; d=google.com; s=arc-20160816; b=p8muzZZAQmxgXo7eDP8KadW92kLbMP1UUC/+7KQkzBA33o4Jksp/lo5LjJUG093Od4 HgyaO+SZbkEBXnOUdSVKp6HIaFHjqAZBIhQ7pyMs+cIEBiOCCIzl8oE4d7BtIdqgzYnH VlSYwOtagIOTYxQGPAapZOZ7sjt/bcYudpqIMUDfqhuIE9rkYB3+zEiIktlZhZKr51Ee nXZhiglHBDaE95JdAtc214eaBqdn2ynOVavv8l3p6yuHkWZiy0Es1/Ye1iNr5rfNPcF+ 9TC6lY4DN++ScBG/PB5M4LPhfl+rFsh8YoCkuXVX6joA2mDDq//3GDkT/RDU/jOykg3r +AJg== 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=/GI6WmzBD/tXdjRqMOCJ6wEDBpBeiEpQ/v95OUrVAL8=; b=Tch4Y/XElT8OPYI11LqbGVuRcYB28c9VYzhN2w0Y5gg49tIrcfyiigkiiP3FKt3Iv2 XV6qiaD1AUypv1GBl/QwsvVLxZo/qRSNA4X+Nurwz5HSgwt9g6gAWAUK7tOzxQUFDka6 xu1dlozVjfL+q2FOOpOXqvwfps17NkQvFucL2UJ++B6XSqR1o+w55m6NWIoa4CwDCBK4 zVUHJ63DJKnsGu2TGyhewGk3YkeJphzm6sOXj46SGY4Ed+OBllkCJmk2ZMjeUr3PrOG4 50UC3BmGPoOnWmd0jMDH5mlZIHt6KCfCKcRvDBSMW8umL1nRDvzIsiftM3QqZus+UpM4 GVBg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=K3d3Rmaz; 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 la26si8093218ejb.587.2020.07.13.00.48.48 for ; Mon, 13 Jul 2020 00:48:48 -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=K3d3Rmaz; 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 S1729607AbgGMHso (ORCPT ); Mon, 13 Jul 2020 03:48:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50310 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728990AbgGMHqw (ORCPT ); Mon, 13 Jul 2020 03:46:52 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 706D4C061794 for ; Mon, 13 Jul 2020 00:46:52 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id g10so12723738wmc.1 for ; Mon, 13 Jul 2020 00:46:52 -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=/GI6WmzBD/tXdjRqMOCJ6wEDBpBeiEpQ/v95OUrVAL8=; b=K3d3RmazezaQ2JfntIC75Qh0KE2jdoNSsaYM7hkzV2Bb+6dWctrMMtyr7sZ7VQkSib zGc6Z0TdG4wRnNN/oCRTKOPCxNtvu45UnCRbWmN5hQLpfD12YM3KsoBSpp0iKq3VNtW7 GE5YPDWrqyuRC24k4YNMDLVLkpwl2bZOGvrzS4WiFpSZ+wnNJCOuVQFcHqYhEUZZMERB PvI2MrT06G34KgwgztjCSDDvaa2zuvsxnJNiDNyCU1oxPT59rQiejRsHpMvxvvADRl+w gzEiksVelJJuezSK6nLRnh4qSJxnagPKE7ksTzR6IsY0fhlkfDCtzD1sYkH1mBswrJ9u ZDrg== 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=/GI6WmzBD/tXdjRqMOCJ6wEDBpBeiEpQ/v95OUrVAL8=; b=l6sjkIh14L/NfDiCj/GwYS5677TczAF7RPKMu8aCWYjvXYXbrOg6uKOfhjcR6cG3nL QtC1nmSLnx2AcqbB9ErkQte/niHwYHUL1fnBt3dDs7VzRbNYu9MuqxmmR3fzEScYfgq1 BZs6GoK21PJWH2G6HAm767l//y1A2B+AD1tAD4CMBqw9c83yq61HAQI7pouq+CNIzfio 8vC1In0ftJocso7txrPE+82oQYxLV8hm5xymFoz4fo/2B9RH4BQdujRUopwVQP0v+kTt fECoFCgNkXAkKstWVqAzr/52YoGbPaD7T0ki0V2vBMLPz3N7SLdoWZreoI7rFnV6E5/h aRXA== X-Gm-Message-State: AOAM533tie/sgdUvo6RY6jWmHBhle48Ts6nH/mTkDCeVotJut1tCeY8P 1q6F5U9a1oOXiDlpBHqHmw6COQ== X-Received: by 2002:a1c:7315:: with SMTP id d21mr16920174wmb.108.1594626411102; Mon, 13 Jul 2020 00:46:51 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:50 -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 , Johannes Thumshirn Subject: [PATCH v2 03/29] scsi: libfc: fc_disc: trivial: Fix spelling mistake of 'discovery' Date: Mon, 13 Jul 2020 08:46:19 +0100 Message-Id: <20200713074645.126138-4-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 This is my fault (can't even blame copy/paste). Cc: Hannes Reinecke Reported-by: Johannes Thumshirn Signed-off-by: Lee Jones --- drivers/scsi/libfc/fc_disc.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/libfc/fc_disc.c b/drivers/scsi/libfc/fc_disc.c index 428f40cfd1c36..19721db232839 100644 --- a/drivers/scsi/libfc/fc_disc.c +++ b/drivers/scsi/libfc/fc_disc.c @@ -370,7 +370,7 @@ static void fc_disc_gpn_ft_req(struct fc_disc *disc) /** * fc_disc_gpn_ft_parse() - Parse the body of the dNS GPN_FT response. - * @disc: The descovery context + * @disc: The discovery context * @buf: The GPN_FT response buffer * @len: The size of response buffer * From patchwork Mon Jul 13 07:46:20 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235333 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611579ilg; Mon, 13 Jul 2020 00:48:44 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwcquoRMz0yOByY+MX1/J5j1MN38OrmbCrM+HlJ6uAREtCwtZnaPqfzYx8YYkkrBpiA8Y8w X-Received: by 2002:a17:906:f2c4:: with SMTP id gz4mr71180301ejb.484.1594626524128; Mon, 13 Jul 2020 00:48:44 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626524; cv=none; d=google.com; s=arc-20160816; b=iyrX6f2zW+HJVoIaa8IikqDwszl+0cB9jMccZftVxzAobxe7q7Zc69opYi4ZpIjws8 0PFsfCQ5HIKOPRprCQNeBzCm6W9qvRh+jP9yAMWjhbr/Av+REnqRTHdmoccdnfuvvniX xU1cvkJ/8EVM5ZJXTT8XzmyJETnKREYaBF1O8oeieevkG1yeuO+gb/VW3ojyCXXUFV/b ep+EHOkMJ+hzKosSfhzI/rcvcPk57UXMKObKX/sngiD9CJJQDmwbUe+8SO1YXDfRpvGY cEEpnwlXdZY7ImT9q33A8cGt+PPjqxCdCnhFWAeYY+P1SHChp8GX+ur8Re+RrlYc7hSE iZEg== 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=cn0vnZAQCiOL6yqppsyOv3EiQZACVBBUgFVO/3NXgm3QXL5Hx+9iXGHCuCPIDrqxj0 puljFK4frqYtpgKTowJDm5/1TaO5xDr8drZ0uWIP9CzEH6H61LCHA0XrpV7YnllHDFFl MPXOOeVfsin7UDvWVfX/biRSrEHnPLLZsy4VGl+EGJJ6evu9jaCu3tcxmrm1NsRJwzK6 SNK6ZDtcWrqvY0JxIF9cLK7MC4CcaiB5NIZD2DukRH3WNSfQCSSBasuag9O9x+WkrcyL MAtZLu/pSkSn7zweQD4HRwLtjB7aXi73eHDvo3jtgIcH1D0zFMMPn7PGrWuzARlyUcuc MfeA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=NrLIaKrf; 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 bt23si8303152edb.545.2020.07.13.00.48.43 for ; Mon, 13 Jul 2020 00:48:44 -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=NrLIaKrf; 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 S1729027AbgGMHqy (ORCPT ); Mon, 13 Jul 2020 03:46:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50316 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725818AbgGMHqx (ORCPT ); Mon, 13 Jul 2020 03:46:53 -0400 Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7AD6CC08C5DF for ; Mon, 13 Jul 2020 00:46:53 -0700 (PDT) Received: by mail-wm1-x343.google.com with SMTP id 22so12326127wmg.1 for ; Mon, 13 Jul 2020 00:46:53 -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=NrLIaKrfsALs500eqVYpgsTXCnYflEJf0bWehrQs5JqkPeaGMXY8hmZBUbXqoSUxZJ 6gq7pJ9Vlqqs9yP6gIj+JmDIBW0wyEV86+7gZMzIK3E5PrsT8f2ga+lyg7MvuwzTwywJ vg66404HWx02HC5FGvbu4Q+jayo3Z3JM6Llq/Nsf/JftOx+Nf3qyjJ+5HMlQH6NXf0nT kbf0k1k1BOrtrv/k9im25OZn/Arpn+AJhSefVJ1250HFOAZ9zNfzOF0Q7kVIeL/omgSS uDdxRAENXmSU9ZSFW8c29IIAuNdoIOqfXa5xkGQYv73vd8sca/j9NXxTsBXF1rkjDIzP dTMw== 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=eeK2t3llv680P8pgQsMxJFvRI1+DIsHC8DpGs/bNM+M1QzoBtuWjN1v8wtP5dA19k3 GPzoPQHcyIgeFKHLMaQpSh3kzJtn0+htbGvOzQ01i/0N82sNRqLSzae3FR0IXAnQc/Vk d5GhzBIyBkCClhdmyQB97q1bXftI4KdUkg75kNEmKWdXy6/h5BisY5aK3kaDFgpRZCDK iEB/6UAAytfAtqH8UepGRGNc1IergtyCrXwTYC/YejSUs3kvvXemgpySt0YKf5Zfn4Xl riKKSZAZ5lwiKvqFJvmh+A3g/4uyMjbJYBDwR2aVl8hkyaAW52cMX+g0Gx9H9MIFNjDC jgYA== X-Gm-Message-State: AOAM531nSjQR+NF5QSNiK8qvLheMpDPl1tvIN4AYJ+tEORwl5WoWVjay 7VRCx31fhRlmeuElPz69R+Jwcw== X-Received: by 2002:a7b:cd07:: with SMTP id f7mr16879487wmj.115.1594626412253; Mon, 13 Jul 2020 00:46:52 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:51 -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 v2 04/29] scsi: fcoe: fcoe: Fix various kernel-doc infringements Date: Mon, 13 Jul 2020 08:46:20 +0100 Message-Id: <20200713074645.126138-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Reviewed-by: Hannes Reinecke 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, From patchwork Mon Jul 13 07:46:21 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235331 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611531ilg; Mon, 13 Jul 2020 00:48:39 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwblMfMSSI20NFNLILyAcUlfowEb9IkXs37dwDpdMyRx/bqysf7KODQFa5KW7nTHQ25Qgby X-Received: by 2002:aa7:cdc2:: with SMTP id h2mr1837987edw.274.1594626519063; Mon, 13 Jul 2020 00:48:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626519; cv=none; d=google.com; s=arc-20160816; b=TvTRKnQsi/VAafEvB9hOzSSPCz+TDK/Mh0Zpzg5LXPx4GWlZ/vsD4rxJqR8M/RbOXc Rar6tam7Em0NKOJOlO5loHJJxcV9VyUaEa/EOQEZ8Lm3JFp1UyH/iHDAmNogn5oCT1KP J/G5sMTOf5H3zquobGwE6PemCmeZsaWWAPIzOEHpUnd7PTra/16R9yCixKavynOFSdtr +VYb3I2HgqPcAXr1uFiYarFMFOtUvHPDCPABKB7ABguk3NAkUJkDgPyPB/H/MmDgy7Nr HGh+qynKOCmeOIixhBrL07tcyu0sKe0BPFM1cQnTSMnKSMOuK2/c4u9Dyt/R3r08c1hG 1oPQ== 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=NOdYD3KnvBuwlGzK8Lnx8We5QJ0C1TZDV+3j7uFLFto=; b=J6DumhGYvhcR1FrEFhlKoP6Xlwwgw1c0j6R9pX2gX1l+DaY38twmb7MVYEPeGmfjbH TVp5kKsWNqHbrKL2FpqIfYEkQZyv0l2Z2834sWKlfYBFNG/OTq8yPcnEoytwa5rjSLCd b/w/Ytt5RJWbEl/gSF5+p8vWBpjBn/fYYtr5SAlKSRRmo2/+rFdJ6X3NtoPf/9VxpG3D WUYsWJLxuDFmgjbYkgCOtN5/UPrfS0yuRsyLN/+456H49eHOz9GkdLELxDfBENj8wEcG /6it7tR44kL9FigAqqo19dHRRyVdfdBeygZaCDx8InE5zoWZXkrVEa5RyCKTh7RGdFIa T2kQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=CvAw4mHH; 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 bt23si8303152edb.545.2020.07.13.00.48.38 for ; Mon, 13 Jul 2020 00:48:39 -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=CvAw4mHH; 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 S1729148AbgGMHrA (ORCPT ); Mon, 13 Jul 2020 03:47:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50322 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729035AbgGMHqz (ORCPT ); Mon, 13 Jul 2020 03:46:55 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9038EC061794 for ; Mon, 13 Jul 2020 00:46:54 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id q15so12317758wmj.2 for ; Mon, 13 Jul 2020 00:46:54 -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=NOdYD3KnvBuwlGzK8Lnx8We5QJ0C1TZDV+3j7uFLFto=; b=CvAw4mHHnyN5jjBhp6RQGxrb+maMJ6ZDQ1eJ3mgsEN2vBPxmivpVl38bnnNVF3gUxh aq7hpGf11YFf6yrT9j0Js373rTmIVI0APKLJTcTojkwKQgOto9q5b6MAMGW/3t5OqpfU mzyMKyA3Ftn4CTh5G+cONiLeNkZJKawrPB745hJtkrWPBiW5KQ6RdJjIi0EkQIEChoRk Bm0aR19MwH/6/Kvp3zFDFsaBCJ/WNffWNDn0KXm2KdXH9tSp9mCNvG+QOP/M91cUO3TY SlA95eudbVN1h0ErLiJbG3MWY1HlJ+uK7itidzpAr+xugFT0mA6gMYSxPmN2B3p3ridv ZB5A== 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=NOdYD3KnvBuwlGzK8Lnx8We5QJ0C1TZDV+3j7uFLFto=; b=QrRhAKo0/xcZeb7bjWy2wDjbZX9E1BRaBKu7POobE8XRmx09fe2TA1AoaDLeVVP74E pSFiqJgydyLu29D/jh9S67jZT/7tz4gbDIARcjYLox//pQkM6kOABMFx5FTKbfmCdaMF OVXhyiSTlj+DeLmmKNrrwJt9QtRklikUwhmE8V1TJJdxfGHV4/gAoCQj4aYlRjvWpr2m D/1ak2eU3n2cRRHLklNefPCBKPy5D+Mk8eHpGOi5HLYM2CclvB2vsEt6Fb02bdSb7exb UwqfzAcBwLU6gzi2h9eAlQ5t9okpj5rlIM+KuLcCA9HndKSeEvZmP47sPn2qB09e5NqW fyoA== X-Gm-Message-State: AOAM533iLMbTeYbelRXKwIrx/hSHk4mrGcPne0S5mKpqA0ddjJkrgYOv G3xcJ6n+kYFRoW+e3PPB+zKqIQ== X-Received: by 2002:a05:600c:2154:: with SMTP id v20mr18917076wml.185.1594626413124; Mon, 13 Jul 2020 00:46:53 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:52 -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 v2 05/29] scsi: fcoe: fcoe_ctlr: Fix a myriad of documentation issues Date: Mon, 13 Jul 2020 08:46:21 +0100 Message-Id: <20200713074645.126138-6-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Mostly missing or incorrect (bitrotted) function parameters. Fixes the following W=1 kernel build warning(s): drivers/scsi/fcoe/fcoe_ctlr.c:139: warning: Function parameter or member 'mode' not described in 'fcoe_ctlr_init' drivers/scsi/fcoe/fcoe_ctlr.c:604: warning: Function parameter or member 'lport' not described in 'fcoe_ctlr_encaps' drivers/scsi/fcoe/fcoe_ctlr.c:1312: warning: Function parameter or member 'skb' not described in 'fcoe_ctlr_recv_clr_vlink' drivers/scsi/fcoe/fcoe_ctlr.c:1312: warning: Excess function parameter 'fh' description in 'fcoe_ctlr_recv_clr_vlink' drivers/scsi/fcoe/fcoe_ctlr.c:1781: warning: Function parameter or member 't' not described in 'fcoe_ctlr_timeout' drivers/scsi/fcoe/fcoe_ctlr.c:1781: warning: Excess function parameter 'arg' description in 'fcoe_ctlr_timeout' drivers/scsi/fcoe/fcoe_ctlr.c:1904: warning: Function parameter or member 'lport' not described in 'fcoe_ctlr_recv_flogi' drivers/scsi/fcoe/fcoe_ctlr.c:2166: warning: Function parameter or member 'lport' not described in 'fcoe_ctlr_disc_stop_locked' drivers/scsi/fcoe/fcoe_ctlr.c:2166: warning: Excess function parameter 'fip' description in 'fcoe_ctlr_disc_stop_locked' drivers/scsi/fcoe/fcoe_ctlr.c:2188: warning: Function parameter or member 'lport' not described in 'fcoe_ctlr_disc_stop' drivers/scsi/fcoe/fcoe_ctlr.c:2188: warning: Excess function parameter 'fip' description in 'fcoe_ctlr_disc_stop' drivers/scsi/fcoe/fcoe_ctlr.c:2204: warning: Function parameter or member 'lport' not described in 'fcoe_ctlr_disc_stop_final' drivers/scsi/fcoe/fcoe_ctlr.c:2204: warning: Excess function parameter 'fip' description in 'fcoe_ctlr_disc_stop_final' drivers/scsi/fcoe/fcoe_ctlr.c:2273: warning: Function parameter or member 'frport' not described in 'fcoe_ctlr_vn_parse' drivers/scsi/fcoe/fcoe_ctlr.c:2273: warning: Excess function parameter 'rdata' description in 'fcoe_ctlr_vn_parse' drivers/scsi/fcoe/fcoe_ctlr.c:2804: warning: Function parameter or member 'frport' not described in 'fcoe_ctlr_vlan_parse' drivers/scsi/fcoe/fcoe_ctlr.c:2804: warning: Excess function parameter 'rdata' description in 'fcoe_ctlr_vlan_parse' drivers/scsi/fcoe/fcoe_ctlr.c:2900: warning: Excess function parameter 'min_len' description in 'fcoe_ctlr_vlan_send' drivers/scsi/fcoe/fcoe_ctlr.c:2977: warning: Function parameter or member 'fip' not described in 'fcoe_ctlr_vlan_recv' drivers/scsi/fcoe/fcoe_ctlr.c:2977: warning: Function parameter or member 'skb' not described in 'fcoe_ctlr_vlan_recv' drivers/scsi/fcoe/fcoe_ctlr.c:2977: warning: Excess function parameter 'lport' description in 'fcoe_ctlr_vlan_recv' drivers/scsi/fcoe/fcoe_ctlr.c:2977: warning: Excess function parameter 'fp' description in 'fcoe_ctlr_vlan_recv' drivers/scsi/fcoe/fcoe_ctlr.c:3033: warning: Function parameter or member 'callback' not described in 'fcoe_ctlr_disc_start' drivers/scsi/fcoe/fcoe_ctlr.c:3033: warning: Function parameter or member 'lport' not described in 'fcoe_ctlr_disc_start' drivers/scsi/fcoe/fcoe_ctlr.c:3033: warning: Excess function parameter 'fip' description in 'fcoe_ctlr_disc_start' Cc: Hannes Reinecke Signed-off-by: Lee Jones --- drivers/scsi/fcoe/fcoe_ctlr.c | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/fcoe/fcoe_ctlr.c b/drivers/scsi/fcoe/fcoe_ctlr.c index 1791a393795da..99242f9856708 100644 --- a/drivers/scsi/fcoe/fcoe_ctlr.c +++ b/drivers/scsi/fcoe/fcoe_ctlr.c @@ -134,6 +134,7 @@ static void fcoe_ctlr_map_dest(struct fcoe_ctlr *fip) /** * fcoe_ctlr_init() - Initialize the FCoE Controller instance * @fip: The FCoE controller to initialize + * @mode: FIP mode to set */ void fcoe_ctlr_init(struct fcoe_ctlr *fip, enum fip_mode mode) { @@ -587,6 +588,7 @@ static void fcoe_ctlr_send_keep_alive(struct fcoe_ctlr *fip, /** * fcoe_ctlr_encaps() - Encapsulate an ELS frame for FIP, without sending it * @fip: The FCoE controller for the ELS frame + * @lport: The local port * @dtype: The FIP descriptor type for the frame * @skb: The FCoE ELS frame including FC header but no FCoE headers * @d_id: The destination port ID. @@ -1302,7 +1304,7 @@ static void fcoe_ctlr_recv_els(struct fcoe_ctlr *fip, struct sk_buff *skb) /** * fcoe_ctlr_recv_els() - Handle an incoming link reset frame * @fip: The FCoE controller that received the frame - * @fh: The received FIP header + * @skb: The received FIP packet * * There may be multiple VN_Port descriptors. * The overall length has already been checked. @@ -1775,7 +1777,7 @@ static void fcoe_ctlr_flogi_send(struct fcoe_ctlr *fip) /** * fcoe_ctlr_timeout() - FIP timeout handler - * @arg: The FCoE controller that timed out + * @t: Timer context use to obtain the controller reference */ static void fcoe_ctlr_timeout(struct timer_list *t) { @@ -1887,6 +1889,7 @@ static void fcoe_ctlr_recv_work(struct work_struct *recv_work) /** * fcoe_ctlr_recv_flogi() - Snoop pre-FIP receipt of FLOGI response * @fip: The FCoE controller + * @lport: The local port * @fp: The FC frame to snoop * * Snoop potential response to FLOGI or even incoming FLOGI. @@ -2158,7 +2161,7 @@ static struct fc_rport_operations fcoe_ctlr_vn_rport_ops = { /** * fcoe_ctlr_disc_stop_locked() - stop discovery in VN2VN mode - * @fip: The FCoE controller + * @lport: The local port * * Called with ctlr_mutex held. */ @@ -2179,7 +2182,7 @@ static void fcoe_ctlr_disc_stop_locked(struct fc_lport *lport) /** * fcoe_ctlr_disc_stop() - stop discovery in VN2VN mode - * @fip: The FCoE controller + * @lport: The local port * * Called through the local port template for discovery. * Called without the ctlr_mutex held. @@ -2195,7 +2198,7 @@ static void fcoe_ctlr_disc_stop(struct fc_lport *lport) /** * fcoe_ctlr_disc_stop_final() - stop discovery for shutdown in VN2VN mode - * @fip: The FCoE controller + * @lport: The local port * * Called through the local port template for discovery. * Called without the ctlr_mutex held. @@ -2262,7 +2265,7 @@ static void fcoe_ctlr_vn_start(struct fcoe_ctlr *fip) * fcoe_ctlr_vn_parse - parse probe request or response * @fip: The FCoE controller * @skb: incoming packet - * @rdata: buffer for resulting parsed VN entry plus fcoe_rport + * @frport: parsed FCoE rport from the probe request * * Returns non-zero error number on error. * Does not consume the packet. @@ -2793,7 +2796,7 @@ static int fcoe_ctlr_vn_recv(struct fcoe_ctlr *fip, struct sk_buff *skb) * fcoe_ctlr_vlan_parse - parse vlan discovery request or response * @fip: The FCoE controller * @skb: incoming packet - * @rdata: buffer for resulting parsed VLAN entry plus fcoe_rport + * @frport: parsed FCoE rport from the probe request * * Returns non-zero error number on error. * Does not consume the packet. @@ -2892,7 +2895,6 @@ static int fcoe_ctlr_vlan_parse(struct fcoe_ctlr *fip, * @fip: The FCoE controller * @sub: sub-opcode for vlan notification or vn2vn vlan notification * @dest: The destination Ethernet MAC address - * @min_len: minimum size of the Ethernet payload to be sent */ static void fcoe_ctlr_vlan_send(struct fcoe_ctlr *fip, enum fip_vlan_subcode sub, @@ -2969,9 +2971,8 @@ static void fcoe_ctlr_vlan_disc_reply(struct fcoe_ctlr *fip, /** * fcoe_ctlr_vlan_recv - vlan request receive handler for VN2VN mode. - * @lport: The local port - * @fp: The received frame - * + * @fip: The FCoE controller + * @skb: The received FIP packet */ static int fcoe_ctlr_vlan_recv(struct fcoe_ctlr *fip, struct sk_buff *skb) { @@ -3015,9 +3016,8 @@ static void fcoe_ctlr_disc_recv(struct fc_lport *lport, struct fc_frame *fp) fc_frame_free(fp); } -/** +/* * fcoe_ctlr_disc_recv - start discovery for VN2VN mode. - * @fip: The FCoE controller * * This sets a flag indicating that remote ports should be created * and started for the peers we discover. We use the disc_callback From patchwork Mon Jul 13 07:46:22 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235310 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2610654ilg; Mon, 13 Jul 2020 00:47:01 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwrDIZjLkqIFA+H2ujyF488NlrTXz1SGMa3wHfSBFxx9MveUqoiU1zHi3wBjiqSWudg/dAd X-Received: by 2002:a17:907:2108:: with SMTP id qn8mr67417939ejb.16.1594626421533; Mon, 13 Jul 2020 00:47:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626421; cv=none; d=google.com; s=arc-20160816; b=rJ3CewnRO7Oxt4e2x+6URNT913r+L9keni6JwB3gvWrANoJGQq2YcO7WxT5oo8KF6z A+nVECna6edbhru9/PZRV9VRotmsTB9vZCM5FYjNmXLdq/VcWgZajVIllvuYpcsb94uq uGQU8gFyLUizIfYvINbSKN6pzRUGSjIW1AXvhKrZxaEeTBARcJcLU5lH60XGoUNPUp1Q FTqSN3joupY2cBWsScCkrXMQJKkDfx9FcXf21HLZfYA5Pze4pHT7XFhwb2DRg/wO3m/K UTQI8efiiqmIHKcXkTvz3ObnS9IqXpBIBnA9P9GZkU2EDaTQyC21WUfzZ3CWIJMSXMVZ rLVA== 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=DmqYn8cL7eqDFwNGfmdwoQHTEQPwopRMh0yPN6WNGOc=; b=YSwueeNR5DavAMt5Jn1iBbIZHn2jX6acS0ncEchXqpZix3pyOJBVTcn1k4vePF0XcC TZtL8LOII4bpj3OHi3WSwo3lEMPZKTeyp2inOFX21rfzwp1mDwP2psf2fwHeeFcnWYsY qxh+gB3sIXo2UrTJSFi9RfQQssCghPa1M5HNpnRd94P8+4rWxlKEoZQHm19Z1ZxuD1M2 9lczG+ArmSiUK8Pr9cr5PnoAKoAIjUsQjYVyqEQyL+Bb8w+r0OU5EmypjaBDPjZfRRN4 BieOShDmPTuzA+2UqvwEOMKTSFHVjI6uy42smreWkactlXgOecfBhRK2Sid72XQxKPEo JSHA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=kMQi+LF4; 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 c14si8735868edr.41.2020.07.13.00.47.01 for ; Mon, 13 Jul 2020 00:47:01 -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=kMQi+LF4; 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 S1729139AbgGMHrA (ORCPT ); Mon, 13 Jul 2020 03:47:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50330 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729049AbgGMHqz (ORCPT ); Mon, 13 Jul 2020 03:46:55 -0400 Received: from mail-wm1-x341.google.com (mail-wm1-x341.google.com [IPv6:2a00:1450:4864:20::341]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4CBCBC08C5DD for ; Mon, 13 Jul 2020 00:46:55 -0700 (PDT) Received: by mail-wm1-x341.google.com with SMTP id f139so12170847wmf.5 for ; Mon, 13 Jul 2020 00:46:55 -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=DmqYn8cL7eqDFwNGfmdwoQHTEQPwopRMh0yPN6WNGOc=; b=kMQi+LF463/qxHEfKGPGvCd2c6A2f6xdj3zZKG62HaLhW8tV06HUqvCtmNufbjrIdu +r8xls+i2UHhzWACB73k0OoRRj72ou0OQ7r1zeWimj+ntzHg+CFP9fmpyJghgJkXjJw2 A05uGrWkzxgx82ApMTP8wqs03s9phPr++cD16/GYWchOzyqTxHwiRbqo1Ti/3YL4CJdL 1oI53ro3+ZySyLW27dLpxBvokNzD2PUv9mcRHuC9gs1CzeL3E0ICDp/IkeEJ97/ZAv46 hoZrC/IoAlccRJpK6OjveW//uzODgE0RYRvPXuTpnzfhNkdxuY/0noyO/8IWnS5hR8iF ZKAg== 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=DmqYn8cL7eqDFwNGfmdwoQHTEQPwopRMh0yPN6WNGOc=; b=b4HEdLH8cIX6VlWgyfQJ+QReVOJY+Dnm+9NBEv72+DqS04dAkJz7i3YJn1IM6iA0gg +S5mXFXCFrhDbFtjcvDXvSkP2lK87OinMDctrZjWd/LpB70tWrYLoj1nD+/FPn2efRGo uFOe+TdP1m3uZ+QWU7sFugJqZen+c7x7v652Ny6W4MTA1dcXJj6zZ9uXLqEaoGxHVmbh OiqbigmknMwwOA+Tb9V6q1pEI2UyxlFOnEarOa+YiqJ1blGvR3ZKRU78FoGKHnfQnECL qBTIJRTrx71CTwzcNFP/lfqNu4BujiEIcX5V6vsv487jDWyI2v5SHXiGoyxCPXnq57mH j2hA== X-Gm-Message-State: AOAM533/qMcyKU5grwlcEUoIKJ879MaaXmGeaUUq4Ss7Tqm5th4aEuLw VGMO7qIrDW+amlxsioCC5QCF3JPMm7E= X-Received: by 2002:a1c:a557:: with SMTP id o84mr17773676wme.42.1594626414066; Mon, 13 Jul 2020 00:46:54 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:53 -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 v2 06/29] scsi: fcoe: fcoe_transport: Correct some kernel-doc issues Date: Mon, 13 Jul 2020 08:46:22 +0100 Message-Id: <20200713074645.126138-7-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Mainly due to misdocumentation or bitrotted descriptions. Fixes the following W=1 kernel build warning(s): drivers/scsi/fcoe/fcoe_transport.c:396: warning: Function parameter or member 'skb' not described in 'fcoe_check_wait_queue' drivers/scsi/fcoe/fcoe_transport.c:447: warning: Function parameter or member 't' not described in 'fcoe_queue_timer' drivers/scsi/fcoe/fcoe_transport.c:447: warning: Excess function parameter 'lport' description in 'fcoe_queue_timer' drivers/scsi/fcoe/fcoe_transport.c:682: warning: Function parameter or member 'netdev' not described in 'fcoe_netdev_map_lookup' Cc: Hannes Reinecke Signed-off-by: Lee Jones --- drivers/scsi/fcoe/fcoe_transport.c | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/fcoe/fcoe_transport.c b/drivers/scsi/fcoe/fcoe_transport.c index a20ddc301c89e..6e187d0e71fd2 100644 --- a/drivers/scsi/fcoe/fcoe_transport.c +++ b/drivers/scsi/fcoe/fcoe_transport.c @@ -382,6 +382,7 @@ EXPORT_SYMBOL_GPL(fcoe_clean_pending_queue); /** * fcoe_check_wait_queue() - Attempt to clear the transmit backlog * @lport: The local port whose backlog is to be cleared + * @skb: The received FIP packet * * This empties the wait_queue, dequeues the head of the wait_queue queue * and calls fcoe_start_io() for each packet. If all skb have been @@ -439,7 +440,7 @@ EXPORT_SYMBOL_GPL(fcoe_check_wait_queue); /** * fcoe_queue_timer() - The fcoe queue timer - * @lport: The local port + * @t: Timer context use to obtain the FCoE port * * Calls fcoe_check_wait_queue on timeout */ @@ -672,6 +673,7 @@ static void fcoe_del_netdev_mapping(struct net_device *netdev) /** * fcoe_netdev_map_lookup - find the fcoe transport that matches the netdev on which * it was created + * @netdev: The net device that the FCoE interface is on * * Returns : ptr to the fcoe transport that supports this netdev or NULL * if not found. From patchwork Mon Jul 13 07:46:23 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235309 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2610644ilg; Mon, 13 Jul 2020 00:47:00 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyN8GKKv3Q8QUyQIU1ja3t0/bQipU7g53+f50N0YD1xM1IvKmtpGxXVxTefOaqJViTz1PBb X-Received: by 2002:a17:906:a0c8:: with SMTP id bh8mr75648289ejb.190.1594626420509; Mon, 13 Jul 2020 00:47:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626420; cv=none; d=google.com; s=arc-20160816; b=Bp0ESgmgme4BgmQKdsN/Cdy3IjfcaBQFWJPfjzM1doWlNitiXbvxt3nXwjbVsweAjE GCNot+pyXln68AHGZKCi/69hXcuIy0hJ9gN0YYTC0gZQVDmU7dACOHs0DTQrFsPaD+ay qhO7nj24f63JH8Ra8Jc3FNoSCH0zpPL0Q5olVwyzzqw/vbFBVGkJSt3q7T24FaopN9WB 6M703WbKZoNcnlzjiceGLhwXafvXbbmyWvCmKHV6w3z+Gzh3j6vJWnVi8NEvjxdMeBq7 Tk4eETdz4YR002S4U9SGLVEa9mrylgPxC0e8KynrkD9yBtH0Dr/6f9I+USureynIYqar DSYg== 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=46IKHC7Ib+3RpYilksHo0J0tVnpqASiueOx9DpvscBA=; b=Hgk1Qz6D7kH0X/lBRhWf9LC/h91zUz1vHpO3gqu52M9ve1J0V/olBcmso3Qttu6UQ9 NbvbU1vWcINPip6YkvHGDGbOCf2RS+Ortm9NJJ5BLt8XbeNNwZo86JbP8uVTKCKjRlff Lmeiq7KunJh775dAqvuRZfbu3viecrdHOvvwsyOo9tFcZQLSE++hOF/9uxCVvDN8/yVQ YxsgZ7peLOA16qmnZ9bm26vEatc+AJSZB0pivnWAEThI1WzdT8ql8x8ZUoHsJ5xQWvu+ F34h9JExyXDcKMdEWuiTYhEHoq5uWHWa4k4uXB/zw0ERowWNP8NaNKhj/BBR3YYsXwBs Pclg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="UT/KqFlQ"; 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 c14si8735868edr.41.2020.07.13.00.47.00 for ; Mon, 13 Jul 2020 00:47:00 -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="UT/KqFlQ"; 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 S1729127AbgGMHq7 (ORCPT ); Mon, 13 Jul 2020 03:46:59 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50340 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728968AbgGMHq5 (ORCPT ); Mon, 13 Jul 2020 03:46:57 -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 58927C08C5DF for ; Mon, 13 Jul 2020 00:46:56 -0700 (PDT) Received: by mail-wr1-x442.google.com with SMTP id q5so14681367wru.6 for ; Mon, 13 Jul 2020 00:46:56 -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=46IKHC7Ib+3RpYilksHo0J0tVnpqASiueOx9DpvscBA=; b=UT/KqFlQctUmY/pNcFBEOafFqDtMcA7/9vkx7Wqrs7RRk0llnbIkGAqXk9sEnMJ00g SMB9lfqGksTUMxUCcokmxIiS9cDznVvrBWKPA348XvPktO7L56fBxGIq+DANwobtrLSy DqgVKR9o6ivlPGAMkamBRupiWUk1D70rz0j2SQ0QkbvTq5kbPdY3gzyHnxUNPvELZ1Aw 6NNUuJpKjmf5QkST0ElUelDarLnSdsoh2y6ecJiozSvH7dDLLbQcL3WmwFOwOHlH3VRK rd0NN0DVlEAHLbBhwSErui5TBNN+k7jzscvFEEf+EZ/f+cNXYgbhqHtZZ+J1V6Lf8dE/ V7HQ== 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=46IKHC7Ib+3RpYilksHo0J0tVnpqASiueOx9DpvscBA=; b=WURlv2NcmbPpNVVT8MPKPY0+vbcBN991utIepDPplg6ZDmSM3bhTVw5N9DtqUxclkB dhVJl3K66KgWKs4NqkKyEYy/bNNYgKkiEuWJTLEi0L/8hofTSKVJqRBla41sBbHkC+Hw u6JNXl0BGLIHS7a/YoL2IZvc2v2kKrDPUVavjfWKN2CLWhomvBuCQVa/ZwTLioa7M8Yj K49WPRJSqbyq6+Wd9ISri7ba6LvZ8eqO2clQoSO13+K3oKSGn2Dg5TLmY7SyBO9iKOQE Uehkz5wIgc9brzXY8d9vtjLZjbELHzthmHf1+lYkpFB/PmiLQNbMMB9PVWCNyevYywz7 0P/Q== X-Gm-Message-State: AOAM532FOFUK6Z1bBUQo/KQkPVOddJtyY9pD2MEkuhAoJm5vgOOKVeNZ zVCybtzYL/SQzbcr9n2WrUPoHw== X-Received: by 2002:adf:f10a:: with SMTP id r10mr47129504wro.406.1594626415050; Mon, 13 Jul 2020 00:46:55 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:54 -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 , QLogic-Storage-Upstream@qlogic.com, Prakash Gollapudi Subject: [PATCH v2 07/29] scsi: bnx2fc: bnx2fc_fcoe: Repair a range of kerneldoc issues Date: Mon, 13 Jul 2020 08:46:23 +0100 Message-Id: <20200713074645.126138-8-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 >From bitrotted and missing function parameters to misuse of kerneldoc format. Fixes the following W=1 kernel build warning(s): drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1082: warning: Function parameter or member 'lport' not described in 'bnx2fc_update_src_mac' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1082: warning: Function parameter or member 'addr' not described in 'bnx2fc_update_src_mac' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1082: warning: Excess function parameter 'fip' description in 'bnx2fc_update_src_mac' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1082: warning: Excess function parameter 'old' description in 'bnx2fc_update_src_mac' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1082: warning: Excess function parameter 'new' description in 'bnx2fc_update_src_mac' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1670: warning: Function parameter or member 'netdev' not described in 'bnx2fc_destroy' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1670: warning: Excess function parameter 'buffer' description in 'bnx2fc_destroy' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:1670: warning: Excess function parameter 'kp' description in 'bnx2fc_destroy' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:2108: warning: Function parameter or member 'netdev' not described in 'bnx2fc_disable' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:2236: warning: Function parameter or member 'netdev' not described in 'bnx2fc_enable' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:2529: warning: Function parameter or member 'dev' not described in 'bnx2fc_ulp_exit' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:2962: warning: cannot understand function prototype: 'struct scsi_host_template bnx2fc_shost_template = ' drivers/scsi/bnx2fc/bnx2fc_fcoe.c:2996: warning: cannot understand function prototype: 'struct cnic_ulp_ops bnx2fc_cnic_cb = ' Cc: QLogic-Storage-Upstream@qlogic.com Cc: Prakash Gollapudi Signed-off-by: Lee Jones --- drivers/scsi/bnx2fc/bnx2fc_fcoe.c | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/bnx2fc/bnx2fc_fcoe.c b/drivers/scsi/bnx2fc/bnx2fc_fcoe.c index 0e33324e16f51..5cdeeb3539fdc 100644 --- a/drivers/scsi/bnx2fc/bnx2fc_fcoe.c +++ b/drivers/scsi/bnx2fc/bnx2fc_fcoe.c @@ -1071,9 +1071,8 @@ static int bnx2fc_fip_recv(struct sk_buff *skb, struct net_device *dev, /** * bnx2fc_update_src_mac - Update Ethernet MAC filters. * - * @fip: FCoE controller. - * @old: Unicast MAC address to delete if the MAC is non-zero. - * @new: Unicast MAC address to add. + * @lport: The local port + * @addr: Location of data to copy * * Remove any previously-set unicast MAC filter. * Add secondary FCoE MAC address filter for our OUI. @@ -1659,8 +1658,7 @@ static void __bnx2fc_destroy(struct bnx2fc_interface *interface) /** * bnx2fc_destroy - Destroy a bnx2fc FCoE interface * - * @buffer: The name of the Ethernet interface to be destroyed - * @kp: The associated kernel parameter + * @netdev: The net device that the FCoE interface is on * * Called from sysfs. * @@ -2101,7 +2099,7 @@ static int __bnx2fc_disable(struct fcoe_ctlr *ctlr) return 0; } -/** +/* * Deperecated: Use bnx2fc_enabled() */ static int bnx2fc_disable(struct net_device *netdev) @@ -2229,7 +2227,7 @@ static int __bnx2fc_enable(struct fcoe_ctlr *ctlr) return 0; } -/** +/* * Deprecated: Use bnx2fc_enabled() */ static int bnx2fc_enable(struct net_device *netdev) @@ -2523,7 +2521,7 @@ static struct bnx2fc_hba *bnx2fc_hba_lookup(struct net_device /** * bnx2fc_ulp_exit - shuts down adapter instance and frees all resources * - * @dev cnic device handle + * @dev: cnic device handle */ static void bnx2fc_ulp_exit(struct cnic_dev *dev) { @@ -2956,7 +2954,7 @@ static struct device_attribute *bnx2fc_host_attrs[] = { NULL, }; -/** +/* * scsi_host_template structure used while registering with SCSI-ml */ static struct scsi_host_template bnx2fc_shost_template = { @@ -2989,7 +2987,7 @@ static struct libfc_function_template bnx2fc_libfc_fcn_templ = { .rport_event_callback = bnx2fc_rport_event_handler, }; -/** +/* * bnx2fc_cnic_cb - global template of bnx2fc - cnic driver interface * structure carrying callback function pointers */ From patchwork Mon Jul 13 07:46:24 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235308 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2610638ilg; Mon, 13 Jul 2020 00:46:59 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz9Z1U5HAnp4FlRatmi7L21ORIE66VOB3pvp/UBPs042Qa8lAT9dDChHUAXzWrXQktzLFgI X-Received: by 2002:a50:d6dd:: with SMTP id l29mr90929755edj.345.1594626419813; Mon, 13 Jul 2020 00:46:59 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626419; cv=none; d=google.com; s=arc-20160816; b=F/moMSl8rAfBS96nhgFq/1UlWChEbxCtyIyFL/4BbIAfvSBYuZG8dui0acVA6/4tZX uKnzFfFUp56LWzAcyEDKg5mMJZL6kJ3wYl73NUaF9uqEz/qGSjJKFL2tdW4+LhLFujRU lcg+UBUlWLjWZ0sVE5y6El3//Z+d6PK3nzWeahCbc2mLn3j8odlGKTV73AFahyyWhZ75 UmcWB/vsQ04o8xGV3EqnnRNuOAsMhqwbVLXl0b17b9xeMBzMSJVvwCB+aBou9ei4q9lV iDV/sj+5pRnLmbOoheC30NBlkqGnVXdhwu3vI9PDqcgKua+DCvOJkdqoQkjL/50PHfRP X+xg== 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=CbDIhrckRx3GTebLwLuoUtbus6UaS40hQs+7mAaRUqY=; b=q9ZUvpv6E/mIg/T7ONzT456QbJ/0y3m4Ll4Y5eY0Cr4LXQ+Nab7ZY0xUGPazF1eYLV bdo13bwRuYqQHwyvaMAvRryrInCwA5eLipSf7igAEwwjghY1+BRLqXWlmVXGrchtdBpd Y/LPZS7+JhrVmFCF5vfIvRE7M7v+T5JOlHalknp6RILe6tRL/RhkLh5kfrVKHIZIZ87K lTFiqhGEySB9ShswrU/3rl0GH60G1wsLYVPCBy8mlilFAqfuxE5nJA2wZ8/Dn4UI01sZ BdZqVJKRDBNzkw2OJtW8GA7UwnZqtWP5JFncL7K89Z05nBHXS2iZIFjYjhzgj3NVX6WU XIbQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Dgdv43SM; 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 c14si8735868edr.41.2020.07.13.00.46.59 for ; Mon, 13 Jul 2020 00:46:59 -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=Dgdv43SM; 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 S1729107AbgGMHq6 (ORCPT ); Mon, 13 Jul 2020 03:46:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50342 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729085AbgGMHq5 (ORCPT ); Mon, 13 Jul 2020 03:46:57 -0400 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 7768AC061755 for ; Mon, 13 Jul 2020 00:46:57 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id a6so14659796wrm.4 for ; Mon, 13 Jul 2020 00:46:57 -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=CbDIhrckRx3GTebLwLuoUtbus6UaS40hQs+7mAaRUqY=; b=Dgdv43SMguTbFfpAEBrGAMFtotvNXSMP4bcEVucw8MOl/jsg7uMMgAe8AQXfW3dk2j Mf2ROLifHH1Vr3gSBOFKsCZ25nrUuOMaIBLZyItBlBHNZ7hC3RCd7ue5F+kjuCvW+PGD tSlROBZdMCQIL8T3OY3Is5S0gX7ZyuEXZI1uCCoygGC4g/7sG7lNkkRbba7uDZuudODp sTWYN4RJr/u+Mjd41GbT52bHNLEi8SlaiuWkLnpbB2/X9mufq8Gi5mjY1ryxPjCdqNe2 ngHRRdC73MUn5Q6BpVu/Dsbk+ICGMc+aJVOYQjydWVsOzdBHdM3gIdBqz3mwFbevoVDz ts6w== 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=CbDIhrckRx3GTebLwLuoUtbus6UaS40hQs+7mAaRUqY=; b=MGB+Pi030sLWbBmP4JS0ahT3/PIDWDx9OHAhxyqb3ZjWkKCwEqMhz0IOwYDReP7+mq RhntzAjbeAVWoVEbQDDmdXxbno8VxNy3WfOyxgb5THo/SyGNejtjEXx8cikT5+zPuHWU xkOzupJ6HQ0JPvJxlyoKxq+PpRuPWqn2wfgHOvfX5V8t3rACERC+6xUEiAgD+PNZM4d0 cToTasjrIRtWvN+wbQDVHOO6wuLVU3YoWTKoFPP6OCX8vExHNSpYxBJNYftc1NbZohP/ z2+Jt5W/6paxgLIbG4Fvzym0QtfdGQdaKSP1BzpgF2RqHiDBVezdFOLKPPz90j3KsXUM ejKQ== X-Gm-Message-State: AOAM531CTo4ZM/y8dLNQTWC4bPScSReo+PrmqDnmh//iadGaewSskS2t z5nzfLaRB0HOVLpXEvBCmaGtUQ== X-Received: by 2002:a5d:658a:: with SMTP id q10mr78336227wru.220.1594626416215; Mon, 13 Jul 2020 00:46:56 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:55 -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 , QLogic-Storage-Upstream@cavium.com Subject: [PATCH v2 08/29] scsi: qedf: qedf_main: Demote obvious misuse of kerneldoc to standard comment blocks Date: Mon, 13 Jul 2020 08:46:24 +0100 Message-Id: <20200713074645.126138-9-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 No attempt has been made to document either of the demoted functions here. Fixes the following W=1 kernel build warning(s): drivers/scsi/qedf/qedf_main.c:1027: warning: Function parameter or member 'lport' not described in 'qedf_xmit' drivers/scsi/qedf/qedf_main.c:1027: warning: Function parameter or member 'fp' not described in 'qedf_xmit' drivers/scsi/qedf/qedf_main.c:1426: warning: Function parameter or member 'lport' not described in 'qedf_rport_event_handler' drivers/scsi/qedf/qedf_main.c:1426: warning: Function parameter or member 'rdata' not described in 'qedf_rport_event_handler' drivers/scsi/qedf/qedf_main.c:1426: warning: Function parameter or member 'event' not described in 'qedf_rport_event_handler' Cc: QLogic-Storage-Upstream@cavium.com Signed-off-by: Lee Jones --- drivers/scsi/qedf/qedf_main.c | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/qedf/qedf_main.c b/drivers/scsi/qedf/qedf_main.c index 36b1ca2dadbb5..a77a74fad6a7e 100644 --- a/drivers/scsi/qedf/qedf_main.c +++ b/drivers/scsi/qedf/qedf_main.c @@ -1019,9 +1019,8 @@ static int qedf_xmit_l2_frame(struct qedf_rport *fcport, struct fc_frame *fp) return rc; } -/** +/* * qedf_xmit - qedf FCoE frame transmit function - * */ static int qedf_xmit(struct fc_lport *lport, struct fc_frame *fp) { @@ -1415,7 +1414,7 @@ static void qedf_cleanup_fcport(struct qedf_ctx *qedf, kref_put(&rdata->kref, fc_rport_destroy); } -/** +/* * This event_callback is called after successful completion of libfc * initiated target login. qedf can proceed with initiating the session * establishment. From patchwork Mon Jul 13 07:46:25 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235330 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611527ilg; Mon, 13 Jul 2020 00:48:38 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxgRrH+4ptq66s1v6wR/O/9l2OP8wuVJSXKnjH0tyS8KbBUkrBrNRWUZzxXJ2nrTqO6/Bl8 X-Received: by 2002:a17:906:4d4c:: with SMTP id b12mr70878811ejv.506.1594626518577; Mon, 13 Jul 2020 00:48:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626518; cv=none; d=google.com; s=arc-20160816; b=ye2AIvF37n05G9bl0cNuHX+QvQ9dmOOw7t81yZON30wX4v9OvyyTcmrjSJqHPQYkaL Un/3SUAEvcDLMmCKHFmexAUMP+b0UEYfCfHs3QJDm+FSnRCzhHAg4lnNnaRwhUjh5XaN mjyKH1uMEx1xk0pY6l/O4UetnfdHkcm1t54Sk5n+HdEoFXaR4sL7yuYrNqlgWnzOcoEa FFDPBIf4HsrUSjvVfOBZlB2eC4NeMqsyzDl3k5pM7YtBwIQ+QRPmat9/IoWVn7dbcFiX aA2Adz19fxoJRpWSehjW207W0rD6qPx5KgZZJu4NFQ5jISTipDk3aN770G1setDr+cPX Qblg== 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=8R5JqiLjYcza4fbV6goyYqcdxR7v8Q2JkVSQFyfGqhI=; b=BNv9agTRcAOnpiCyfu1QazZP8AeojynHZL/hkWzPUSlXi6/PAqULDd64UGLaU3Eksi X/Q/Lfg23vLvl9Gr5UiA1IASG7WL8yBW4ufBfh9FZmuJdn7x0g9SWYXPt17vZIjOcQxv IRjQh+/Wj+pvcFxA6E6v9Nb2JQOCF8k0IwdAY0PzJ1uB6ehv+pYuL1vdcQKYxjFbjCgM /K7qrWhRqSu2m5K2URl6J2Z/nxqXz/YG6t9twcsC6lmMgaHH7yBMiSdZ2Z+LR7ye09Z+ vKRV545MThmSwl7blyLqsW+D7yC8ohsefWMO46ZS5NO8zROUNiSFXEvAKWuDkfxfwbnn bPxA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=udRqTFtV; 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 bt23si8303152edb.545.2020.07.13.00.48.38 for ; Mon, 13 Jul 2020 00:48:38 -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=udRqTFtV; 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 S1729155AbgGMHrB (ORCPT ); Mon, 13 Jul 2020 03:47:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50348 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729115AbgGMHq7 (ORCPT ); Mon, 13 Jul 2020 03:46:59 -0400 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 9E91AC061794 for ; Mon, 13 Jul 2020 00:46:58 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id f7so14681547wrw.1 for ; Mon, 13 Jul 2020 00:46:58 -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=8R5JqiLjYcza4fbV6goyYqcdxR7v8Q2JkVSQFyfGqhI=; b=udRqTFtVMJHrG8FeYyUiq433O2fFQWC945bPEuJp10f4RrlpzSBC3G1uT3JrWYA1z+ KkuTTQHCBdHe1LYCAy/Iu3gl9yKuqzR0//GRW+h8lH+KZWAZK605JeIx5pB2kAKHOSXI V335Wh3pK7UbDMZzCDpcb1FmsQkI8K+4bAYGhygGqjF9tBjGZSaj7UJQVmYRRKniBfXr SCBIkyICY6k35WAoLl9qqCFZJfpliOIQY1ByScnoV6kBjLvUTTfL9aJVq/QlI5KXWYzP VMQdVskZjbYEcfJ7cJY+OgjrxcgZjB6XG39HbAY8rYrFvKZnFv+LkC0PtP30tOSv65uW AZqg== 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=8R5JqiLjYcza4fbV6goyYqcdxR7v8Q2JkVSQFyfGqhI=; b=PpZq4lRDyzHjvrQeJOZ4qyHwpb6InMpr8mTh+HUHGKWWgSOAOWNiUdcy56eXCNLy6D 8sCfehgjiwMmNjGxhkU2y1VxzmYpaRW6VsbblBGNHh1S7rrR/mXjh32SzS6yDQsxs953 Xzz90DVcJz9UUcWgGarPJjQ20BvW/tyc0Xz0WHTWyxtWQ8ygZXaBQSQW6L9ZtWQimllf qbWAMCqaBvh2IxQOANKecZSDq96ua2Wn0mma2XqVvJdsoY0bukiIXtyPaI6aeSuHi3d6 UOggFl62Wcdv3k9kjCjfUsyQ2JsRVpVzQrOIvJk1dVKanvA206XeVjMVGrAcxK5pTI3R E3vQ== X-Gm-Message-State: AOAM532W4LRghZ2637WujTOTBOPpb88FLZviXZZ9KolBminA3cEQAGtS HIyheMSGtC92x8Hwu2R7e1FcR8jbRYk= X-Received: by 2002:a5d:664e:: with SMTP id f14mr78870952wrw.6.1594626417338; Mon, 13 Jul 2020 00:46:57 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:56 -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 , QLogic-Storage-Upstream@cavium.com Subject: [PATCH v2 09/29] scsi: qedf: qedf_main: Remove set but not checked variable 'tmp' Date: Mon, 13 Jul 2020 08:46:25 +0100 Message-Id: <20200713074645.126138-10-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Looks like the return value of readw() has never been checked. Fixes the following W=1 kernel build warning(s): drivers/scsi/qedf/qedf_main.c: In function ‘__qedf_probe’: drivers/scsi/qedf/qedf_main.c:3203:6: warning: variable ‘tmp’ set but not used [-Wunused-but-set-variable] Cc: QLogic-Storage-Upstream@cavium.com Signed-off-by: Lee Jones --- drivers/scsi/qedf/qedf_main.c | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/qedf/qedf_main.c b/drivers/scsi/qedf/qedf_main.c index a77a74fad6a7e..47fc14f5ed9d7 100644 --- a/drivers/scsi/qedf/qedf_main.c +++ b/drivers/scsi/qedf/qedf_main.c @@ -3199,7 +3199,6 @@ static int __qedf_probe(struct pci_dev *pdev, int mode) void *task_start, *task_end; struct qed_slowpath_params slowpath_params; struct qed_probe_params qed_params; - u16 tmp; /* * When doing error recovery we didn't reap the lport so don't try @@ -3393,9 +3392,9 @@ static int __qedf_probe(struct pci_dev *pdev, int mode) "Writing %d to primary and secondary BDQ doorbell registers.\n", qedf->bdq_prod_idx); writew(qedf->bdq_prod_idx, qedf->bdq_primary_prod); - tmp = readw(qedf->bdq_primary_prod); + readw(qedf->bdq_primary_prod); writew(qedf->bdq_prod_idx, qedf->bdq_secondary_prod); - tmp = readw(qedf->bdq_secondary_prod); + readw(qedf->bdq_secondary_prod); qed_ops->common->set_power_state(qedf->cdev, PCI_D0); From patchwork Mon Jul 13 07:46:26 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235328 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611505ilg; Mon, 13 Jul 2020 00:48:36 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwXdR2bZTzXm4CJ47Mb0PEYayk04RjeW8ezT6Dp3eeg97L8x5RG7jYUiHMQUaRbP8ovb7KU X-Received: by 2002:a05:6402:2064:: with SMTP id bd4mr87670737edb.180.1594626516061; Mon, 13 Jul 2020 00:48:36 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626516; cv=none; d=google.com; s=arc-20160816; b=oUHuYiQbaMe5P8YMOywe9uihvQM+W2KG8ziWMwytcAB7cFi1np8XzNBsRWiXMiguJ3 Nelzs5x35IJCgFhPhNcGmtdsQKkN4d/xsftUIPfbxCt5IKw5QOYBlmr2IsIs3vFtO6/W l0ZD9YiiE/W0yE1gAwiJREQwo1YWuZiypzFBBxTXl7d8+0j+mM4SjIK7KvTZ89Bsa5I8 VrpEGYqfRGpO7rFxkq7B60KgildG8Z3NgQPTDEF2F24fY+GLhFcgfZdXaRGZnZTEMq0/ +vVK0wtUDMqN+eef8+tb5BesvAZt3YVz9T+xmLZ3QQe1MLzYE9UisydBZ8iODzeVH5lO ATUw== 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=Uxo2DH0sWgHFikhlDzsPIQecz45jNH2LIUT7ZFPJRdc=; b=uRWQSXz9BHTq+Gwr2Ve9t5m7VL9P2P6TW0w+jVSzEB8wlydxpYGeQOJDSAhV2f8Jry W+xq4HsMRa6xRtmleqyxVisOVXyxV+k1p0xtb14Se172AVjH1gzE0nsJgUriwkMSNhW7 GVB9vt8cCmpQsyeHwdLY6qexEuNL98OsR+GiLRtl9Vc/9TbBVDK+EhPve9cv7TA9i5JG nHV2lXRHZj2VhlUtKy7KX/RxL5SX+fbOw/jW33j3NbHUrMhVnQI476rU12Qey5dIDMqM iSiXmvBVQeRXyNLsSb2rkVf6B4uXo0skzfxUwHtQAQZhTPI/2gHn0O9CMMw/D299XbWR LWKQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=GOrvNZyG; 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 bt23si8303152edb.545.2020.07.13.00.48.35 for ; Mon, 13 Jul 2020 00:48:36 -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=GOrvNZyG; 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 S1725969AbgGMHrC (ORCPT ); Mon, 13 Jul 2020 03:47:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50354 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729130AbgGMHrA (ORCPT ); Mon, 13 Jul 2020 03:47:00 -0400 Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A50D1C061755 for ; Mon, 13 Jul 2020 00:46:59 -0700 (PDT) Received: by mail-wr1-x443.google.com with SMTP id f2so14621292wrp.7 for ; Mon, 13 Jul 2020 00:46:59 -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=Uxo2DH0sWgHFikhlDzsPIQecz45jNH2LIUT7ZFPJRdc=; b=GOrvNZyGD/PoyYcKlVxeUmDl6NKujK+VozGRKnT3zzrkL/K+gDrsH3ctdT5eT7xjON CI8WLL8IO54NfYHE3fA1PKqWCzxHUOPO0kEoBGt8xKczCtNVVVQWmakkIWJoHWG/RI81 AzEj8CAToo56PyuMUBzcNY4aBlYAOHp8uetE7mrx0DR4P1ITJB0buL05HPW9DzzNCXeR M4icB1yrctRI8HC+zYv+RejU7jRJOCWso8hGU7uORogO5uHkiqcV8JwXa9ZJWYvzIZtC ZxgXj5QEtmpzu94HC2QYmQzKef5UbIVr9AIRZfNorDYl7Vb0AcO+sfwYwZdrBaUmUXzT BxDQ== 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=Uxo2DH0sWgHFikhlDzsPIQecz45jNH2LIUT7ZFPJRdc=; b=Zc7T8tIHGxBDqiO5JnIGP7K9pb7jSE4GhklPa3RrIKcquckXXuBRfaZhT6LxcyhRHw 7eUUSC+PgHkNtVPk5AzrgZR51F4INhvc3C9TOOb+/oKb5SpSfnpQOKxYM9014QH7oP4R 6ApW74NfIvKG903PrBZVETSz/v7azc+0XO6HxT4CkLw1xl0x+MB1zqsBCZbEiN+YARXd Mxh/1I3VRtHSTXUD+VfQxJhPdTud7EO6ne5LFgzuSvU77u4rUkILi5cGvJ3+26ykMba8 dNpWWc+9Vt9Hyzljq1Rx8T7/7G4M07K+zIP0lUMUDE+f4Msi9qz9i6FjFZtSRiwUdERW Qvhw== X-Gm-Message-State: AOAM530k51yUJXpe4xUkQkZbQ8YckJ6+q4WSt8/ofRVFPzq6lTq7A1d4 0WIRTLp3XF/eICcrVxy7H8zwEA== X-Received: by 2002:adf:f20a:: with SMTP id p10mr83082724wro.41.1594626418436; Mon, 13 Jul 2020 00:46:58 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:57 -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 v2 10/29] scsi: libfc: fc_lport: Repair function parameter documentation Date: Mon, 13 Jul 2020 08:46:26 +0100 Message-Id: <20200713074645.126138-11-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Either misdocumentation and/or bitrot. Fixes the following W=1 kernel build warning(s): drivers/scsi/libfc/fc_lport.c:412: warning: Function parameter or member 'in_fp' not described in 'fc_lport_recv_echo_req' drivers/scsi/libfc/fc_lport.c:412: warning: Excess function parameter 'fp' description in 'fc_lport_recv_echo_req' drivers/scsi/libfc/fc_lport.c:447: warning: Function parameter or member 'in_fp' not described in 'fc_lport_recv_rnid_req' drivers/scsi/libfc/fc_lport.c:447: warning: Excess function parameter 'fp' description in 'fc_lport_recv_rnid_req' drivers/scsi/libfc/fc_lport.c:1330: warning: Function parameter or member 'state' not described in 'fc_lport_enter_ns' drivers/scsi/libfc/fc_lport.c:1428: warning: Function parameter or member 'state' not described in 'fc_lport_enter_ms' drivers/scsi/libfc/fc_lport.c:1939: warning: Function parameter or member 'tov' not described in 'fc_lport_els_request' Cc: Hannes Reinecke Signed-off-by: Lee Jones --- drivers/scsi/libfc/fc_lport.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/libfc/fc_lport.c b/drivers/scsi/libfc/fc_lport.c index 684c5e361a286..b84dbc316df15 100644 --- a/drivers/scsi/libfc/fc_lport.c +++ b/drivers/scsi/libfc/fc_lport.c @@ -405,7 +405,7 @@ static void fc_lport_recv_rlir_req(struct fc_lport *lport, struct fc_frame *fp) /** * fc_lport_recv_echo_req() - Handle received ECHO request * @lport: The local port receiving the ECHO - * @fp: ECHO request frame + * @in_fp: ECHO request frame */ static void fc_lport_recv_echo_req(struct fc_lport *lport, struct fc_frame *in_fp) @@ -440,7 +440,7 @@ static void fc_lport_recv_echo_req(struct fc_lport *lport, /** * fc_lport_recv_rnid_req() - Handle received Request Node ID data request * @lport: The local port receiving the RNID - * @fp: The RNID request frame + * @in_fp: The RNID request frame */ static void fc_lport_recv_rnid_req(struct fc_lport *lport, struct fc_frame *in_fp) @@ -1325,6 +1325,7 @@ static void fc_lport_enter_scr(struct fc_lport *lport) /** * fc_lport_enter_ns() - register some object with the name server * @lport: Fibre Channel local port to register + * @state: Local port state */ static void fc_lport_enter_ns(struct fc_lport *lport, enum fc_lport_state state) { @@ -1423,6 +1424,7 @@ static void fc_lport_enter_dns(struct fc_lport *lport) /** * fc_lport_enter_ms() - management server commands * @lport: Fibre Channel local port to register + * @state: Local port state */ static void fc_lport_enter_ms(struct fc_lport *lport, enum fc_lport_state state) { @@ -1932,6 +1934,7 @@ static void fc_lport_bsg_resp(struct fc_seq *sp, struct fc_frame *fp, * @job: The BSG Passthrough job * @lport: The local port sending the request * @did: The destination port id + * @tov: The timeout period (in ms) */ static int fc_lport_els_request(struct bsg_job *job, struct fc_lport *lport, From patchwork Mon Jul 13 07:46:27 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235332 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611539ilg; Mon, 13 Jul 2020 00:48:40 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzuE+rwLvBr+IU4MCMJpv5qulYJFAqK3cBBnqAfVkkvxT6Vos+zbMesDyka2+oZYRZ/N1++ X-Received: by 2002:aa7:d458:: with SMTP id q24mr36572424edr.25.1594626519905; Mon, 13 Jul 2020 00:48:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626519; cv=none; d=google.com; s=arc-20160816; b=07uEOSCli9FfqdPuePsuNrUis6o9fAewGrcvBdcI7mBYxEKNH9bOUpiPc0iZYYtdxR jJECdolHmhPSZlHVZolDaY+qtMMo+4+vxdN4R+5WXMsx3+KjXlYArd9LtSqmwWvWj/nz 4DmVdMQ8mffIt32SH2we9sRRCGRrM2+Vq0CUIkl+2a3YeiL2wgZiiAnXuwbISWaTrTqK mTWFWtHVtuTnykq5+d7/665tBF5/bmOU9mZ7fe4A+LsVHM8leJQ5PucdQYB8V5Fxhi4a wzCS7TXLDXTPHNaiBhg+VF6dNWBIdKEDXoK0wZATghircYWffmxeiuCrnl9HEUkT4Cow ECcw== 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=4xycoRjRF0CV8HBHzFk7ghiKnd/ULnjTxGfEHVQaX5o=; b=cv4r+FaMjZSntf6PgUksJvB8ifHy5WKtFo4bWVF/6g2sYyWsuP24UNQSgVLSFjhtfd L0+a53VZqZbEGzj2E84KeCklHVd1W8UC5P2uGgKJUp3943jgAr6umu17rfDxdEX9fvxG TU4mr0jRWvo8FuVftW5dTXNi6cOvOXk4Bb9lNSAM/55bcuY/bjCcPmmN4MrGc18rJ7Mj w0WdazYX4OdjRtUqIbzAK/JycrGBCmfwZ9lKW7nLEZMUUqhgw0uwdAyMNs2SlJmXdNaH VtzTzkwBVaAs5TNvodR9vvw1D0tOEqfSZgN62OYRABOay9JuXdgm/CHzSyKvf1lxUaNh oFTg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=HXt1mOIj; 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 bt23si8303152edb.545.2020.07.13.00.48.39 for ; Mon, 13 Jul 2020 00:48:39 -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=HXt1mOIj; 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 S1729606AbgGMHsi (ORCPT ); Mon, 13 Jul 2020 03:48:38 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50362 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729149AbgGMHrB (ORCPT ); Mon, 13 Jul 2020 03:47:01 -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 8C83CC08C5DD for ; Mon, 13 Jul 2020 00:47:00 -0700 (PDT) Received: by mail-wr1-x442.google.com with SMTP id f7so14681742wrw.1 for ; Mon, 13 Jul 2020 00:47:00 -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=4xycoRjRF0CV8HBHzFk7ghiKnd/ULnjTxGfEHVQaX5o=; b=HXt1mOIjwGBzI6I/6a+Fct/YpIy3RLHUBFMeuwcxoNNOnaaKj/+phRNTr0aubBAXjp 3fBSMZehlJV33UdN+RCRw3no7wzd/9jrPxa50QQWYbDW8mTl1FgEObVrt8li3yTo3yZ0 7Og5PAVWB3x/mRnGUbtC01iSAHA8s9tcTya/R9u0+NWaarKJiXw1RxTAlfQga501Aggf 9eMG2L6kca8UoxkQuD/pRKkT0eYZVw1wEyG3Rj4i2ErNNlYqeXx6Z5iCBlTr1XEiInxd w6vth0Vu+E8PFcHv32IRjxcZvYCC6bGsglMG1hxGfhyAAMQS8tTP/Np2O1f7pLxqYbNL xk8w== 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=4xycoRjRF0CV8HBHzFk7ghiKnd/ULnjTxGfEHVQaX5o=; b=b3aRoH6SoIBxzvmHLuqXVEA1XnBJWp04QYYvU9biLFdumFulPUJ4iwHJT6AZz6M8pY JGyvohXVUdrcJhXQ8zSqK1eiA+Ygpty3yBO53dgaH1bKFQYz9GA6lWohS0eiL4RdjiLi z0wDxziSRX6p0+9Jc50MNcM6SisLQr/5KH1/cetVZIE1ooBXhAUk8vYQNUrgtaduICmw 2cpUJrQyBDhLadtZUVLbl06wdcMrKfczZ2iG8t6Ne6FCK1v3OlvTtKCs2/5dCQsScThL WjOIJWPsT+lqbA0LKPQjqV3MEPspTXIP0kdg/L2C8AA0HLsArbQz4+GwjN0Y02LStX+x 3Umg== X-Gm-Message-State: AOAM530Q61v18BMsof4Gc/9WmKSMX0Nxyho2ZRPWKGYvnpn63nrkDOAh 4ONoTtH0CJAMFXR1zeSOKPCqAA== X-Received: by 2002:a5d:634e:: with SMTP id b14mr83653473wrw.423.1594626419345; Mon, 13 Jul 2020 00:46:59 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:46:58 -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 v2 11/29] scsi: libfc: fc_rport: Fix a couple of misdocumented function parameters Date: Mon, 13 Jul 2020 08:46:27 +0100 Message-Id: <20200713074645.126138-12-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Fixes the following W=1 kernel build warning(s): drivers/scsi/libfc/fc_rport.c:129: warning: Function parameter or member 'port_id' not described in 'fc_rport_create' drivers/scsi/libfc/fc_rport.c:129: warning: Excess function parameter 'ids' description in 'fc_rport_create' drivers/scsi/libfc/fc_rport.c:1452: warning: Function parameter or member 'rdata_arg' not described in 'fc_rport_logo_resp' drivers/scsi/libfc/fc_rport.c:1452: warning: Excess function parameter 'lport_arg' description in 'fc_rport_logo_resp' Cc: Hannes Reinecke Signed-off-by: Lee Jones --- drivers/scsi/libfc/fc_rport.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/libfc/fc_rport.c b/drivers/scsi/libfc/fc_rport.c index 278d15ff1c5ae..18663a82865f9 100644 --- a/drivers/scsi/libfc/fc_rport.c +++ b/drivers/scsi/libfc/fc_rport.c @@ -121,7 +121,7 @@ EXPORT_SYMBOL(fc_rport_lookup); /** * fc_rport_create() - Create a new remote port * @lport: The local port this remote port will be associated with - * @ids: The identifiers for the new remote port + * @port_id: The identifiers for the new remote port * * The remote port will start in the INIT state. */ @@ -1445,7 +1445,7 @@ static void fc_rport_recv_rtv_req(struct fc_rport_priv *rdata, * fc_rport_logo_resp() - Handler for logout (LOGO) responses * @sp: The sequence the LOGO was on * @fp: The LOGO response frame - * @lport_arg: The local port + * @rdata_arg: The remote port */ static void fc_rport_logo_resp(struct fc_seq *sp, struct fc_frame *fp, void *rdata_arg) From patchwork Mon Jul 13 07:46:28 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235329 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611517ilg; Mon, 13 Jul 2020 00:48:37 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwC2JQQCXUVSHZ9scLbYu0dNXXjXoIUyRizdrCWM1FNDpoyku+gJ/r3Fy+xhdQOn+5b+DK2 X-Received: by 2002:a17:906:455:: with SMTP id e21mr75300597eja.550.1594626517151; Mon, 13 Jul 2020 00:48:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626517; cv=none; d=google.com; s=arc-20160816; b=zLvA/kx36L9bg3BYKsmaEy5HsJXVqisAxZssDrNVFxjRN2o23Yh3LdLsOepyp1WaTd Fdbsz4CJzoZ6M/ZfQP1QVR9tJ5u5rgd1+3cVl6gbOnzosiE2ogpSah+iaVC27dtnHKBc KGG55w+KGZqKQ8dLYEkiGJcq2riMKMBuIkDisJ6geRjhUNp68sRv+XEM5LTgZzkv95XN V563INtvO1700CFly7luIYLZLgrYHpajN2BLIoZIP7qiuOpoWw1icyqpUBdBEs7dOu/4 EOOcAZP8ozAMFK6/cZfOggQixOOnD1GFtgjuG1I6UYzFcgx/AJdid8mmvXLi1xIZMyxH RP6Q== 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=CxDzqoFVC+eH/Z/VxqcqDjW5aD0vS9apzC9wNF1PfnY=; b=lE5Ie9KQjLEfB8UMIqMk2fFmncBRQNqnpfjnuohY8XhhfnZiGGhzD+sUi4abZkv2yb lRBl55iyqVtQazhqn6cYC+PVgjH6VHLNZdwvjtgxPwH2yOESmFQHY9Ej4oZUgTLX6tDe aQSEFZiJk9rzo2wJSg5M+cAe5fmhQcCVLPw0nG8DxrpN+/ok12ObOEkRLR/N7aJk/kr1 LwdUPbncD28Z0X6QNricz7krxq2PcrW2lHoFdqMktrgMSaKkvU4tUuL5f3gx0TNnYz04 iv6FOpIW9SagQO5B6Gvi/lkFwHZZ+n67B7vlX9RAgl/GkvpkuV5Ky0Xgnus6kZ+yByq3 s1Bg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=SJei8jhM; 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 bt23si8303152edb.545.2020.07.13.00.48.36 for ; Mon, 13 Jul 2020 00:48:37 -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=SJei8jhM; 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 S1729191AbgGMHsf (ORCPT ); Mon, 13 Jul 2020 03:48:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50368 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729168AbgGMHrC (ORCPT ); Mon, 13 Jul 2020 03:47:02 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 084F4C061755 for ; Mon, 13 Jul 2020 00:47:02 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id w3so12163784wmi.4 for ; Mon, 13 Jul 2020 00:47:01 -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=CxDzqoFVC+eH/Z/VxqcqDjW5aD0vS9apzC9wNF1PfnY=; b=SJei8jhMPX5u+3OwNxsx2Sz6J0YGJYGYBMz4UNkLPtPT39JBGfcii0JuGg413Kr9xi Ld9CIdHeOBenQCqZfrRDk4bXmhrFg1aUGnWCt6011Db6ubOQTyrRoJpTOKO6MzwbA4gH 9SRBz1MJj/6P2cKaspw/Zu6ExyjvqvDPwwQglxRpfDXuGSfMtIx9mEgnqQhvvAzdqopq Oa9UqTEoCaWYw/jBkVEtwmGVzD3GdxEXtkKLAw0SpTshPCYjeXAaSMSQcAWtzAc8rWsm vlf2EW2WUWg67XdpoF/2I7SuId411TxCl5aePiSNL+iJab4SMyVYaSsNBOVQ9zlC/ytl Oy5g== 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=CxDzqoFVC+eH/Z/VxqcqDjW5aD0vS9apzC9wNF1PfnY=; b=e8vSd9GzolyiLmArBOzcMnt8O3GeJAehC3d4IWRv7HiGo8cUaJIwiZ2CaisyyhfR+a smzSbEXlfZSuS46m7FxbkbQ7Ka26IzhU2KPKzSijGqnIhl+wU6JL8bHpHXgROxEhNtyg E/aZqNGcLj89SCIsu0LcXXa+YvX7B8XC6pTyJgZoPDb9TMoUNYenaSaxTXr1juu7PI3N gmert7hsu2JTJmH68GevWOIa4nOzI1dX8fPaLrtacGYv0c5on8LLtJYA3Cq2NE3k6K3x OVc5X/D9wlU2D8M3Ec1CQvVxYN/FmXAvrZ4fPoBXjNWzHNpkjU+mVaPUvE95pDLmoxFv 1ZKA== X-Gm-Message-State: AOAM533aNzfbV7Zix59LzBbdkwPr205OitAS0s8yfAMR4JMIZqrMw5cp 6OqCl+RTEORtT8g/OLRVqtEAsZb6MSk= X-Received: by 2002:a1c:4d11:: with SMTP id o17mr17318233wmh.134.1594626420749; Mon, 13 Jul 2020 00:47:00 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.46.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:00 -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 v2 12/29] scsi: libfc: fc_fcp: Provide missing and repair existing function documentation Date: Mon, 13 Jul 2020 08:46:28 +0100 Message-Id: <20200713074645.126138-13-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Mostly due to descriptions not keeping up with API changes. Fixes the following W=1 kernel build warning(s): drivers/scsi/libfc/fc_fcp.c:299: warning: Function parameter or member 'status_code' not described in 'fc_fcp_retry_cmd' drivers/scsi/libfc/fc_fcp.c:595: warning: Function parameter or member 'seq' not described in 'fc_fcp_send_data' drivers/scsi/libfc/fc_fcp.c:595: warning: Excess function parameter 'sp' description in 'fc_fcp_send_data' drivers/scsi/libfc/fc_fcp.c:1289: warning: Function parameter or member 't' not described in 'fc_lun_reset_send' drivers/scsi/libfc/fc_fcp.c:1289: warning: Excess function parameter 'data' description in 'fc_lun_reset_send' drivers/scsi/libfc/fc_fcp.c:1422: warning: Function parameter or member 't' not described in 'fc_fcp_timeout' drivers/scsi/libfc/fc_fcp.c:1422: warning: Excess function parameter 'data' description in 'fc_fcp_timeout' drivers/scsi/libfc/fc_fcp.c:1696: warning: Function parameter or member 'code' not described in 'fc_fcp_recovery' drivers/scsi/libfc/fc_fcp.c:1716: warning: Function parameter or member 'offset' not described in 'fc_fcp_srr' drivers/scsi/libfc/fc_fcp.c:1859: warning: Function parameter or member 'sc_cmd' not described in 'fc_queuecommand' drivers/scsi/libfc/fc_fcp.c:1859: warning: Excess function parameter 'cmd' description in 'fc_queuecommand' Cc: Hannes Reinecke Signed-off-by: Lee Jones --- drivers/scsi/libfc/fc_fcp.c | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/libfc/fc_fcp.c b/drivers/scsi/libfc/fc_fcp.c index bf2cc9656e191..e11d4f002bd49 100644 --- a/drivers/scsi/libfc/fc_fcp.c +++ b/drivers/scsi/libfc/fc_fcp.c @@ -289,6 +289,7 @@ static int fc_fcp_send_abort(struct fc_fcp_pkt *fsp) /** * fc_fcp_retry_cmd() - Retry a fcp_pkt * @fsp: The FCP packet to be retried + * @status_code: The FCP status code to set * * Sets the status code to be FC_ERROR and then calls * fc_fcp_complete_locked() which in turn calls fc_io_compl(). @@ -580,7 +581,7 @@ static void fc_fcp_recv_data(struct fc_fcp_pkt *fsp, struct fc_frame *fp) /** * fc_fcp_send_data() - Send SCSI data to a target * @fsp: The FCP packet the data is on - * @sp: The sequence the data is to be sent on + * @seq: The sequence the data is to be sent on * @offset: The starting offset for this data request * @seq_blen: The burst length for this data request * @@ -1283,7 +1284,7 @@ static int fc_fcp_pkt_abort(struct fc_fcp_pkt *fsp) /** * fc_lun_reset_send() - Send LUN reset command - * @data: The FCP packet that identifies the LUN to be reset + * @t: Timer context used to fetch the FSP packet */ static void fc_lun_reset_send(struct timer_list *t) { @@ -1409,7 +1410,7 @@ static void fc_fcp_cleanup(struct fc_lport *lport) /** * fc_fcp_timeout() - Handler for fcp_pkt timeouts - * @data: The FCP packet that has timed out + * @t: Timer context used to fetch the FSP packet * * If REC is supported then just issue it and return. The REC exchange will * complete or time out and recovery can continue at that point. Otherwise, @@ -1691,6 +1692,7 @@ static void fc_fcp_rec_error(struct fc_fcp_pkt *fsp, struct fc_frame *fp) /** * fc_fcp_recovery() - Handler for fcp_pkt recovery * @fsp: The FCP pkt that needs to be aborted + * @code: The FCP status code to set */ static void fc_fcp_recovery(struct fc_fcp_pkt *fsp, u8 code) { @@ -1709,6 +1711,7 @@ static void fc_fcp_recovery(struct fc_fcp_pkt *fsp, u8 code) * fc_fcp_srr() - Send a SRR request (Sequence Retransmission Request) * @fsp: The FCP packet the SRR is to be sent on * @r_ctl: The R_CTL field for the SRR request + * @offset: The SRR relative offset * This is called after receiving status but insufficient data, or * when expecting status but the request has timed out. */ @@ -1851,7 +1854,7 @@ static inline int fc_fcp_lport_queue_ready(struct fc_lport *lport) /** * fc_queuecommand() - The queuecommand function of the SCSI template * @shost: The Scsi_Host that the command was issued to - * @cmd: The scsi_cmnd to be executed + * @sc_cmd: The scsi_cmnd to be executed * * This is the i/o strategy routine, called by the SCSI layer. */ From patchwork Mon Jul 13 07:46:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235326 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611458ilg; Mon, 13 Jul 2020 00:48:29 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyeNbYk7+jYXofdJKTllk7Yr4bPcOOBZVk4PWHTORcIU4wlGZslb8YyKXriIpg08AOJcdlg X-Received: by 2002:a17:906:7247:: with SMTP id n7mr72722611ejk.105.1594626508968; Mon, 13 Jul 2020 00:48:28 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626508; cv=none; d=google.com; s=arc-20160816; b=VNN8WlEwaKMl9vkePIu41a/xCo3pKtnCkN1WWrP/QieSZaZkMtfPOL6Y/jHGJ1UH6A +9ctgVylqUYXTvX9mdmsnlXa7zpU1coeN7BQf4I7s84W0RdmSQxo7VTX3CCuDUgLgCmL AZ8y34h5pCLWxBKDM2oPaTF1qNzVJnD6UcE42WG0TKC2zf3fma64hDiEfW0S671GoYsA E70YgDiKuQgRdOf4BDn84R/hXjUslQpYuvh1g0+Dn/EqEyzI0uSXjQra+2fgZSOJY7WM 4Mq43hw31gXlk20oMtTreJ0CsGIk+o3suir183IuUBUt88Q0iHSRntqSIovPsYQLJ+nH 57yw== 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=u+pt3rF/aF9MXBxaxOWkhoV3OTeQnwTFN7tbYNZX5zs=; b=oPLoEqAPfjd0QlB9GieHHXLPHB/FlCVRbfpSUoHIM3e2fABKDmofl3kIAvypXDjPcN 0Jdn4fzli+rY67oUntnMm/81kBgSuD8D1vWYoGFGWKoyeWAvxk/g2wqL5ayBZNITwdas oWTDOluMNpqWxQPDz9qRSVuQWT9OZyBYjZjBAwhv5P0hmUXng2GapTR6EYwdtwekZrrR 52Akh1ys0cRo7Cpo3XxEJ3JpRGv7/vRmADJSLE+kK+A0+kqW4mvACZO7y6ulIXXBzZAh UewBunWX9Cf48HANdErrqn2sjDrN/aBHXYUXoHQxFTyIiFIUwRQ8nfvetBMeQv7Hh9qH xuhw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=awfg1w8h; 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 bt23si8303152edb.545.2020.07.13.00.48.28 for ; Mon, 13 Jul 2020 00:48:28 -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=awfg1w8h; 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 S1729204AbgGMHrF (ORCPT ); Mon, 13 Jul 2020 03:47:05 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50376 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729184AbgGMHrD (ORCPT ); Mon, 13 Jul 2020 03:47:03 -0400 Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1760DC061755 for ; Mon, 13 Jul 2020 00:47:03 -0700 (PDT) Received: by mail-wr1-x443.google.com with SMTP id f2so14621654wrp.7 for ; Mon, 13 Jul 2020 00:47:03 -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=u+pt3rF/aF9MXBxaxOWkhoV3OTeQnwTFN7tbYNZX5zs=; b=awfg1w8hLZaUeONe8FwFH8j88+Ggd4dTWQYwOx4LJBDj/hooZxwrwNsyZPuFQpyKqD 01XRGH++ZXUAUk6tFVGrk2nqMdjfW1wcQldXKsZIj7u2DzDUZu2y5LkDTEKCfCnYixgU UFFIxMW/qOECoEjRPY0Cfn8mdpxL4gRQpEtc7owyS+zGUQ4fx9Qy7n94Yh2+u7qR2fh4 47Di5k6+PNiKW7wgNJsxV+JBGngbT0y/zMH3RWnt64Fj5HDXXKM6se95Sn7/z0K9ciMm h02W4SFvKbl07l4Gh/BGJySnn89OkKt+I9xBlMJjt7THbizS2equRg/VUbMWtnIaZmvI 8oZw== 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=u+pt3rF/aF9MXBxaxOWkhoV3OTeQnwTFN7tbYNZX5zs=; b=NvRXgYOT7FTkg4xcumfVIDdF1UtIU9rP+weytZ7jogz1V2Bdxh+qyoZj83P6fMmuKl cMUfqN8ShGmue3/SDyPn3d+9tUKKhV+dh5DRyLyzBUkz5iCopMDLOUTMzgfP2SpSF7cU RHDuaGnig7dkFoD8BaUlCZ2XIM/8FlW0O/RywPQuZc+td8ID4KrjhGN0jpu3B4wuW009 w/DhshKc/XUQZQ4D1B1MKEH4rdRmfi9up7iShjVq+/HZbkM/k0XqmC9VJj+ZRfiIZifB cDAWsXVIgoUUSWHn5hZUuYB18yr1BCcBiXrWwsbOrlb2QFzK3+EsnwIvCgu7sy/GVR0J 0QSg== X-Gm-Message-State: AOAM533uGhqnuEnMIC/IjOFSQIAlzAXu/Xj0mDRTuFPy8A1RdUCa5yFO NX+ZDDfd10SxljESgY3P0auGpQ== X-Received: by 2002:adf:f209:: with SMTP id p9mr74769708wro.86.1594626421826; Mon, 13 Jul 2020 00:47:01 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:01 -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 , QLogic-Storage-Upstream@qlogic.com, Prakash Gollapudi Subject: [PATCH v2 13/29] scsi: bnx2fc: bnx2fc_hwi: Fix a couple of bitrotted function documentation headers Date: Mon, 13 Jul 2020 08:46:29 +0100 Message-Id: <20200713074645.126138-14-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Likely a result of documentation not keeping up with API updates (a.k.a. bitrot). Fixes the following W=1 kernel build warning(s): drivers/scsi/bnx2fc/bnx2fc_hwi.c:493: warning: Function parameter or member 'hba' not described in 'bnx2fc_send_session_destroy_req' drivers/scsi/bnx2fc/bnx2fc_hwi.c:493: warning: Excess function parameter 'port' description in 'bnx2fc_send_session_destroy_req' drivers/scsi/bnx2fc/bnx2fc_hwi.c:1345: warning: Function parameter or member 'context' not described in 'bnx2fc_indicate_kcqe' drivers/scsi/bnx2fc/bnx2fc_hwi.c:1345: warning: Function parameter or member 'kcq' not described in 'bnx2fc_indicate_kcqe' drivers/scsi/bnx2fc/bnx2fc_hwi.c:1345: warning: Excess function parameter 'hba' description in 'bnx2fc_indicate_kcqe' drivers/scsi/bnx2fc/bnx2fc_hwi.c:1345: warning: Excess function parameter 'kcqe' description in 'bnx2fc_indicate_kcqe' Cc: QLogic-Storage-Upstream@qlogic.com Cc: Prakash Gollapudi Signed-off-by: Lee Jones --- drivers/scsi/bnx2fc/bnx2fc_hwi.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/bnx2fc/bnx2fc_hwi.c b/drivers/scsi/bnx2fc/bnx2fc_hwi.c index 8c0d6866cf3b8..e72d7bb7f4f42 100644 --- a/drivers/scsi/bnx2fc/bnx2fc_hwi.c +++ b/drivers/scsi/bnx2fc/bnx2fc_hwi.c @@ -485,7 +485,7 @@ int bnx2fc_send_session_disable_req(struct fcoe_port *port, /** * bnx2fc_send_session_destroy_req - initiates FCoE Session destroy * - * @port: port structure pointer + * @hba: adapter structure pointer * @tgt: bnx2fc_rport structure pointer */ int bnx2fc_send_session_destroy_req(struct bnx2fc_hba *hba, @@ -1334,8 +1334,8 @@ static void bnx2fc_init_failure(struct bnx2fc_hba *hba, u32 err_code) /** * bnx2fc_indicae_kcqe - process KCQE * - * @hba: adapter structure pointer - * @kcqe: kcqe pointer + * @context: adapter structure pointer + * @kcq: kcqe pointer * @num_cqe: Number of completion queue elements * * Generic KCQ event handler From patchwork Mon Jul 13 07:46:30 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235327 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611480ilg; Mon, 13 Jul 2020 00:48:31 -0700 (PDT) X-Google-Smtp-Source: ABdhPJykqaHWkj177x9QSUsW2MvBBEYvM8bJwIVZjjsh//DTYaNc8GNUXhjDHDw0Iw5n3wNYtPlj X-Received: by 2002:a50:fe16:: with SMTP id f22mr83861687edt.315.1594626511523; Mon, 13 Jul 2020 00:48:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626511; cv=none; d=google.com; s=arc-20160816; b=U346XqCnVIX17QmV3FMedjhy3h67qer5p4Dt185bl+pRWXsHwL671o2Xr5MADtrj/G KwV2dNxWKPNJ0oCoBGm1L+mUV7RzZJ+/Zp4GyfCel78TOINjzjo1Ar6W5NoLum1W9cuE y3w3sPDkEqtSELEg6k4J5H8ikvlQhvy3Si9cCZ6KEdH5mGy0hxg3RLg0rtIe+E5S3l9V QS9wOOuNyAxQvBYO+QhXLxiQVWn8XB6nOica3AP5LFQyQAgsJNCgnHdJv5MDJHY+XD/O iNDyK3DUkJjZzbJzIF8obhZhwQkPl/RRxqSbbWLKhWGdw2JILExuFrKuuhemSmZD2+GI /pAA== 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=gWJPxbY7PTu5jz1j2WvOZoYFlTAfYyf+i8sx4XKlA9Q=; b=KS7oR7XmVg6V/1vuaZTvKD0DXn6YtnYLlEr/8ot8JhAukA/BwM+4Y7krmtOgpZqjt/ 0CAvwiMRd5nZ8aM1W6N+cddLdFxQO+b8brEmGVFbkycm6IUa2tJUi4bKjj6kReSimPb/ DECUjpTk9PuIH1KI/ebgayR0baR0QD9Zj8qxEmki6iaIJoaT7ZgzTIjbzZtf0KjTi4qA xWKZwZ/CXe69FpEttNMeILOIccN5eX34an5ai5FyxLaj9X5YAnQjYtUcymBFHIDJwyIb u5dl53ds1RLzynEzWfZcMZlJFHPqM1E8pHSaE8kWsQjkaPtRf4E1V4bGwcZrc6jywzRL RRQQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Iblpvh41; 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 bt23si8303152edb.545.2020.07.13.00.48.31 for ; Mon, 13 Jul 2020 00:48:31 -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=Iblpvh41; 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 S1729390AbgGMHsa (ORCPT ); Mon, 13 Jul 2020 03:48:30 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50382 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729197AbgGMHrE (ORCPT ); Mon, 13 Jul 2020 03:47:04 -0400 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 27B6DC08C5DB for ; Mon, 13 Jul 2020 00:47:04 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id s10so14620322wrw.12 for ; Mon, 13 Jul 2020 00:47:04 -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=gWJPxbY7PTu5jz1j2WvOZoYFlTAfYyf+i8sx4XKlA9Q=; b=Iblpvh41eXjrOdJjTRsUzu8iVBS3TRqXzaJvG99kRheRgzkDmnshOxKmtTBEBMPA9x jmlWi9PZOth1sPhyE82AVe0O+376bw6EOyfxeHwHSrysFQlyBL69kazXet94p+dIsmTo 005mYs34cBRTI50dEhCWwuHyuPRRpkgadZDNhS4sPyDJpWGPVXlNre2obgY7ml4ipOUp I8wW7QXg6DMFoAe+JafGwPkolQis82zVsvDFr3Mvv5DAEc8PuDbGcA2wL2Nofho1991C GMH2vyjc1WsHq5e4VJWRqYrZ+HzGP+YGOTjrkPgC/IldEEzQCxHHenqNnoel9m2i+17+ H+cA== 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=gWJPxbY7PTu5jz1j2WvOZoYFlTAfYyf+i8sx4XKlA9Q=; b=bHmm1oIcjpUp5YlYuFmbBM8+3uNqKxgVePbvWDAIQUAq/VYiQa5dG5fcATDONwO+3R A0Zu+47Cmr9uiSp37MoHcrUfJCxR0w7HpULDsX1+Fesq/Ziu8lt78q+62b3jfKBB1T5B 3Eqm3Gdv600SA5woOEQLwTQQHHWc3lpU2KQeVMC7/jlccEPqgsBiLLPGO+rfuRLEw5ZJ Mm18AaYK+4Jku/hldUQ9T+ckpMC0OcelgYrxFJeKMqpFdG77/tvVHhKDSZ/zBUN3EBHi FnCwutAGe9srvxpInvmG7KubC8FEmwLzQT0HkolS9h4RO3tp6kno4zPxqe1LYgQEHUEe Jb0Q== X-Gm-Message-State: AOAM532fs5swY832A+4+nPUpDu/otKhl09tiGmvR4PHAwc3hFvsYFTzR WIc6zTIKGTsNh5X+IUF5mnhhTg== X-Received: by 2002:adf:f10a:: with SMTP id r10mr47129917wro.406.1594626422864; Mon, 13 Jul 2020 00:47:02 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:02 -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 , support@areca.com.tw Subject: [PATCH v2 14/29] scsi: arcmsr: arcmsr_hba: Remove some set but unused variables Date: Mon, 13 Jul 2020 08:46:30 +0100 Message-Id: <20200713074645.126138-15-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Fixes the following W=1 kernel build warning(s): drivers/scsi/arcmsr/arcmsr_hba.c: In function ‘arcmsr_remap_pciregion’: drivers/scsi/arcmsr/arcmsr_hba.c:286:30: warning: variable ‘flags’ set but not used [-Wunused-but-set-variable] 286 | unsigned long addr, range, flags; | ^~~~~ drivers/scsi/arcmsr/arcmsr_hba.c: In function ‘arcmsr_suspend’: drivers/scsi/arcmsr/arcmsr_hba.c:1070:11: warning: variable ‘intmask_org’ set but not used [-Wunused-but-set-variable] 1070 | uint32_t intmask_org; | ^~~~~~~~~~~ drivers/scsi/arcmsr/arcmsr_hba.c: In function ‘arcmsr_done4abort_postqueue’: drivers/scsi/arcmsr/arcmsr_hba.c:1410:29: warning: variable ‘cdb_phy_hipart’ set but not used [-Wunused-but-set-variable] 1410 | unsigned long ccb_cdb_phy, cdb_phy_hipart; | ^~~~~~~~~~~~~~ drivers/scsi/arcmsr/arcmsr_hba.c: In function ‘arcmsr_hbaD_postqueue_isr’: drivers/scsi/arcmsr/arcmsr_hba.c:2448:36: warning: variable ‘cdb_phy_hipart’ set but not used [-Wunused-but-set-variable] 2448 | unsigned long flags, ccb_cdb_phy, cdb_phy_hipart; | ^~~~~~~~~~~~~~ drivers/scsi/arcmsr/arcmsr_hba.c: In function ‘arcmsr_hbaD_polling_ccbdone’: drivers/scsi/arcmsr/arcmsr_hba.c:3498:36: warning: variable ‘cdb_phy_hipart’ set but not used [-Wunused-but-set-variable] 3498 | unsigned long flags, ccb_cdb_phy, cdb_phy_hipart; | ^~~~~~~~~~~~~~ Cc: support@areca.com.tw Signed-off-by: Lee Jones --- drivers/scsi/arcmsr/arcmsr_hba.c | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/arcmsr/arcmsr_hba.c b/drivers/scsi/arcmsr/arcmsr_hba.c index 30914c8f29cc2..1c252934409c7 100644 --- a/drivers/scsi/arcmsr/arcmsr_hba.c +++ b/drivers/scsi/arcmsr/arcmsr_hba.c @@ -283,11 +283,10 @@ static bool arcmsr_remap_pciregion(struct AdapterControlBlock *acb) } case ACB_ADAPTER_TYPE_D: { void __iomem *mem_base0; - unsigned long addr, range, flags; + unsigned long addr, range; addr = (unsigned long)pci_resource_start(pdev, 0); range = pci_resource_len(pdev, 0); - flags = pci_resource_flags(pdev, 0); mem_base0 = ioremap(addr, range); if (!mem_base0) { pr_notice("arcmsr%d: memory mapping region fail\n", @@ -1067,12 +1066,11 @@ static void arcmsr_free_irq(struct pci_dev *pdev, static int arcmsr_suspend(struct pci_dev *pdev, pm_message_t state) { - uint32_t intmask_org; struct Scsi_Host *host = pci_get_drvdata(pdev); struct AdapterControlBlock *acb = (struct AdapterControlBlock *)host->hostdata; - intmask_org = arcmsr_disable_outbound_ints(acb); + arcmsr_disable_outbound_ints(acb); arcmsr_free_irq(pdev, acb); del_timer_sync(&acb->eternal_timer); if (set_date_time) @@ -1407,7 +1405,7 @@ static void arcmsr_done4abort_postqueue(struct AdapterControlBlock *acb) struct ARCMSR_CDB *pARCMSR_CDB; bool error; struct CommandControlBlock *pCCB; - unsigned long ccb_cdb_phy, cdb_phy_hipart; + unsigned long ccb_cdb_phy; switch (acb->adapter_type) { @@ -1489,8 +1487,7 @@ static void arcmsr_done4abort_postqueue(struct AdapterControlBlock *acb) ((toggle ^ 0x4000) + 1); doneq_index = pmu->doneq_index; spin_unlock_irqrestore(&acb->doneq_lock, flags); - cdb_phy_hipart = pmu->done_qbuffer[doneq_index & - 0xFFF].addressHigh; + pmu->done_qbuffer[doneq_index & 0xFFF].addressHigh; addressLow = pmu->done_qbuffer[doneq_index & 0xFFF].addressLow; ccb_cdb_phy = (addressLow & 0xFFFFFFF0); @@ -2445,7 +2442,7 @@ static void arcmsr_hbaD_postqueue_isr(struct AdapterControlBlock *acb) struct MessageUnit_D *pmu; struct ARCMSR_CDB *arcmsr_cdb; struct CommandControlBlock *ccb; - unsigned long flags, ccb_cdb_phy, cdb_phy_hipart; + unsigned long flags, ccb_cdb_phy; spin_lock_irqsave(&acb->doneq_lock, flags); pmu = acb->pmuD; @@ -2459,8 +2456,7 @@ static void arcmsr_hbaD_postqueue_isr(struct AdapterControlBlock *acb) pmu->doneq_index = index_stripped ? (index_stripped | toggle) : ((toggle ^ 0x4000) + 1); doneq_index = pmu->doneq_index; - cdb_phy_hipart = pmu->done_qbuffer[doneq_index & - 0xFFF].addressHigh; + pmu->done_qbuffer[doneq_index & 0xFFF].addressHigh; addressLow = pmu->done_qbuffer[doneq_index & 0xFFF].addressLow; ccb_cdb_phy = (addressLow & 0xFFFFFFF0); @@ -3495,7 +3491,7 @@ static int arcmsr_hbaD_polling_ccbdone(struct AdapterControlBlock *acb, bool error; uint32_t poll_ccb_done = 0, poll_count = 0, flag_ccb; int rtn, doneq_index, index_stripped, outbound_write_pointer, toggle; - unsigned long flags, ccb_cdb_phy, cdb_phy_hipart; + unsigned long flags, ccb_cdb_phy; struct ARCMSR_CDB *arcmsr_cdb; struct CommandControlBlock *pCCB; struct MessageUnit_D *pmu = acb->pmuD; @@ -3527,8 +3523,7 @@ static int arcmsr_hbaD_polling_ccbdone(struct AdapterControlBlock *acb, ((toggle ^ 0x4000) + 1); doneq_index = pmu->doneq_index; spin_unlock_irqrestore(&acb->doneq_lock, flags); - cdb_phy_hipart = pmu->done_qbuffer[doneq_index & - 0xFFF].addressHigh; + pmu->done_qbuffer[doneq_index & 0xFFF].addressHigh; flag_ccb = pmu->done_qbuffer[doneq_index & 0xFFF].addressLow; ccb_cdb_phy = (flag_ccb & 0xFFFFFFF0); if (acb->cdb_phyadd_hipart) From patchwork Mon Jul 13 07:46:31 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235325 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611408ilg; Mon, 13 Jul 2020 00:48:25 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxb4MPdPfmZNye6I2NjoQid815+fVVkF/5HbnoihwHUjPZlXW6sxTaRpdF52PgsQcBZGfa5 X-Received: by 2002:a17:906:6406:: with SMTP id d6mr2244789ejm.30.1594626505266; Mon, 13 Jul 2020 00:48:25 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626505; cv=none; d=google.com; s=arc-20160816; b=c/7bgM7JQgTXty4mybxyNZCUQ9yVPPzeigHQ36WwcpOMjGYbCvW9mNXURoZINAUcwm yBw2s7fyIiRtBHo1DoH8WY0m8kQqeNH8mfyxb3iznkMDcjPpzcyV103aj7I4b5eIiejt a1WKQTe9iIyomv8jIaVx3wgvCwHSjRnTArmeDMb/CCuBDJO5T/cu+J5Pty9ofqb/MwPZ PXheh+ZtyuRdGjMFjEFEQsjbkwW8kw02JGxfyUA4OV6rWTE0NyYAMzlDYWOZk3K0PHWw LsdFUEK+v3TKVWY38GxJiTy6Vw3lF4MSJaB1qF9E2gTMbRdOKfUcW3FYrGQ41TSzJ8XO F39g== 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=sZwSMA5UIb7oM9+D5j+l12KsCqeP4op1hhjOFtyL2ps=; b=vF79BlxPD7Jp48pRRyulCpFrSq5GqzjYXZd8SozlLT3/Uh1/o2icsyxDPewzlnzhP+ 1GC9mmP19RTxgxc+TA6bM+fmh4W0h0y3/TH/s0ErOV7ZfE3OElNXxNkzTt3XY0CnH8rR 2v9ZLZXuuMkWJfTJ2/PNV9qse14DtaSqpyT6FrjH0FFP41aED+WAId+71vJeQsZ37PPT OKYzoJLmOmy45zVNpVTuj7FwYHTjVge7n1PtVb0XOoXFEaaT+AwMUNBkq2IWLN/4bvnu rh/m/hXGcs8BWW8Ao0MdKUz3zInt3ZstHmNUgkqDibAOL0vET2jVArM36hxx1LzrfhJ3 Rpwg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=WVs2+uF6; 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 pw26si8594214ejb.240.2020.07.13.00.48.25 for ; Mon, 13 Jul 2020 00:48:25 -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=WVs2+uF6; 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 S1729247AbgGMHsX (ORCPT ); Mon, 13 Jul 2020 03:48:23 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50392 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729184AbgGMHrF (ORCPT ); Mon, 13 Jul 2020 03:47:05 -0400 Received: from mail-wr1-x441.google.com (mail-wr1-x441.google.com [IPv6:2a00:1450:4864:20::441]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0C14EC061794 for ; Mon, 13 Jul 2020 00:47:05 -0700 (PDT) Received: by mail-wr1-x441.google.com with SMTP id s10so14620458wrw.12 for ; Mon, 13 Jul 2020 00:47:04 -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=sZwSMA5UIb7oM9+D5j+l12KsCqeP4op1hhjOFtyL2ps=; b=WVs2+uF6EIGxSusGMZCNpP6EUsgaIKOXWGq+dOaevV6oaUpV5lUiIg9YswM1zqBUNW eOabfzNTnHYSzTXdtc6GDH+16lFI+k1myn4G1zaFxhmEBq8aVoAUQpUqyor3lyAU6ZFy Q0CtP8+oU+OAdFffEu/8V/JJqGFswWdTMgxTvNiVv/vW/rTRvDQCzrx9LsejztDI9MSX wmOdoit455RnLFjYMPpjuccL6aoi7/h8zEEaDqSFCnwNoVnHu9tlLFrlUqfZJZvuZGGZ vslI8fKjwbjtjXnApNZDLJgdu39rwxDGcBuDdYLsTaa2Q8Q4etMIMFRgBpMfj+jcxOa4 AVug== 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=sZwSMA5UIb7oM9+D5j+l12KsCqeP4op1hhjOFtyL2ps=; b=uWyZDtv1GJMlEBBOT/lNijMdu7FNilDZPXO6Q60vkzMt611OTZ8N8JqRRmHSnhSarg HhS6g+1484pkmOP/uP9LFkSfYvCsgcoIQc6QJshxYd4aoGwMCZvHXUd6Tg5do3e6LQD3 bOS6dWmE06JpMxiVQV7l04O8oJqd+V6zmy/PAZAxlgQNrLvs9z078LqIoE/lzGBclS6O HecFFcfiVGC3oBc0hmo7AShgtNOWIFFvg4F3xyUUmuNC9zHwGtHR7hsZ+MJx7CC4RVDF V4SVg5jIDdAdeLbdzsZ6lnUZmMhXgixYjsWDDgCabSKDzjYVOx7W1bOJZtFSzwk4A7mn ZFDA== X-Gm-Message-State: AOAM531h5aO2u9VNq5IU6huCa/kgoAlmvR0RSfM9JbataOpOAznxPZNZ pXWdvl1gzkFY0fUWWGk7daJGOCqod8Q= X-Received: by 2002:adf:ed8c:: with SMTP id c12mr45033798wro.359.1594626423812; Mon, 13 Jul 2020 00:47:03 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:03 -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 , support@areca.com.tw Subject: [PATCH v2 15/29] scsi: arcmsr: arcmsr_hba: Make room for the trailing NULL, even if it is over-written Date: Mon, 13 Jul 2020 08:46:31 +0100 Message-Id: <20200713074645.126138-16-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Ensure we do not copy the final one (which is not overwitten). Fixes the following W=1 kernel build warning(s): In file included from include/linux/bitmap.h:9, from include/linux/nodemask.h:95, from include/linux/mmzone.h:17, from include/linux/gfp.h:6, from include/linux/umh.h:4, from include/linux/kmod.h:9, from include/linux/module.h:16, from drivers/scsi/arcmsr/arcmsr_hba.c:47: In function ‘strncpy’, inlined from ‘arcmsr_handle_virtual_command’ at drivers/scsi/arcmsr/arcmsr_hba.c:3055:3: include/linux/string.h:297:30: warning: ‘__builtin_strncpy’ output truncated before terminating nul copying 4 bytes from a string of the same length [-Wstringop-truncation] 297 | #define __underlying_strncpy __builtin_strncpy | ^ include/linux/string.h:307:9: note: in expansion of macro ‘__underlying_strncpy’ 307 | return __underlying_strncpy(p, q, size); | ^~~~~~~~~~~~~~~~~~~~ In function ‘strncpy’, inlined from ‘arcmsr_handle_virtual_command’ at drivers/scsi/arcmsr/arcmsr_hba.c:3053:3: include/linux/string.h:297:30: warning: ‘__builtin_strncpy’ output truncated before terminating nul copying 16 bytes from a string of the same length [-Wstringop-truncation] 297 | #define __underlying_strncpy __builtin_strncpy | ^ include/linux/string.h:307:9: note: in expansion of macro ‘__underlying_strncpy’ 307 | return __underlying_strncpy(p, q, size); | ^~~~~~~~~~~~~~~~~~~~ In function ‘strncpy’, inlined from ‘arcmsr_handle_virtual_command’ at drivers/scsi/arcmsr/arcmsr_hba.c:3051:3: include/linux/string.h:297:30: warning: ‘__builtin_strncpy’ output truncated before terminating nul copying 8 bytes from a string of the same length [-Wstringop-truncation] 297 | #define __underlying_strncpy __builtin_strncpy | ^ include/linux/string.h:307:9: note: in expansion of macro ‘__underlying_strncpy’ 307 | return __underlying_strncpy(p, q, size); | ^~~~~~~~~~~~~~~~~~~~ Cc: support@areca.com.tw Signed-off-by: Lee Jones --- drivers/scsi/arcmsr/arcmsr_hba.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/arcmsr/arcmsr_hba.c b/drivers/scsi/arcmsr/arcmsr_hba.c index 1c252934409c7..5feed135eb26c 100644 --- a/drivers/scsi/arcmsr/arcmsr_hba.c +++ b/drivers/scsi/arcmsr/arcmsr_hba.c @@ -3031,7 +3031,7 @@ static void arcmsr_handle_virtual_command(struct AdapterControlBlock *acb, { switch (cmd->cmnd[0]) { case INQUIRY: { - unsigned char inqdata[36]; + unsigned char inqdata[37]; char *buffer; struct scatterlist *sg; @@ -3048,16 +3048,16 @@ static void arcmsr_handle_virtual_command(struct AdapterControlBlock *acb, /* ISO, ECMA, & ANSI versions */ inqdata[4] = 31; /* length of additional data */ - strncpy(&inqdata[8], "Areca ", 8); + strncpy(&inqdata[8], "Areca ", 9); /* Vendor Identification */ - strncpy(&inqdata[16], "RAID controller ", 16); + strncpy(&inqdata[16], "RAID controller ", 17); /* Product Identification */ - strncpy(&inqdata[32], "R001", 4); /* Product Revision */ + strncpy(&inqdata[32], "R001", 5); /* Product Revision */ sg = scsi_sglist(cmd); buffer = kmap_atomic(sg_page(sg)) + sg->offset; - memcpy(buffer, inqdata, sizeof(inqdata)); + memcpy(buffer, inqdata, sizeof(inqdata) - 1); sg = scsi_sglist(cmd); kunmap_atomic(buffer - sg->offset); From patchwork Mon Jul 13 07:46:32 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235311 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2610715ilg; Mon, 13 Jul 2020 00:47:09 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxZHirGVqT/F+v1u42ukaG6dC6ZkeXkdo65ZOsDB5L9OBdRLjyU4OH/+Q6MyOOdZ2qHPsTV X-Received: by 2002:aa7:d989:: with SMTP id u9mr72312499eds.85.1594626429286; Mon, 13 Jul 2020 00:47:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626429; cv=none; d=google.com; s=arc-20160816; b=smJecEAlOpswJaOOk6ezwtsEfIlYg0nLbSnrkvQsS9dAEAdKieFFW71H5sx451ynMO C2WQMuZ5pnkrIqdxo6XdYOACYvAQWOITXkK2+u4c/fcnT2z9D/45ThoLsxG1G8A+XfHC Ggijbnmt5WpWlkbrqD1hBoLUHJ/bNuo88h7oco97t8SkOU+yo0BUVDqO7tFXKWXDHU05 0LKU22HeHz7ND69YsZNyZMEChwgna+4boA4237swON81Mml9GPM5zxRp2DP36TkmM7CB dIGSLopneKK2d46icfILR4f0lG7OA2F9Edn7JF1HtoseIv/rDcIJiFNVw8o9oVeRinsn 46eA== 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=mg1YIIvkYpJ6DUGLzmprsP3AfdbwaW1FuT6nykJ+1c8=; b=rYiaCwsYCkGNzWBKZ1AXeGspOQNYfsm6xtvgD6BDBYWtp6rtXYKSpXRWdgGNOBF/2f PqlU/AqZzAJD5Bqf+frYm9NBEbaU5xc/fQrwDr6Cxw70qOdhQYdtt0mYkHHFQST//pfZ 84vuZmGXD5/2oj8yJ5PhhtykeJsBZF9tfm0zKjz6s/mpemJqkjcBQH7u/FViqpBT9bCa Dog60olUaYIJmm/PaOx/n59MNaMgEngK+lQZ+6BCMnIgaFJojRtqTfGlTGU/K3MT3XA3 v2l6eB/tjKecWjQGhVqL3fjxKpqq4kAXeJloD+z7/R/Fb09vB1aWmNW1j+lxJn5AooUf gbrg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="U2/vEO4s"; 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 p15si8499882ejg.22.2020.07.13.00.47.09 for ; Mon, 13 Jul 2020 00:47:09 -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="U2/vEO4s"; 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 S1729259AbgGMHrI (ORCPT ); Mon, 13 Jul 2020 03:47:08 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50394 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729232AbgGMHrG (ORCPT ); Mon, 13 Jul 2020 03:47:06 -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 0F842C08C5DB for ; Mon, 13 Jul 2020 00:47:06 -0700 (PDT) Received: by mail-wr1-x442.google.com with SMTP id f2so14622021wrp.7 for ; Mon, 13 Jul 2020 00:47:05 -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=mg1YIIvkYpJ6DUGLzmprsP3AfdbwaW1FuT6nykJ+1c8=; b=U2/vEO4sBwQUij6cfUsOS7v58zUw1SMZUJtUZUzyJ/S4FatqDVN9j5TT6MdgJoKpL3 RcdVFWGJAYt1Tmd0ddS8kp3pPNuXwkDx0XsNDF4FWoXcqpAIKF+eFBNCsHxY/Y3Yfrdk +kyb+srCvQQrZpqKm+DuZDE1B3xTGSCeWx3dNRzTi8yzoR2pvXVQ0RJqbYhYa2ZsYhZw LqYUkmch0nXseTySDtFnlLWnZeGX+gEe2/t9Fj65V9PapcWQqYAvekT0Qqz2GdijuFXQ fHdXpo+t7PN8s64hagaeEASS79RS5JHJICQkmZFWprTFiIoGPAcDrKccPQdTt7kXSyjr RJsA== 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=mg1YIIvkYpJ6DUGLzmprsP3AfdbwaW1FuT6nykJ+1c8=; b=BWBSlRtcKQSA6L+yFlazX0HiydA/xGvCq6aL+qNw17p91BD1m4yxl+4XsGQWDmznVo zL819B+7m1I87J+5dWXiwUcFOa9Vu1k35tyU+FQzCT8jZamTiP46VfRXwFWC0+nVcXci 2ztOZ81vL8J5cauPWDZUoQky0K9D1n+LKuDsgaBgJcqcHCRC8xpghjDPJNo8wryMCiWz M3FqzbeqDkq4bmDIXCl83nSPIOKZsnL6Nr33aJzoUGfxcRN9qNF1MEAfyKvyxxd14CY7 Mn24XXQfuyIZHeNQ7fTGDa7LK8j+pk0cbQluDIQ4Ag9T6Oi0PRz1kuOOpj+vaFZVNhZ6 uooA== X-Gm-Message-State: AOAM530vW3e9njRxHvlw2b57x72NL9IyqweMiXeJuppGpONZKQvNy5Y/ NHF4hIBwgRziMkG6Grq34XH17zQTr+M= X-Received: by 2002:a5d:658a:: with SMTP id q10mr78336751wru.220.1594626424768; Mon, 13 Jul 2020 00:47:04 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:04 -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 , QLogic-Storage-Upstream@cavium.com Subject: [PATCH v2 16/29] scsi: qedf: qedf_io: Remove a whole host of unused variables Date: Mon, 13 Jul 2020 08:46:32 +0100 Message-Id: <20200713074645.126138-17-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Fixes the following W=1 kernel build warning(s): drivers/scsi/qedf/qedf_io.c: In function ‘qedf_cmd_timeout’: drivers/scsi/qedf/qedf_io.c:25:5: warning: variable ‘op’ set but not used [-Wunused-but-set-variable] 25 | u8 op = 0; | ^~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_map_sg’: drivers/scsi/qedf/qedf_io.c:490:12: warning: variable ‘end_addr’ set but not used [-Wunused-but-set-variable] 490 | u64 addr, end_addr; | ^~~~~~~~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_post_io_req’: drivers/scsi/qedf/qedf_io.c:863:22: warning: variable ‘req_type’ set but not used [-Wunused-but-set-variable] 863 | enum fcoe_task_type req_type = 0; | ^~~~~~~~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_scsi_completion’: drivers/scsi/qedf/qedf_io.c:1134:31: warning: variable ‘task_ctx’ set but not used [-Wunused-but-set-variable] 1134 | struct e4_fcoe_task_context *task_ctx; | ^~~~~~~~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_scsi_done’: drivers/scsi/qedf/qedf_io.c:1345:6: warning: variable ‘xid’ set but not used [-Wunused-but-set-variable] 1345 | u16 xid; | ^~~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_initiate_abts’: drivers/scsi/qedf/qedf_io.c:1866:6: warning: variable ‘r_a_tov’ set but not used [-Wunused-but-set-variable] 1866 | u32 r_a_tov = 0; | ^~~~~~~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_process_abts_compl’: drivers/scsi/qedf/qedf_io.c:1967:11: warning: variable ‘xid’ set but not used [-Wunused-but-set-variable] 1967 | uint16_t xid; | ^~~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_initiate_cleanup’: drivers/scsi/qedf/qedf_io.c:2163:31: warning: variable ‘task’ set but not used [-Wunused-but-set-variable] 2163 | struct e4_fcoe_task_context *task; | ^~~~ drivers/scsi/qedf/qedf_io.c: In function ‘qedf_process_unsol_compl’: drivers/scsi/qedf/qedf_io.c:2534:11: warning: variable ‘tmp’ set but not used [-Wunused-but-set-variable] 2534 | uint16_t tmp; | ^~~ Cc: QLogic-Storage-Upstream@cavium.com Signed-off-by: Lee Jones --- drivers/scsi/qedf/qedf_io.c | 30 ++++-------------------------- 1 file changed, 4 insertions(+), 26 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/qedf/qedf_io.c b/drivers/scsi/qedf/qedf_io.c index 0f6a15c1a04b3..acd9774a9387c 100644 --- a/drivers/scsi/qedf/qedf_io.c +++ b/drivers/scsi/qedf/qedf_io.c @@ -22,7 +22,6 @@ static void qedf_cmd_timeout(struct work_struct *work) container_of(work, struct qedf_ioreq, timeout_work.work); struct qedf_ctx *qedf; struct qedf_rport *fcport; - u8 op = 0; if (io_req == NULL) { QEDF_INFO(NULL, QEDF_LOG_IO, "io_req is NULL.\n"); @@ -89,7 +88,6 @@ static void qedf_cmd_timeout(struct work_struct *work) io_req->event = QEDF_IOREQ_EV_ELS_TMO; /* Call callback function to complete command */ if (io_req->cb_func && io_req->cb_arg) { - op = io_req->cb_arg->op; io_req->cb_func(io_req->cb_arg); io_req->cb_arg = NULL; } @@ -487,7 +485,7 @@ static int qedf_map_sg(struct qedf_ioreq *io_req) int sg_count = 0; int bd_count = 0; u32 sg_len; - u64 addr, end_addr; + u64 addr; int i = 0; sg_count = dma_map_sg(&qedf->pdev->dev, scsi_sglist(sc), @@ -502,10 +500,9 @@ static int qedf_map_sg(struct qedf_ioreq *io_req) scsi_for_each_sg(sc, sg, sg_count, i) { sg_len = (u32)sg_dma_len(sg); addr = (u64)sg_dma_address(sg); - end_addr = (u64)(addr + sg_len); /* - * Intermediate s/g element so check if start and end address + * Intermediate s/g element so check if start address * is page aligned. Only required for writes and only if the * number of scatter/gather elements is 8 or more. */ @@ -860,7 +857,6 @@ int qedf_post_io_req(struct qedf_rport *fcport, struct qedf_ioreq *io_req) struct qedf_ctx *qedf = lport_priv(lport); struct e4_fcoe_task_context *task_ctx; u16 xid; - enum fcoe_task_type req_type = 0; struct fcoe_wqe *sqe; u16 sqe_idx; @@ -873,11 +869,9 @@ int qedf_post_io_req(struct qedf_rport *fcport, struct qedf_ioreq *io_req) io_req->cpu = smp_processor_id(); if (sc_cmd->sc_data_direction == DMA_FROM_DEVICE) { - req_type = FCOE_TASK_TYPE_READ_INITIATOR; io_req->io_req_flags = QEDF_READ; qedf->input_requests++; } else if (sc_cmd->sc_data_direction == DMA_TO_DEVICE) { - req_type = FCOE_TASK_TYPE_WRITE_INITIATOR; io_req->io_req_flags = QEDF_WRITE; qedf->output_requests++; } else { @@ -1130,8 +1124,6 @@ static void qedf_unmap_sg_list(struct qedf_ctx *qedf, struct qedf_ioreq *io_req) void qedf_scsi_completion(struct qedf_ctx *qedf, struct fcoe_cqe *cqe, struct qedf_ioreq *io_req) { - u16 xid; - struct e4_fcoe_task_context *task_ctx; struct scsi_cmnd *sc_cmd; struct fcoe_cqe_rsp_info *fcp_rsp; struct qedf_rport *fcport; @@ -1155,8 +1147,6 @@ void qedf_scsi_completion(struct qedf_ctx *qedf, struct fcoe_cqe *cqe, return; } - xid = io_req->xid; - task_ctx = qedf_get_task_mem(&qedf->tasks, xid); sc_cmd = io_req->sc_cmd; fcp_rsp = &cqe->cqe_info.rsp_info; @@ -1342,7 +1332,6 @@ void qedf_scsi_completion(struct qedf_ctx *qedf, struct fcoe_cqe *cqe, void qedf_scsi_done(struct qedf_ctx *qedf, struct qedf_ioreq *io_req, int result) { - u16 xid; struct scsi_cmnd *sc_cmd; int refcount; @@ -1364,7 +1353,6 @@ void qedf_scsi_done(struct qedf_ctx *qedf, struct qedf_ioreq *io_req, */ clear_bit(QEDF_CMD_OUTSTANDING, &io_req->flags); - xid = io_req->xid; sc_cmd = io_req->sc_cmd; if (!sc_cmd) { @@ -1863,7 +1851,6 @@ int qedf_initiate_abts(struct qedf_ioreq *io_req, bool return_scsi_cmd_on_abts) struct fc_rport_priv *rdata; struct qedf_ctx *qedf; u16 xid; - u32 r_a_tov = 0; int rc = 0; unsigned long flags; struct fcoe_wqe *sqe; @@ -1886,7 +1873,6 @@ int qedf_initiate_abts(struct qedf_ioreq *io_req, bool return_scsi_cmd_on_abts) goto out; } - r_a_tov = rdata->r_a_tov; lport = qedf->lport; if (lport->state != LPORT_ST_READY || !(lport->link_up)) { @@ -1964,14 +1950,12 @@ void qedf_process_abts_compl(struct qedf_ctx *qedf, struct fcoe_cqe *cqe, struct qedf_ioreq *io_req) { uint32_t r_ctl; - uint16_t xid; int rc; struct qedf_rport *fcport = io_req->fcport; QEDF_INFO(&(qedf->dbg_ctx), QEDF_LOG_SCSI_TM, "Entered with xid = " "0x%x cmd_type = %d\n", io_req->xid, io_req->cmd_type); - xid = io_req->xid; r_ctl = cqe->cqe_info.abts_info.r_ctl; /* This was added at a point when we were scheduling abts_compl & @@ -2159,8 +2143,6 @@ int qedf_initiate_cleanup(struct qedf_ioreq *io_req, { struct qedf_rport *fcport; struct qedf_ctx *qedf; - uint16_t xid; - struct e4_fcoe_task_context *task; int tmo = 0; int rc = SUCCESS; unsigned long flags; @@ -2220,12 +2202,9 @@ int qedf_initiate_cleanup(struct qedf_ioreq *io_req, refcount, fcport, fcport->rdata->ids.port_id); /* Cleanup cmds re-use the same TID as the original I/O */ - xid = io_req->xid; io_req->cmd_type = QEDF_CLEANUP; io_req->return_scsi_cmd_on_abts = return_scsi_cmd_on_abts; - task = qedf_get_task_mem(&qedf->tasks, xid); - init_completion(&io_req->cleanup_done); spin_lock_irqsave(&fcport->rport_lock, flags); @@ -2531,7 +2510,6 @@ void qedf_process_unsol_compl(struct qedf_ctx *qedf, uint16_t que_idx, struct fcoe_cqe *cqe) { unsigned long flags; - uint16_t tmp; uint16_t pktlen = cqe->cqe_info.unsolic_info.pkt_len; u32 payload_len, crc; struct fc_frame_header *fh; @@ -2629,9 +2607,9 @@ void qedf_process_unsol_compl(struct qedf_ctx *qedf, uint16_t que_idx, qedf->bdq_prod_idx = 0; writew(qedf->bdq_prod_idx, qedf->bdq_primary_prod); - tmp = readw(qedf->bdq_primary_prod); + readw(qedf->bdq_primary_prod); writew(qedf->bdq_prod_idx, qedf->bdq_secondary_prod); - tmp = readw(qedf->bdq_secondary_prod); + readw(qedf->bdq_secondary_prod); spin_unlock_irqrestore(&qedf->hba_lock, flags); } From patchwork Mon Jul 13 07:46:33 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235324 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611385ilg; Mon, 13 Jul 2020 00:48:23 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxRV6qA9FN2EMkTKtHYAwO6f1od9NYZODxOapEq6wX7s2UvjZkQ/ksoKeP9hvSLf2Sbo3BJ X-Received: by 2002:a17:906:6b8d:: with SMTP id l13mr71986752ejr.136.1594626503164; Mon, 13 Jul 2020 00:48:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626503; cv=none; d=google.com; s=arc-20160816; b=IqW3kwUa1b/Q7csrrY5SGei8E+AmUw9uxhR9/T18OBPHG8BZAmVlf3RZhMTKEACpBI nhAhEUPtP//UCQ5O2YKlQqwaJ5aNf9u+riEB8Z4+4q3N2CYN9RSAY+gGcezHVEI9merH px3HHvBXPjrrteSbQsqbtgwNUwmunj7ebiLLLDgdFh5B/MA41lUU6C8LZoGJaMBz0jn4 Jjbb8jGmEBRETO4+nFenyquSmXrxvyjXloUQG6S3A/bnnSuvoyIx8D7lMaqNdnUfXLUA mRMpjClNaDghIqxq2AFWNTLbZGpfVoiDXzFg8dkFWozApsmAVYEbIaM6yFbrOg0Ie99z G06Q== 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=rsv1890EAaVy29cSOpHY+htSuPNyhdWUNl+08rJAqiI=; b=Z3eMxZolN78e+eAKG/DalcKMccT3jtwBlSeO7/hmErdZkdHpPFcRoZt/XTTqDzMPqI Y6sQyaLzbztZt4lY7+rJFvMpfgHMcwT77JNOjwvnFMs8DriLLFEe+MA/891U3GUzbtKD PGQq4MVG5fi2LDJ6Wm++7qPI2RPf05GdIOJfqlsk/RAJEPImLxzyU75dYb/LoVwiHD9Q 3S8qqDFZKMFJk8knOoSN9SzOsnEkhkg9GiwMRZpEpg9JVlSdVpSDiJL36pzrpm3H8Qc/ f8bsnkjtNit10cxZ254tUPIg5l5rtcnmF/rl4yG+KIAK9O4HUsNOcUk88liZRugiPDMP CiMg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=ntBIcsLk; 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 l4si9513464edi.316.2020.07.13.00.48.22 for ; Mon, 13 Jul 2020 00:48:23 -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=ntBIcsLk; 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 S1729584AbgGMHsT (ORCPT ); Mon, 13 Jul 2020 03:48:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50404 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729249AbgGMHrH (ORCPT ); Mon, 13 Jul 2020 03:47:07 -0400 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 2D840C08C5DF for ; Mon, 13 Jul 2020 00:47:07 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id z15so14648574wrl.8 for ; Mon, 13 Jul 2020 00:47:07 -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=rsv1890EAaVy29cSOpHY+htSuPNyhdWUNl+08rJAqiI=; b=ntBIcsLkqlyxYanzlfC2o1xlo6Ee7AL4sI/5CvVsDBQG26dGWUk4Q40RjQJ7gs5anB rxovhh6wJ9o+YYM+zaze8u60YveI9FzLur/49aOY4Bi7mDHnEJHPqadeTji0qiBM8DMx 5O2jYjgUcgXCCKdXvVh7grHzr6kGvWLOlcNwoRoPNkdzOEcckh7/RjDSi5RE5v4IpJGM mW6yxKma4yTybwzHNJ6bvxKQK5Jq5lzVA0hYJQJ+2gYzeCXuDvm9Pjrlrh45B6ZUVMnr icpuurgf/2KXjBDKjL1R+EXbjy6dyE+fUGGSeNRlXsZgo6xLEPXQ8fF3qxFNaw6lxk5c DOqQ== 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=rsv1890EAaVy29cSOpHY+htSuPNyhdWUNl+08rJAqiI=; b=g/n4Y/WEhsycRU3eJcYg3uIfewKLqlTMCBA0K8btVG8IswNqYpDQOYgxzN9MKpBoY4 NXmTypPEEvfrotpcbkZN8ccRbdFHdcN2XQlf/mE7JGRbS3FJt7i9HuJczr6Jp5YJRAnC BM+rkd3Xt6T3tq/uwXjwo0BQvfufm6zBE1EW47E+udmTOQuODz3lTICUCR/mut+dvU3P 2ZwTT51sAp8XRVGovwTrBmnNHcj3873xKqo2VSjMOKR4Cc39msyxrT0VgJr3a9ahN8tK w+5WUPHz6ceGI08b/5uugnvum0B+H+pnk/LUhr/BLfmIxmvID9F+9cfrw6EEcmumsF6S 9tCw== X-Gm-Message-State: AOAM530kL0LqChd6H/NKuwjMxlm4k7ZGk3r6yDYLKKVJVB1wkVhixYM6 6FECUGIkaU1EHRz/N4zIZJA2e60cgFQ= X-Received: by 2002:adf:dc90:: with SMTP id r16mr79169289wrj.264.1594626425952; Mon, 13 Jul 2020 00:47:05 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:05 -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 , QLogic-Storage-Upstream@qlogic.com, Prakash Gollapudi Subject: [PATCH v2 17/29] scsi: bnx2fc: bnx2fc_tgt: Demote obvious misuse of kerneldoc to standard comment blocks Date: Mon, 13 Jul 2020 08:46:33 +0100 Message-Id: <20200713074645.126138-18-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 No attempt has been made to document either of the demoted functions here. Fixes the following W=1 kernel build warning(s): drivers/scsi/bnx2fc/bnx2fc_tgt.c:442: warning: Function parameter or member 'lport' not described in 'bnx2fc_rport_event_handler' drivers/scsi/bnx2fc/bnx2fc_tgt.c:442: warning: Function parameter or member 'rdata' not described in 'bnx2fc_rport_event_handler' drivers/scsi/bnx2fc/bnx2fc_tgt.c:442: warning: Function parameter or member 'event' not described in 'bnx2fc_rport_event_handler' drivers/scsi/bnx2fc/bnx2fc_tgt.c:665: warning: Function parameter or member 'hba' not described in 'bnx2fc_alloc_session_resc' drivers/scsi/bnx2fc/bnx2fc_tgt.c:665: warning: Function parameter or member 'tgt' not described in 'bnx2fc_alloc_session_resc' Cc: QLogic-Storage-Upstream@qlogic.com Cc: Prakash Gollapudi Signed-off-by: Lee Jones --- drivers/scsi/bnx2fc/bnx2fc_tgt.c | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/bnx2fc/bnx2fc_tgt.c b/drivers/scsi/bnx2fc/bnx2fc_tgt.c index 50384b4a817c8..a3e2a38aabf2f 100644 --- a/drivers/scsi/bnx2fc/bnx2fc_tgt.c +++ b/drivers/scsi/bnx2fc/bnx2fc_tgt.c @@ -431,7 +431,7 @@ static int bnx2fc_init_tgt(struct bnx2fc_rport *tgt, return 0; } -/** +/* * This event_callback is called after successful completion of libfc * initiated target login. bnx2fc can proceed with initiating the session * establishment. @@ -656,9 +656,8 @@ static void bnx2fc_free_conn_id(struct bnx2fc_hba *hba, u32 conn_id) spin_unlock_bh(&hba->hba_lock); } -/** - *bnx2fc_alloc_session_resc - Allocate qp resources for the session - * +/* + * bnx2fc_alloc_session_resc - Allocate qp resources for the session */ static int bnx2fc_alloc_session_resc(struct bnx2fc_hba *hba, struct bnx2fc_rport *tgt) From patchwork Mon Jul 13 07:46:34 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235323 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611348ilg; Mon, 13 Jul 2020 00:48:17 -0700 (PDT) X-Google-Smtp-Source: ABdhPJx6PjGsL2WnBuE2OVQFFgaRhQyjbZcPxxX6EpnwcHeRF2C5zAMMpIIuphvAh5zlMWiQRXzh X-Received: by 2002:a05:6402:1605:: with SMTP id f5mr95001858edv.8.1594626497522; Mon, 13 Jul 2020 00:48:17 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626497; cv=none; d=google.com; s=arc-20160816; b=CRO90MiHUYZxkhhbqpeMfuxZjsK1VQ+P3+Vmvip6f2reRXotD+BAlqvBSFgTnrr642 EE8z+h57yXHT2mx5xmR3Ulr3YRxNSBL0Ru4b0lFJvi5anwzRvJRlxskHbjslBUT52mgB j2PjV1g3DRK0GmubYzdi9rttetrF9e4YsL629Uw0qQZqd324TIOYBXUHUA27mYJRM9jG 96qkcQETm2VdwGYRBf4QXQds/3dtET/w8vUmPpoDVZc2v8KHr9OKXgmxcPj5I5D/HY8D 3RmroYF+ouDDu2Wf9HJqk2PNJTYZ3cl5TnQMB9EvaNfBrn57uIyw9ZiwF6WZ4P3C9YHr Hrxw== 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=Gv6x0VpkNH1KBubo4tbm9ETrzBqqoMdr5YdMKsMLhQk=; b=cGZbR+o5BPclY0c1L7xU8EX2STCaJidQKAgVR32RVWL9i11sAc14N+x3syEvHkHh4u CkeiH3rirVLfKNaAOcHBGN6RAho5fJfgjxddDhxjc0WJ8ei3zR0dDgAFK7SMTESNGx2O /z02Ccw7rFdoZQU47SskayMu67LaEb/2Gr4zgC9DSNxFgewvjsJx1uZ64x7jWE8BMSO4 KVPsrDdKxvodB2+PTmiKA2DOq9J3aCWARnaFhAq0+uyhWL/hapV0Jg3oNq1YBurk0bbe H1BWEUUh/g6Ypipl2GQvESOeY73txx/hT5z/zOM+K2bXVwq2mfe6kIkArMMo1mofOb1T 8yqg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=h3We5EGH; 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 mb4si7886181ejb.173.2020.07.13.00.48.17 for ; Mon, 13 Jul 2020 00:48:17 -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=h3We5EGH; 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 S1729478AbgGMHsO (ORCPT ); Mon, 13 Jul 2020 03:48:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50410 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729272AbgGMHrI (ORCPT ); Mon, 13 Jul 2020 03:47:08 -0400 Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 72002C061794 for ; Mon, 13 Jul 2020 00:47:08 -0700 (PDT) Received: by mail-wr1-x443.google.com with SMTP id f2so14622284wrp.7 for ; Mon, 13 Jul 2020 00:47:08 -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=Gv6x0VpkNH1KBubo4tbm9ETrzBqqoMdr5YdMKsMLhQk=; b=h3We5EGHY+d73i7DGq8hIsezjttX0RldsdM2Yb4yPAS1BlvU/qFrpOkgTss/FWe7Dv 6voHcFczh90xSmIleS/eYO89Qg7sqQckZf0piP9gSqthJGj98l171XUTuGnhqBSgqYe/ N0iIhOrIkGDgxsZ5WgdCPONgiy1JoTVuFbge9QHmmiQsZmdnIDImXhCVAQChL8amLvYl PjnFBKVTWWPb1mMYh7td9UhT3Pp2CWWmbob+cMNtvMysWZsFw9jyxx07ycfj8ah31Vfv 2biKDBl+wvt/VDSse3BwCum18kWXqe8YNxXwfnkPHOipZYnidqr8RVSvfDh777Swxlr6 RxZA== 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=Gv6x0VpkNH1KBubo4tbm9ETrzBqqoMdr5YdMKsMLhQk=; b=S60Miu7gEqF5IdpAepaQ7nh43O3s7xCXw71J6RGl0uQ9tYTRNrkcPm3VJo3mwH9ALN Fy0n4AQp83zT+mrxIKNUCV9fb2OsFGv+OSY5iP3jhwxR/CY8bkZLdUPZu5pl74DJmW0e 25Us7X3ZUHw0z1qIX3djcuuTaN2Z1m9otbn0yJmahl1Fu6YgBIEY9qDtCJjwz493Wt+4 dbuLbqiw4oHZMEZ3GmDC7jeLZN9K1B+gAFNJODTlaxbakNfO462XjAq/P0rB6bKSi1eQ 46akCoPYpj19HjoIgoqHn+acs8wytzvASY/S3gIG8O05ZiJnvgpBwOeStFE8Z8f3wyxa ynmA== X-Gm-Message-State: AOAM530GTQiPCywrVex6MWzT33mPZijI40ZlCd6OAncnWAc47m6WPawa u6V27hgW2EF7Lqkj27mVqlraZw== X-Received: by 2002:a5d:664e:: with SMTP id f14mr78871515wrw.6.1594626427249; Mon, 13 Jul 2020 00:47:07 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:06 -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 , "Daniel M. Eischen" , Doug Ledford Subject: [PATCH v2 18/29] scsi: aic7xxx: aic7xxx_osm: Remove unused variable 'tinfo' Date: Mon, 13 Jul 2020 08:46:34 +0100 Message-Id: <20200713074645.126138-19-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Looks like none of the artifact from ahc_fetch_transinfo() are used anymore. Fixes the following W=1 kernel build warning(s): drivers/scsi/aic7xxx/aic7xxx_osm.c: In function ‘ahc_linux_target_alloc’: drivers/scsi/aic7xxx/aic7xxx_osm.c:567:30: warning: variable ‘tinfo’ set but not used [-Wunused-but-set-variable] 567 | struct ahc_initiator_tinfo *tinfo; | ^~~~~ Cc: Hannes Reinecke Cc: "Daniel M. Eischen" Cc: Doug Ledford Signed-off-by: Lee Jones --- drivers/scsi/aic7xxx/aic7xxx_osm.c | 5 ----- 1 file changed, 5 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/aic7xxx/aic7xxx_osm.c b/drivers/scsi/aic7xxx/aic7xxx_osm.c index 2edfa0594f183..32bfe20d79cc1 100644 --- a/drivers/scsi/aic7xxx/aic7xxx_osm.c +++ b/drivers/scsi/aic7xxx/aic7xxx_osm.c @@ -564,8 +564,6 @@ ahc_linux_target_alloc(struct scsi_target *starget) struct scsi_target **ahc_targp = ahc_linux_target_in_softc(starget); unsigned short scsirate; struct ahc_devinfo devinfo; - struct ahc_initiator_tinfo *tinfo; - struct ahc_tmode_tstate *tstate; char channel = starget->channel + 'A'; unsigned int our_id = ahc->our_id; unsigned int target_offset; @@ -612,9 +610,6 @@ ahc_linux_target_alloc(struct scsi_target *starget) spi_max_offset(starget) = 0; spi_min_period(starget) = ahc_find_period(ahc, scsirate, maxsync); - - tinfo = ahc_fetch_transinfo(ahc, channel, ahc->our_id, - starget->id, &tstate); } ahc_compile_devinfo(&devinfo, our_id, starget->id, CAM_LUN_WILDCARD, channel, From patchwork Mon Jul 13 07:46:35 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235322 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611296ilg; Mon, 13 Jul 2020 00:48:13 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxb30QUGOae868qsj7lzkyGHduPMjZjLkG8YScW+bEVnIGAroUqvusUrIMdZCPaOwIz5hRd X-Received: by 2002:a17:906:a84d:: with SMTP id dx13mr64372582ejb.246.1594626493393; Mon, 13 Jul 2020 00:48:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626493; cv=none; d=google.com; s=arc-20160816; b=a7nQa2bFshgsG+h+zSNjdDjVpNiPxkXdaNMy4fzQ9vJwTwSrJITHaPTHFD8WvE98Lk 4de+BHuUDlOu8vPc5aMLf4l1FFMLaekqEuPsDqvEMnRKTDZFxRXBhEr25pCLR4EMZOt2 BBSrMjmSqS1stj/EptDJGRDWCik0YX8pHsnRe+/oKN92WtkvGH4qUS9vXgYus15VZEwy dD/ofj2XBZDpruWTMhHSxaVgPqBTjCqxnVCbBFVMMIobquBa5tPTLOYXrvJf2NQ66ve0 GxTpfe9/kZOKjjqAfg+DcAB4QVihmcCLZgqG2ulzsfBGdqkbTASKxv7JMJbeC+N4NTsI Tqhg== 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=Sy/K8f8HsXXHV/Uh8PtUz+jEUwEZnfQCudyYCgnVPrY=; b=M+ymtpAtLEpghsxOFGV6XVnDD9qaJcJj0N+2IqcTQqD2swamuIIg3ehYGNVJRDSBEe IDdiLe3MPRUVAfLkPwPaKHa7CSbQpNy8GqkjhjudBr16BXMI4LZXicz8h6FE/77Dkk75 is2mmmcT2ERz1qkyCqZEc7OTdLkFTa4BegyceSuPboAbgai15btjIhb1VR9bOQSg6kRX Ti0TRVI81kh68vM9nWOskURuXTuJWj9zWEsP45ll7TKwiKoL8joNEsS+fpFTWdqnFGIV HyJPRiWZQpSNjSNWQ7s0ddbIRL5nrWNz/KFy0aWC1D5EgN4wYdZm+nU7aMavz0FTr3wi B1fQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=kt6jQe7U; 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 g8si8517693ejs.512.2020.07.13.00.48.13 for ; Mon, 13 Jul 2020 00:48:13 -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=kt6jQe7U; 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 S1729331AbgGMHsJ (ORCPT ); Mon, 13 Jul 2020 03:48:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50416 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729279AbgGMHrJ (ORCPT ); Mon, 13 Jul 2020 03:47:09 -0400 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 76C4FC08C5DB for ; Mon, 13 Jul 2020 00:47:09 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id o11so14696444wrv.9 for ; Mon, 13 Jul 2020 00:47:09 -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=Sy/K8f8HsXXHV/Uh8PtUz+jEUwEZnfQCudyYCgnVPrY=; b=kt6jQe7UWHbiVRqqHAaPcHsfaVUEXSIAcl/9X9mskmqMpLpuREDcN7aUNNwfe7SHm4 G5Vi3tz3xcp2BtKvJ4qP5zBWiKA17OHpjW1AnQISAYP+lbm0isTG48B4QqG3RNz9bDsW ZXpKQkU9qVkOQRqTppnAx+oa+jj/Djxk9+LbNn0pb6Q7Ia47s7JRMV8CIpEDn6UyL45R +vJZ5hgQlbbw2TTVWL0fdg9FojpzLGyY0J5LrgyU4TRhACyrGjMHERkR3T/3s4xDICCK PLmfvl+a9vHtgJX+16ASFKwI9Eaa6zFMQ2zOtQIffq+/Yh7EUqu3xQUgQzlvccHx9EIj ccxg== 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=Sy/K8f8HsXXHV/Uh8PtUz+jEUwEZnfQCudyYCgnVPrY=; b=SH1ROFUhcNzlg9X8wNbt/rW+X/h9vEsr4ZwOLXgDtUzS/R4XkmH3LqW6TNMgBoIx+N CaiUSY4RJJVk6HfVcB0tGyxgwlIg/Tv7/88ZCX2FQZykaJb0BKzKN5YOP68NbPX95He0 jUebQ+3rnJrMsYCkGf9BUBpsxFgYOZ6IeYXmxO83WLGhrRCwujxyjTMFWX9GW/rD2XMF FLu4VnUb2agbl1B6ydGx50CuVaWEVZCkkEzq33xuVSNhvlRhRs4oYUTqL2asWJwYDNv4 RLhRLeH4w1yfkdGeQxGGWYxZIpX0Pi/aAF4uEIiRxYcLBEjt536OuOtdEiA8jSkMhkau c9pA== X-Gm-Message-State: AOAM530a+4eVFucClPyZjhXRfdEMdD5U9sDPQhbvLDqKSqY2sD+wnLTs Gs+qykQ7LDMrsH5ApEIE821EAg== X-Received: by 2002:adf:9286:: with SMTP id 6mr78950566wrn.361.1594626428201; Mon, 13 Jul 2020 00:47:08 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:07 -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 , "Daniel M. Eischen" , Doug Ledford Subject: [PATCH v2 19/29] scsi: aic7xxx: aic7xxx_osm: Remove unused variable 'ahc' Date: Mon, 13 Jul 2020 08:46:35 +0100 Message-Id: <20200713074645.126138-20-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Looks as though 'ahc' hasn't been used since 2005. Fixes the following W=1 kernel build warning(s): drivers/scsi/aic7xxx/aic7xxx_osm.c: In function ‘ahc_linux_slave_configure’: drivers/scsi/aic7xxx/aic7xxx_osm.c:674:20: warning: variable ‘ahc’ set but not used [-Wunused-but-set-variable] 674 | struct ahc_softc *ahc; | ^~~ Cc: Hannes Reinecke Cc: "Daniel M. Eischen" Cc: Doug Ledford Signed-off-by: Lee Jones --- drivers/scsi/aic7xxx/aic7xxx_osm.c | 4 ---- 1 file changed, 4 deletions(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/aic7xxx/aic7xxx_osm.c b/drivers/scsi/aic7xxx/aic7xxx_osm.c index 32bfe20d79cc1..cc4c7b1781466 100644 --- a/drivers/scsi/aic7xxx/aic7xxx_osm.c +++ b/drivers/scsi/aic7xxx/aic7xxx_osm.c @@ -666,10 +666,6 @@ ahc_linux_slave_alloc(struct scsi_device *sdev) static int ahc_linux_slave_configure(struct scsi_device *sdev) { - struct ahc_softc *ahc; - - ahc = *((struct ahc_softc **)sdev->host->hostdata); - if (bootverbose) sdev_printk(KERN_INFO, sdev, "Slave Configure\n"); From patchwork Mon Jul 13 07:46:36 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235320 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611191ilg; Mon, 13 Jul 2020 00:48:01 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyXWnpcOFCKjjeZMSV/T2y4avFLUJdv2YXIoibZ/zzhbpN9BKWg5jlCRqwIFKGzgaGwMMLD X-Received: by 2002:a05:6402:1a42:: with SMTP id bf2mr80802054edb.292.1594626481766; Mon, 13 Jul 2020 00:48:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626481; cv=none; d=google.com; s=arc-20160816; b=Gl83bhLK2RLTnav5BsEYy2264Yu30YZEb52psx/VWw8MO0a8z3VNY4v+jtKrpzJps1 hp1UgJNCxNzx5t/ZFqDFTpE9543x8k5L9qoSWGIZCyBoD6+xGboQZvjM/q5LxMpqwOmL WqhSOYKdGBeYNdg/FPFqd+bkfBdgJtN+4bjlQeeqIpjHAwOHEG/r92B70tzPWpPaYukk NYo93X+vQOisC4yjZXhZHbEUhUzx6NGATssejJQTUAEhERnFF36BXIeyg00kFN6qrl7A 1m9dcrbptR5hpnirO7i3Vu2qS87aw5LH7YPo/JyOdEMrZwemJGqoBSPcdA+Bj1W6xc5K kkeg== 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=cqbTOjU/FsSc/cHhe4oGvv9xN2ZDzn7IWu0NGLngM90=; b=IE6mCnHeCLPd0sc8LtZjdWOsJwKzH4m/lpn1679MCxPlDOzS2cfqbzgFU7hJ9z0LAp hk6pa9X/j4BgpccqBBcmcoblLXkTAGZ1JMWWOyR53ifGVhrjIEXdrb3IkXHHauDwvYv9 uat9YZ0QNM5HM31lt4vaZIASfg5OiN5vd9CBddAbijoD6LGlrhck2u0NbDDkRHgzOSGe vGYOQArkC25Y89MzzMv0Vt4NqafHtiMbxQQBZyY8i4bPdkoUhfKbKnfk+aKbA1hytg/M leh3TNM9zBDWEYAiDn9mHbvaWfFG33EU3N3QUBjbEJXjQdzszpnDWPspib0BJcyk+Aik Kyew== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=E9Nk6MmL; 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 e13si8452918ejx.153.2020.07.13.00.48.01 for ; Mon, 13 Jul 2020 00:48:01 -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=E9Nk6MmL; 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 S1729330AbgGMHrL (ORCPT ); Mon, 13 Jul 2020 03:47:11 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50422 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729308AbgGMHrK (ORCPT ); Mon, 13 Jul 2020 03:47:10 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 87ADDC061794 for ; Mon, 13 Jul 2020 00:47:10 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id q15so12318430wmj.2 for ; Mon, 13 Jul 2020 00:47:10 -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=cqbTOjU/FsSc/cHhe4oGvv9xN2ZDzn7IWu0NGLngM90=; b=E9Nk6MmLMhgrZz8qU9tuzg3glTjGkXnr/niB1TyY/fTrlnVs71sCgumacmSdGvGHkm ZA777PveMNU+wJKYfcxon91UkP+MxOFi15Tmgk8LvwGpo88LSBr9Zm/uwWWAAkAkc9K4 1o8NeNKYjt+dRhvC2ui+sXHgTgE9LRDoGvNZB8IG4S+7BCNocIhR0xJLeni+TDiAgpj+ I7rxuvHk3DcJSxLSDFT8lJ8qo0EVLaHRBFWkWAhDYtQmFp8euody7NnsN1D9liTfun4R QLdZxrsCDvyqeZhnRSuRNDiz1W+zDuZPnJYgBQDOkQuW9aILooI9eB9N9fpCxaSduIYv TUXw== 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=cqbTOjU/FsSc/cHhe4oGvv9xN2ZDzn7IWu0NGLngM90=; b=RxGEFIG5I1mE6EyEMW+Gs/seuUqpDcEb6795G2iHoZTXGJixcwEqcjS2DwXwLe1ZRj 5OxIEugtpLFiCub5b3eM18sVidN/A3GG8ImVLMNXjlMJVavSZ6lBXUUXebzoPdaSwCAs RGmNW0oaiQeHQkL2NarUgeDMb/vDYFTbIlbzfmwt7mwuC3dIA3gXbKInflDLbxrffVPc uLqtPYAcueed4dI+2Rl1Hf8DxB53Sf09Mc/wq5vbvEszrGxRrw2Dfvl3HQFAclHL3R/a dIHq7GKk1+a+9pXmC5IxuNFW2n7yUg+UGUB35VdFGyVytzDB6mOMPuFiEydz8W4dX8C4 +L8g== X-Gm-Message-State: AOAM531f6l+rYLQokkVOTs4C4DjnqEXDMgBgFaXiRPHEvFMKXRKRgBda aaF0+s3oh6pdZZqmqJtfjWaihA== X-Received: by 2002:a1c:5646:: with SMTP id k67mr18275780wmb.61.1594626429223; Mon, 13 Jul 2020 00:47:09 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:08 -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 , "Daniel M. Eischen" , Doug Ledford Subject: [PATCH v2 20/29] scsi: aic7xxx: aic7xxx_osm: Remove unused variable 'targ' Date: Mon, 13 Jul 2020 08:46:36 +0100 Message-Id: <20200713074645.126138-21-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Looks like checking the 'targ' was removed in 2005. Fixes the following W=1 kernel build warning(s): drivers/scsi/aic7xxx/aic7xxx_osm.c: In function ‘ahc_send_async’: drivers/scsi/aic7xxx/aic7xxx_osm.c:1604:28: warning: variable ‘targ’ set but not used [-Wunused-but-set-variable] 1604 | struct ahc_linux_target *targ; | ^~~~ Cc: Hannes Reinecke Cc: "Daniel M. Eischen" Cc: Doug Ledford Signed-off-by: Lee Jones --- drivers/scsi/aic7xxx/aic7xxx_osm.c | 2 -- 1 file changed, 2 deletions(-) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/aic7xxx/aic7xxx_osm.c b/drivers/scsi/aic7xxx/aic7xxx_osm.c index cc4c7b1781466..ed437c16de881 100644 --- a/drivers/scsi/aic7xxx/aic7xxx_osm.c +++ b/drivers/scsi/aic7xxx/aic7xxx_osm.c @@ -1592,7 +1592,6 @@ ahc_send_async(struct ahc_softc *ahc, char channel, case AC_TRANSFER_NEG: { struct scsi_target *starget; - struct ahc_linux_target *targ; struct ahc_initiator_tinfo *tinfo; struct ahc_tmode_tstate *tstate; int target_offset; @@ -1626,7 +1625,6 @@ ahc_send_async(struct ahc_softc *ahc, char channel, starget = ahc->platform_data->starget[target_offset]; if (starget == NULL) break; - targ = scsi_transport_target_data(starget); target_ppr_options = (spi_dt(starget) ? MSG_EXT_PPR_DT_REQ : 0) From patchwork Mon Jul 13 07:46:37 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235321 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611199ilg; Mon, 13 Jul 2020 00:48:02 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwb7I6GI36qiNtSpFkag2FMpw5Vo8Y86VgmC3jPXcV7nc8Zru3Uf2WnUCVT2oD9oQR3dQM2 X-Received: by 2002:a17:906:1688:: with SMTP id s8mr63209738ejd.164.1594626482352; Mon, 13 Jul 2020 00:48:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626482; cv=none; d=google.com; s=arc-20160816; b=t3vxwpw87LIrHakuyz4FgrMhuDddV1Q9pwIyR2KdNXbhiwCdxf/DYCBGA3bGLlOT1P 6FKeON41zNJvtDi05YVPF4qvDCRXE21q0vIBl9377CvAWNDTazweVWMayOlmP3Cs6flr hMR1eBSKW//cLRLvmIa/20iAOR2uBMCvYM33WAfACWA+DvYPJ51XoouZLa1zsz++x9PN C8eWFPIzl/iGyDRHlO5pKroaC3ErK1VITzim20HGzm3VKdJIogtN7hrkIdCeXgBusXVW OHRK65RgBdJyx0v4i/ZdVCWII0qh8+q8h2KQqq7J+lKKv2LHLlNmKrMUpBXs0/fzal1G f1Rg== 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=KFOnaZnxegDwLsJeWEMPqv4RGP3pzEUK9a4hgTT6mu8=; b=FyBj62ckuErnieL47fWYby5Q+46yiqUV0ydBH5CkeAwgroTemzZf2wDPpuPpg2K0EU 8Yw/BTiShL+Qzwgdh7A9G4k++0KmXJ99Ksbk2Xh+j0Ba78QqF9G4b/B+zpn+ZbJvUyru EuiVzyqGu4q6fxctl3YKj3UV/RGB+AVRj8ayU8Efytad/BpbEKWn81Zcx/ZPNABihd/3 vEOHY93r/pwQt4up6vuksT8vu+noRnpTI5KpTqWxls6X1/1+f8TTiTM8WSGBC4ooTw6b QBw/rhLarjxNF0Qbf6SqFqOyp+iynb/g8LEOynjpWgheWP9aNWAzWWLhJOQ2xZFNO95h 16Xg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=OY9mL1RC; 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 e13si8452918ejx.153.2020.07.13.00.48.02 for ; Mon, 13 Jul 2020 00:48:02 -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=OY9mL1RC; 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 S1729360AbgGMHsB (ORCPT ); Mon, 13 Jul 2020 03:48:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50430 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729334AbgGMHrL (ORCPT ); Mon, 13 Jul 2020 03:47:11 -0400 Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8A0A8C061794 for ; Mon, 13 Jul 2020 00:47:11 -0700 (PDT) Received: by mail-wm1-x342.google.com with SMTP id q15so12318464wmj.2 for ; Mon, 13 Jul 2020 00:47:11 -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=KFOnaZnxegDwLsJeWEMPqv4RGP3pzEUK9a4hgTT6mu8=; b=OY9mL1RCUfiNwlK7Y8LLoK+AzG927nw81f3Z4PqcWbGl3vSJOucO49vTdu8eGhYXAl w11NKIhj/+05DjP3pU/AWZq9hcBlj2iLJ0iSTbqGhdUktM+Vj1xLk5a3PvFeb1nwhDCl fsrQXk2S0T4I5s9VtOZsPAP926q3LKfnEbI1jnv3qx8AVtlmWgClMnsXa+/JfBUrMgco pkjIqv4DSe/jwVUWdO/svjzb7A4Np+nDuFcikxV3+5oFt+aQ7YIuPvKX6L9WBu3aSwhD uYjuLCzI6U3kEKHCIkcMiSYiCw9rJ/c7tswAPwBOLDa7XRCAjFF3qbOzeTZtoENoe30S g+MA== 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=KFOnaZnxegDwLsJeWEMPqv4RGP3pzEUK9a4hgTT6mu8=; b=r7xP3XxAoT3vreeuakeOhuJpVzI9XtjML0HT4505MguZXnSOKDa9Rc1ja2MjxIRiuW voAVaSmdAJ6DuKaMtvbxZK+j3HnXV1kpukr2OcEJozmD88ep/G0IvQHrVXuaxFXz7mSt HXiYzHIGFigbkMO2AGe5QJkIus1Nz5/h2RLePSK1Z/DB/Sh5g93IzFiPhZ4zQE5fzgN5 7wpzowvMiSE5gaQE89Dkiwbn1r3Wcb8+HdIkZQgJDqrxReRbgwm9/q14mZRA1i7yRYP6 HOaYVQVjlyqr74+0gye1C9g9NY15Q6T6qzhsmEeXdbVqMrcCGHz8jWYXcxe9DCBivYds hwEQ== X-Gm-Message-State: AOAM533ylavyIvWeIqBenZlppNgDQ05r3hJCbOZL28VMgTAW8NSc9c2n B/iy3jY49mwZ0Y1aZHrT2x0BCw== X-Received: by 2002:a7b:c013:: with SMTP id c19mr17249605wmb.158.1594626430342; Mon, 13 Jul 2020 00:47:10 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:09 -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 , "Daniel M. Eischen" , Doug Ledford Subject: [PATCH v2 21/29] scsi: aic7xxx: aic7xxx_osm: Fix 'amount_xferred' set but not used issue Date: Mon, 13 Jul 2020 08:46:37 +0100 Message-Id: <20200713074645.126138-22-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 'amount_xferred' is used, but only in certain circumstances. Place the same stipulations on the defining/allocating of 'amount_xferred' as is placed when using it. We've been careful not to change any of the ordering semantics here. Fixes the following W=1 kernel build warning(s): drivers/scsi/aic7xxx/aic7xxx_osm.c: In function ‘ahc_done’: drivers/scsi/aic7xxx/aic7xxx_osm.c:1725:12: warning: variable ‘amount_xferred’ set but not used [-Wunused-but-set-variable] 1725 | uint32_t amount_xferred; | ^~~~~~~~~~~~~~ Cc: Hannes Reinecke Cc: "Daniel M. Eischen" Cc: Doug Ledford Signed-off-by: Lee Jones --- drivers/scsi/aic7xxx/aic7xxx_osm.c | 2 ++ 1 file changed, 2 insertions(+) -- 2.25.1 Reviewed-by: Hannes Reinecke diff --git a/drivers/scsi/aic7xxx/aic7xxx_osm.c b/drivers/scsi/aic7xxx/aic7xxx_osm.c index ed437c16de881..e7ccb8b80fc19 100644 --- a/drivers/scsi/aic7xxx/aic7xxx_osm.c +++ b/drivers/scsi/aic7xxx/aic7xxx_osm.c @@ -1711,10 +1711,12 @@ ahc_done(struct ahc_softc *ahc, struct scb *scb) */ cmd->sense_buffer[0] = 0; if (ahc_get_transaction_status(scb) == CAM_REQ_INPROG) { +#ifdef AHC_REPORT_UNDERFLOWS uint32_t amount_xferred; amount_xferred = ahc_get_transfer_length(scb) - ahc_get_residual(scb); +#endif if ((scb->flags & SCB_TRANSMISSION_ERROR) != 0) { #ifdef AHC_DEBUG if ((ahc_debug & AHC_SHOW_MISC) != 0) { From patchwork Mon Jul 13 07:46:38 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235318 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611133ilg; Mon, 13 Jul 2020 00:47:56 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxYbBJRyN1NmURBjbPxxNyjGcZu/Kz2x8MckyvdYQFMiWeuBJj0iH+Lp2EEZ9Q1xtlELT8/ X-Received: by 2002:a17:906:7d90:: with SMTP id v16mr45984699ejo.27.1594626476492; Mon, 13 Jul 2020 00:47:56 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626476; cv=none; d=google.com; s=arc-20160816; b=gQzFo1UUMK6OvG5Gqv3t4zZ9n0P9RP3jJHNdug6+mDWjI87ev6MnWH9KrutoL50QG8 MYa0Cb8jPn1IjOklsmn7bnxEgQS3MbM+NsQllv8t8QtCq2h200DeHGH/uXaKrchfP8rs RpKnW3ZuoNA3YSljBtVJcqGV/XKUhTy7LzKYmCUolKIsAZH86F2kwRdi0TUeF97xvnU2 9KL5dM75Ttom/rWimsN77SGrzpjKf+LtHDMiYjc5Kj3TJONsMyEV6t/iHWpoBgUvWUAc Gzbd5ioaVRMWvUp5ElH6BPe4P2mT4XYENotDHoHWJzSxRU3tv+oYm0ponCUwwPKY/K8H s8SQ== 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=Hh5XWPq04WZIcyTw2TRmdhHW7NgKe3Z7t0gHGNMmsgU=; b=rExbvVNyZEyQjiCicVqEX/kxQNl9aLgWFRQtNw6sg2YJAfpYv+cwh46aSHnDzneh+B lrLi4o8b7Xg7RnOz/HD0YT8D7rtZEo91YPPV7i/rdIHWZ2rPUV7W2i/HMo/YkWApOAmS BLtxvy8KnsTFde+450F0oRodAJEPx+ZfoKuv7H9e/t3LJMDKEd3TB8q7JaDAv5Gbcr99 29QioI5jjJ+aVjutl6azadUNreUzFS0tRWIzaW0AV3cN4vq7wwQwAB86yT1LFuzrfIam tXiIhlZXGWI8ogwGx2EX34JZneTIdAjS7JDwWZlRohmAiL4RxrA1cAyHffk4hdEXO03c YNqw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=RKFBANQv; 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 g6si9020975edk.604.2020.07.13.00.47.56 for ; Mon, 13 Jul 2020 00:47:56 -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=RKFBANQv; 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 S1729370AbgGMHrO (ORCPT ); Mon, 13 Jul 2020 03:47:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50436 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729351AbgGMHrM (ORCPT ); Mon, 13 Jul 2020 03:47:12 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 94A30C061794 for ; Mon, 13 Jul 2020 00:47:12 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id g75so12302140wme.5 for ; Mon, 13 Jul 2020 00:47:12 -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=Hh5XWPq04WZIcyTw2TRmdhHW7NgKe3Z7t0gHGNMmsgU=; b=RKFBANQvoTjQ/t+AHxR5P3h6u+vmKHBdNnULJmvs5kpn7o9j1EQGTYCQmhuwavoGbw JhByLFw8T+odavhbCVMR1O/9QwvWn085I0wZCafa8scqcQbGup4CvCsM3eje/Cei2GuR QaNAMtbY4Se/Dhr4ohtzDm5rklNtqKEFpjhzaupSGkGLhoWjBLSx0Ubbm3k7ChJy39bJ C6Ux8Skgy5q7od4v0lfpAiSwac8iTowa50exTc0pNrN8k07WErMGnMB+HIkK+8grJ3Cb TGmCgIRsq5qxwKShLHZGdhRdNoeThgLtl2aBns5hkwsxPcDsIqBLW+hXoy2fVhsAePEE R0Wg== 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=Hh5XWPq04WZIcyTw2TRmdhHW7NgKe3Z7t0gHGNMmsgU=; b=Q5Jyraxnwmay3CO+wLhMQGCPQcQACrS1yVrWETOfClloAuHzDjdQX7YiYcSUBXhWsI +QrX740BrGuoosSdqjAOWdfNyCqaI1F08Ncq50R9C8dCANVNkY46FjjFmSsUjlQ/DPO8 RpJXH3S3yD4+zNs19HUPTk9S7hjHi4f+9Jg0kM6iJBNSUCnvM68neiR0icJnFOURNghj nwMi11y8Rpw7s51OBDe9Dwh3XZvw9rEgc8mBKepP0VyuJm3Oc1UVCaNkk053OrIWSkC1 Ww6cYZtLtKZpWPALPlLMG510gb3bplFb2P6S/+9IzjCGZx6oyMQJ3kNvUCFTLAvQAtIO CGIQ== X-Gm-Message-State: AOAM530YTINtpbWodmcYTwGO03vnSMYbZtolw1nflMQT11vjaUIubcCJ wtJOtEsO2JUZRFzRwYMed7c2Ag== X-Received: by 2002:a05:600c:2154:: with SMTP id v20mr18918204wml.185.1594626431357; Mon, 13 Jul 2020 00:47:11 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:10 -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 , QLogic-Storage-Upstream@cavium.com Subject: [PATCH v2 22/29] scsi: qedf: qedf_debugfs: Demote obvious misuse of kerneldoc to standard comment blocks Date: Mon, 13 Jul 2020 08:46:38 +0100 Message-Id: <20200713074645.126138-23-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 No attempt has been made to document any of the demoted functions here. Fixes the following W=1 kernel build warning(s): drivers/scsi/qedf/qedf_debugfs.c:25: warning: Function parameter or member 'qedf' not described in 'qedf_dbg_host_init' drivers/scsi/qedf/qedf_debugfs.c:25: warning: Function parameter or member 'dops' not described in 'qedf_dbg_host_init' drivers/scsi/qedf/qedf_debugfs.c:25: warning: Function parameter or member 'fops' not described in 'qedf_dbg_host_init' drivers/scsi/qedf/qedf_debugfs.c:25: warning: Excess function parameter 'pf' description in 'qedf_dbg_host_init' drivers/scsi/qedf/qedf_debugfs.c:51: warning: Function parameter or member 'qedf_dbg' not described in 'qedf_dbg_host_exit' drivers/scsi/qedf/qedf_debugfs.c:51: warning: Excess function parameter 'pf' description in 'qedf_dbg_host_exit' drivers/scsi/qedf/qedf_debugfs.c:64: warning: Function parameter or member 'drv_name' not described in 'qedf_dbg_init' Cc: QLogic-Storage-Upstream@cavium.com Signed-off-by: Lee Jones --- drivers/scsi/qedf/qedf_debugfs.c | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/qedf/qedf_debugfs.c b/drivers/scsi/qedf/qedf_debugfs.c index b88bed9bb1338..a3ed681c8ce3f 100644 --- a/drivers/scsi/qedf/qedf_debugfs.c +++ b/drivers/scsi/qedf/qedf_debugfs.c @@ -14,10 +14,9 @@ static struct dentry *qedf_dbg_root; -/** +/* * qedf_dbg_host_init - setup the debugfs file for the pf - * @pf: the pf that is starting up - **/ + */ void qedf_dbg_host_init(struct qedf_dbg_ctx *qedf, const struct qedf_debugfs_ops *dops, @@ -42,10 +41,9 @@ qedf_dbg_host_init(struct qedf_dbg_ctx *qedf, } } -/** +/* * qedf_dbg_host_exit - clear out the pf's debugfs entries - * @pf: the pf that is stopping - **/ + */ void qedf_dbg_host_exit(struct qedf_dbg_ctx *qedf_dbg) { @@ -56,9 +54,9 @@ qedf_dbg_host_exit(struct qedf_dbg_ctx *qedf_dbg) qedf_dbg->bdf_dentry = NULL; } -/** +/* * qedf_dbg_init - start up debugfs for the driver - **/ + */ void qedf_dbg_init(char *drv_name) { @@ -68,9 +66,9 @@ qedf_dbg_init(char *drv_name) qedf_dbg_root = debugfs_create_dir(drv_name, NULL); } -/** +/* * qedf_dbg_exit - clean out the driver's debugfs entries - **/ + */ void qedf_dbg_exit(void) { From patchwork Mon Jul 13 07:46:39 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235319 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611140ilg; Mon, 13 Jul 2020 00:47:57 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy/p5MzwtpR2hO8eqTI8tcy2fJvOE9D90GsVbghzmfBqN2Bk5Q00yidbFYl54m+QacxVPXH X-Received: by 2002:a17:907:a92:: with SMTP id by18mr76253035ejc.116.1594626476829; Mon, 13 Jul 2020 00:47:56 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626476; cv=none; d=google.com; s=arc-20160816; b=J5Xz+ii4Sj8FMMmLIY4RawfsVRZa8zU9f4bprlRIAya3Bf1IX1AUIxKrAsA9vC2FTe iaUCmRFG5mV6SxEcnrElXykbINToHQGMTawAN0eWRYk5zvRu7QAdEKqbN23uSwXd0u6J qyLRXpioy5ZBoHxetp3W2waNWelm23b8wFP8BhSKqo7pCWCCYTEZSk/ap0mAiuWIEM+7 XHWxBAJbKtYzwVIZlSHDDx6jhILr4r8kZaYvDLW3rN31HTpbpDRoLyDjy46n2J6BWhbo YqVs3ZerHM/lZUjqGKuoLzl5B/VqVz3Bxv8c0NM+7AqL/cm7tITrJOFLI3QWJt+bXOu6 cBcg== 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=EfL+TnTwzrxBs3OWsbVJ1u2HNp81yr5D58y8jJwfHCg=; b=yG++OIp1D/fjT4y5FDdN6kOqxOTB5QwN9rLE/1l6TRc2/LKCrDLVo0EC4t6uwYbqA4 C+aGJuptV4JXmsCIw/fHtVc31LarpkxieITA2RB0rQtYbt4h6THBPc9YZ411zbpZVSTT O+u9Fe30xAD77fhNoaH/ywr12QVY78nXuApKRjrz928IrEmPJqdOOaKSArrT0kIiH2r7 LFG/8yBDcOAEnW3YJ2uNzHnETtnst4ZpZDFLbpMGAku3CNbQdddnKwEVzoofXnHJBn8p z14jLuXYMXAsEth4RQI3RhkYsricKKeAa8Rac77aBntxrA3LZ1LE9EiMdfYQWFKJQ7XV Mdfg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=ZOCsw2XW; 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 g6si9020975edk.604.2020.07.13.00.47.56 for ; Mon, 13 Jul 2020 00:47:56 -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=ZOCsw2XW; 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 S1729551AbgGMHrz (ORCPT ); Mon, 13 Jul 2020 03:47:55 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50444 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729362AbgGMHrN (ORCPT ); Mon, 13 Jul 2020 03:47:13 -0400 Received: from mail-wr1-x441.google.com (mail-wr1-x441.google.com [IPv6:2a00:1450:4864:20::441]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A7C90C061794 for ; Mon, 13 Jul 2020 00:47:13 -0700 (PDT) Received: by mail-wr1-x441.google.com with SMTP id q5so14683179wru.6 for ; Mon, 13 Jul 2020 00:47:13 -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=EfL+TnTwzrxBs3OWsbVJ1u2HNp81yr5D58y8jJwfHCg=; b=ZOCsw2XWfgZO4y6t3h7ZC4fRzobOluE5SfyhEp/78OJ3fXCO64cAZWdxAucxuNmb8d fQW1CEkSz0QItDOS515LTb7R10RH5gaLIez9jQ60GhEhBXW75cH8UOkkfTpZzMHQsNs/ RsCokTrSJg8XynI4R7kPRHqJgYWSukBRZIL2j5BdduQsq7UTNT/j4YCXvoRgj//aiyYU PtN6YMRIcQbXrv/HevL1q/V6DowQRP9qgKgSoXe4Va6L19t03EFjv0n4f+tzAZ92MBqk einUA1+6MQrrFUIZFRJiBhnhmdHoyPxXMqHdves3qtlqtb39O/pkYMGFAH+bp8Fw/IZK KK3A== 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=EfL+TnTwzrxBs3OWsbVJ1u2HNp81yr5D58y8jJwfHCg=; b=EHB4ZMzGBO9POEWbOGOgIEm/nqB81jcSVKpusUWL8st4dRJ6gEG8FFNXwAdpQLYoS/ YCq1pqDxHyuOf/85qNu9JTFohANU9Ti9OooEdmoOSmaaDwTt0/RwklFOYBHFFxMf+5Wp E78Z5SfyeTjZs7iSFtoSn6kUnBTph3GtJJnzYxGMt36GhjeNH+/zquKsPpqnhn8xdxg3 hrnk/qdyE4wIgpJy/WQLIb1xP3i0U3E9gQv2xdcowUehOKhex/sd+ApjGz8DQ+6dn2nz cVmmL11Zy3DGEZlGIEJgkyIgD+AvAYY8oMhasFnL4LAK2V7LI1rLozdsjl3G1c3LGPxS IEOg== X-Gm-Message-State: AOAM531WkpSJCoadftkvBEndj4jzUStz/kYy539QM39vmuVodoM99XPK T6G+6kcKwpnOyrAiXkWkIOkXjA== X-Received: by 2002:adf:a111:: with SMTP id o17mr77436675wro.257.1594626432329; Mon, 13 Jul 2020 00:47:12 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:11 -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 , Adaptec OEM Raid Solutions , "PMC-Sierra, Inc" Subject: [PATCH v2 23/29] scsi: aacraid: linit: Provide suggested curly braces around empty body of if() Date: Mon, 13 Jul 2020 08:46:39 +0100 Message-Id: <20200713074645.126138-24-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Fixes the following W=1 kernel build warning(s): drivers/scsi/aacraid/linit.c: In function ‘aac_biosparm’: drivers/scsi/aacraid/linit.c:368:41: warning: suggest braces around empty body in an ‘if’ statement [-Wempty-body] 368 | param->heads, param->sectors, num)); | ^ Cc: Adaptec OEM Raid Solutions Cc: "PMC-Sierra, Inc" Signed-off-by: Lee Jones --- drivers/scsi/aacraid/linit.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/scsi/aacraid/linit.c b/drivers/scsi/aacraid/linit.c index a308e86a97f19..734dd6e67246d 100644 --- a/drivers/scsi/aacraid/linit.c +++ b/drivers/scsi/aacraid/linit.c @@ -363,9 +363,10 @@ static int aac_biosparm(struct scsi_device *sdev, struct block_device *bdev, param->cylinders = cap_to_cyls(capacity, param->heads * param->sectors); if (num < 4 && end_sec == param->sectors) { - if (param->cylinders != saved_cylinders) + if (param->cylinders != saved_cylinders) { dprintk((KERN_DEBUG "Adopting geometry: heads=%d, sectors=%d from partition table %d.\n", param->heads, param->sectors, num)); + } } else if (end_head > 0 || end_sec > 0) { dprintk((KERN_DEBUG "Strange geometry: heads=%d, sectors=%d in partition table %d.\n", end_head + 1, end_sec, num)); From patchwork Mon Jul 13 07:46:40 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235316 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611096ilg; Mon, 13 Jul 2020 00:47:50 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwTByWV5d29DCyXzLY+bndQmeAPmOWUN0dkdG7kTmqEGMg9iPeuVdTx1qEQ0bKt/wULV42k X-Received: by 2002:a17:906:31c8:: with SMTP id f8mr60176749ejf.269.1594626470789; Mon, 13 Jul 2020 00:47:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626470; cv=none; d=google.com; s=arc-20160816; b=vTPIN20tcBbYRHDWzttuDHwIWZVqxZkcuIRsknSTqqWHW8VvKGpAbEd7JMZLDBhVMS 4ea/deB5WmHjEg752b6PW7/4s0+8hHYyoWbdXsxbAgp/4etATVfAQQtE7yX7vtPx1QGw oBfAKh+rSVj3P0oMYGnXmmZ+L5aKrU4KwSJewHGrsV5XaZJCN0omfwNYYdKRhDmoWB88 hch51pkM0MhJWNY4LDsv7UWTBoEutxckaOigrtXcbRcdVF+xJJMjuQ2TQYeiPrnsrKnQ Q/dOQhkBcQ25a9Ij9+4despGW7jhStVcmaLEOLrxYLJGct6BNVLLGzF3zQ0Hc0ESYKjP oejw== 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=oQ4WvRwPDFUcNrh06O2K9jOUxxfeZulaKjQ0ybDc5os=; b=EP4Di4Z7B9vmp8o7HRaW+rLzaFKKBJkgtoAzEjLWTSA9D00SBqf/+RfzNyuTln5uys f5KvKf6yH3u2aPJBE4K6Nmkp1DB+bx6uqbpDBAOnJrEnmsycyJW9dFxYLV3Dbdos6dEz Ma+J9UZZ4kHO2mnkKTIG0+/WOUwJ5QVQLaRcBN3vWLLJrY1E9oZCD+1AvWDsB5ffqrGV nL9iv+vanMxJegJI8Mu7dO4TWbxE2jwB0AUUnU7c1f+QTiHY3BvYmA7C/G+RA+EB7tAh kUO4SNfZUThrL2S0svtEHsmg5N55/gFf9JrD5IeHifNwuVUgZwXXM04NFmP+sJ1Gidga ZcZw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=bUcu1mtJ; 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 e5si8726926ejb.453.2020.07.13.00.47.50 for ; Mon, 13 Jul 2020 00:47:50 -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=bUcu1mtJ; 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 S1729390AbgGMHrQ (ORCPT ); Mon, 13 Jul 2020 03:47:16 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50448 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729375AbgGMHrP (ORCPT ); Mon, 13 Jul 2020 03:47:15 -0400 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 B725DC061794 for ; Mon, 13 Jul 2020 00:47:14 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id s10so14621526wrw.12 for ; Mon, 13 Jul 2020 00:47:14 -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=oQ4WvRwPDFUcNrh06O2K9jOUxxfeZulaKjQ0ybDc5os=; b=bUcu1mtJaYXv0rh5cEHC/NbY4/26cuQSnsGFXLA/v1BBuA3R1qfK7CaKBSmp+NQQy3 7md3AfU1fH0fr9k4TgyHrvcSh9ygvPY7leVg+ShqTC18ad+y7UCITOUYFtm2PQRp8AZU dhEQNC1q8PBtwArgX7Zd99DCkX75OybT13BC9bwj09cEKuQcIRHwjEGypxBq48DQBLec SaMxU+jhk2QGCyJNwiGMyiQNoFZJEXFp298UMjbXfBGxe2almnz231E8HarbSlo2QFRh pEwX0Z1AFLdFnKqQUxqmStTpHBCLMktPi0IYyXZLjkSJ6lm1oketJhhE/6Dd6fEQJsjq GJJA== 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=oQ4WvRwPDFUcNrh06O2K9jOUxxfeZulaKjQ0ybDc5os=; b=kyEpfeLBiaQ4bw83iq+baVecAmNqGqgXWfTVfraKDlQMZvbKNJz/muIq7hrvonJtGw sx/nSN6LvFvP3QvVcxcZizoLRQF4C0AipBjiB8aNy+Snhlv03ACje782c4hDqi0QGbcV Sms00sDHIiiNpcz0qf9D7/01Q+5LAjts3mgWykyHJH0IarOy7BHMXWDrxJEulhaWBRDE DQd/kW5kT+xPCk5aAbMOlBZP/mDtEqHo4o8RpJI7EPvtg5nZaGIUV2GreQGkePZVWCHK 6/Ks+/Uc2NiqfZOk5R9CcClFYH5wFC7vd07RJXoQrR2tZw5d8Oz9FZZ+k7znNHYq7pla 90LA== X-Gm-Message-State: AOAM532iJ8h0iOEtTVPIKrmc7Ohh2qJFxXjFIdiBvDQy+nJ8G+7I0H82 amH2TUgOugxNOssENcl48UZHCw== X-Received: by 2002:a05:6000:86:: with SMTP id m6mr45539519wrx.173.1594626433513; Mon, 13 Jul 2020 00:47:13 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.12 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:12 -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 , Adaptec OEM Raid Solutions , "PMC-Sierra, Inc" Subject: [PATCH v2 24/29] scsi: aacraid: linit: Fix a couple of small kerneldoc issues Date: Mon, 13 Jul 2020 08:46:40 +0100 Message-Id: <20200713074645.126138-25-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Most likely caused by bitrot (docs not keeping in sync with API). Fixes the following W=1 kernel build warning(s): drivers/scsi/aacraid/linit.c: In function ‘aac_biosparm’: drivers/scsi/aacraid/linit.c:368:41: warning: suggest braces around empty body in an ‘if’ statement [-Wempty-body] drivers/scsi/aacraid/linit.c:243: warning: Function parameter or member 'shost' not described in 'aac_queuecommand' drivers/scsi/aacraid/linit.c:243: warning: Excess function parameter 'done' description in 'aac_queuecommand' drivers/scsi/aacraid/linit.c:1176: warning: Excess function parameter 'inode' description in 'aac_cfg_ioctl' Cc: Adaptec OEM Raid Solutions Cc: "PMC-Sierra, Inc" Signed-off-by: Lee Jones --- drivers/scsi/aacraid/linit.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/aacraid/linit.c b/drivers/scsi/aacraid/linit.c index 734dd6e67246d..f043e378652c1 100644 --- a/drivers/scsi/aacraid/linit.c +++ b/drivers/scsi/aacraid/linit.c @@ -230,8 +230,8 @@ static struct aac_driver_ident aac_drivers[] = { /** * aac_queuecommand - queue a SCSI command + * @shost: Scsi host to queue command on * @cmd: SCSI command to queue - * @done: Function to call on command completion * * Queues a command for execution by the associated Host Adapter. * @@ -1160,7 +1160,6 @@ static int aac_cfg_open(struct inode *inode, struct file *file) /** * aac_cfg_ioctl - AAC configuration request - * @inode: inode of device * @file: file handle * @cmd: ioctl command code * @arg: argument From patchwork Mon Jul 13 07:46:41 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235317 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611121ilg; Mon, 13 Jul 2020 00:47:55 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyhQNqSp5ooGyoapVqlMPBWwsYa2gmUnTO1vWC1CG3iceE5zl9k95nUiHCAF5LiOnD+Rt8D X-Received: by 2002:a05:6402:1d35:: with SMTP id dh21mr86290162edb.186.1594626474929; Mon, 13 Jul 2020 00:47:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626474; cv=none; d=google.com; s=arc-20160816; b=hPJ+i51jvV+bz8rTlzPAOA8XUhHt/GidNsL3bVzjtnVd0iYm9B3Fnsu9ZFgP36Zkh/ /b8FlBZymdM7WrwOhU356BF0T7Y9Gn0Y14lxu99uGDSeQG8DgVJC2fLJOHOym1CVoFVR yZbeWoJJvvPylg8WAiNk/ixHT1Cq2OavgUBfl8yQTOqHjDB1ENmHRVUHjlmR1yRyA3/h ydMQRTv/GyDW1pCIp7gLncRZDfG9GYHFSD6ubO+1QAdNcT26TNKC8jAn6owT8XIkOT0D YTuZKmbVegAZap8E8ul1ITUHvHPfiH4Zz7XvmJpVC8oNieZqk9akrX3lICYdlA+di32X jPCg== 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=ERoz3fkdfBzQNDlM4+cYEX1ahP8otbMKTg0c52YoDQM=; b=rvFgbAx/n9QpuLgF4Cw+2y2lcyfXkhDcvFZp9FNfT6d99zGgK0tDKKRSsSVz99V9XR eSMCxFplekVhImxD7Gy99T17hGaE03OUt9OtBHRquLF14yQ+TanBuNeJVLsifABkZ4Fb lssZH66xPB0U08gdPJzb1r/KDrRWgcftu+xaq8nYhHYUp0Lxac2SULAxnoWD4U8uPcWB JOyH7oezO6aEzqyVJczU4jdsM2WKzjpqBCJ6eBPguovqT3XJPaxhomPca6In01W/0TQa /K6Cpy4m0jMu5V+Eo1SZgPOidMUxwHOc5dmZv4KI6ehSLbcjPsQXkDTBHn+vtc1yzV8b P2kw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=yYUh48KN; 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 c13si8677935edw.351.2020.07.13.00.47.54 for ; Mon, 13 Jul 2020 00:47:54 -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=yYUh48KN; 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 S1729539AbgGMHru (ORCPT ); Mon, 13 Jul 2020 03:47:50 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50456 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729391AbgGMHrQ (ORCPT ); Mon, 13 Jul 2020 03:47:16 -0400 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 CD5A2C061794 for ; Mon, 13 Jul 2020 00:47:15 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id j4so14665295wrp.10 for ; Mon, 13 Jul 2020 00:47:15 -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=ERoz3fkdfBzQNDlM4+cYEX1ahP8otbMKTg0c52YoDQM=; b=yYUh48KN0Zmb3XwIAmWYhxedT6tKiKsH7prVn9xUAC5ez7airPPFOcLdygthJXRRvV I5vpKwHL6zlkGBu+4n7ddEcH6UocXT6wzUb2QbjnP6Jbsb+A+ZVtFe4ICd1zi6jdaHR6 bERwig5lB+KrLPSzAi3zfPFjXVzHNSPbarzwJ/oyKnZwseEGT6qxygnnmUlyttFimk55 /VIrwboCqRRQj6LodED8DN19y2h+fzZT+CiXie518pOrpl8q7jULg9pYHkGkA36MvFIC PuyPl+FfcYRJpRyMut3MtSyvVmvvbnErXmF1/+qW3fohRNTTkyGodjt5mEUhqJtLlrbX t48A== 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=ERoz3fkdfBzQNDlM4+cYEX1ahP8otbMKTg0c52YoDQM=; b=VxVMpwsB51KFLgIFH06RUpSWaS9BxA+I3E96ArJpJ7Ffc+SExdYhBOZHueWBDFLpQ5 UbEg0lS6vZMP3YY+MYDxRZFtvb41V4m3PTuJ8eQNKZgsRr6NzDCyErc35DqOcs6wbjBP DGDixegfA+pZlZlE7I0JA6YZv8rsBkQ4SuDkPus2WAjY4R8P7ABBc/HwywbHrobByOCd Whf8UKP7/FNnuMH9TRfw88uvJXuSlCIc/TXjG0VLMq+zk8ZvZzxQEwTomAzzFOzPBBeE 5qWdzd4V/nyl6xj/rl0wamARn1wMbefF01+LGE4dMDtufRbeAFineApzW3xvEv0LB6Vh Aaqw== X-Gm-Message-State: AOAM530d1idyDAR19AcOOd+ML1SQYOiw/40HcLRsmepwPb6DMf0v0T75 YLlDKcFqEaoRZqNK42U/yCLwAA== X-Received: by 2002:a5d:658a:: with SMTP id q10mr78337337wru.220.1594626434536; Mon, 13 Jul 2020 00:47:14 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:14 -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 , YueHaibing , Luben Tuikov Subject: [PATCH v2 25/29] scsi: aic94xx: aic94xx_init: Demote seemingly unintentional kerneldoc header Date: Mon, 13 Jul 2020 08:46:41 +0100 Message-Id: <20200713074645.126138-26-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 This is the only use of kerneldoc in the sourcefile and no descriptions are provided. Fixes the following W=1 kernel build warning(s): drivers/scsi/aic94xx/aic94xx_init.c:538: warning: Function parameter or member 'asd_ha' not described in 'asd_free_edbs' Cc: YueHaibing Cc: Luben Tuikov Signed-off-by: Lee Jones --- drivers/scsi/aic94xx/aic94xx_init.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.25.1 diff --git a/drivers/scsi/aic94xx/aic94xx_init.c b/drivers/scsi/aic94xx/aic94xx_init.c index bef47f38dd0db..a195bfe9eccc0 100644 --- a/drivers/scsi/aic94xx/aic94xx_init.c +++ b/drivers/scsi/aic94xx/aic94xx_init.c @@ -530,7 +530,7 @@ static int asd_create_ha_caches(struct asd_ha_struct *asd_ha) return 0; } -/** +/* * asd_free_edbs -- free empty data buffers * asd_ha: pointer to host adapter structure */ From patchwork Mon Jul 13 07:46:42 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235315 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611090ilg; Mon, 13 Jul 2020 00:47:50 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwz9nd4DYacDTNPvdOb02OPZ1bgsMaaoXT2kmJzof2Zfh2t7rVT4wjopwESVx9Qk1r2xrBB X-Received: by 2002:a50:a881:: with SMTP id k1mr87625904edc.12.1594626470306; Mon, 13 Jul 2020 00:47:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626470; cv=none; d=google.com; s=arc-20160816; b=UckoL+XjDeo4N7yo5BuNruvanu7P7I/UmR/Vu0pT1YN50isEjHKWXlKnAXyIdFpreH Luczhy7fy66b2Jj7C3l61rp6BQ++BvNGgqY5hTKHLMooIDdHlXgNlidGXSCFSWb3FJPO TcKaB0GnO6JfRF0yqL66IbZZQztMwBybjtFBMAD2GpKouUTWQIHGcUn0EhYXYbAUFrWQ 20E2u6wkxUElShYffjNdyJ1gWpQhVvJnBuwLC6S0s8ZjPEUKdBPk1li2nRvydbT/oFMD 2Lb7YD2oHMLoAEZ7W9zBHgnQdfWCqZ+mjbKBujh6sGKLrXNhgs5/l0OyYaBKNKXxlnTU /eIA== 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=n+FlrssXUyf+27P3zqpNeadQUF1GbyakCHuF+5DpqII=; b=Qj6Yw/gHc0Zk1rkD618Rr4ePLokmOXyTKBXFePO7jQdu3rl4/zsjV9x7uhrD+pGl8k k74iiKiHVWiEEVPX+Vp2igKJxrA+glIhk5DWOiFyFBoZ72+eotkRm99IPHL/loaA9FYu XmohLYANanyMMHNcQJSEFlXQfs4fYotlW/svIfPGd4fwOJTMU3fpsHY6OAVyGyjJ6w7s FxquCB/SNPla5KCBkSRzhytLmSP2jIcl5kc6FpWuYAn4/NK6ke9y3iOgrrqDtXHXVo1M I5z/IVQdQWtkdYPbATygfYUmotG0s71AIjKLPG4k/PGgKqanFZ99Lnxlxqo00EOWZyFW wnNQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=JAI1K0VT; 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 e5si8726926ejb.453.2020.07.13.00.47.50 for ; Mon, 13 Jul 2020 00:47:50 -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=JAI1K0VT; 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 S1729259AbgGMHrq (ORCPT ); Mon, 13 Jul 2020 03:47:46 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50462 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729405AbgGMHrR (ORCPT ); Mon, 13 Jul 2020 03:47:17 -0400 Received: from mail-wr1-x441.google.com (mail-wr1-x441.google.com [IPv6:2a00:1450:4864:20::441]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id EF2F3C061794 for ; Mon, 13 Jul 2020 00:47:16 -0700 (PDT) Received: by mail-wr1-x441.google.com with SMTP id j4so14665429wrp.10 for ; Mon, 13 Jul 2020 00:47:16 -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=n+FlrssXUyf+27P3zqpNeadQUF1GbyakCHuF+5DpqII=; b=JAI1K0VTERudzk6GJ1ZmjdlChl5VoIE7Y7GxSc4kx/Mp7jK189qmRbjTzXPPWyPtBY b2/xN3dpP92Euf1dKwauNt1jek56KN1dDgEcjAFt6koBMEkdeyYYhasSyUc6OiwfhhlU 2aIOjw0mTVor6dH/45+rkWwB8qo9wJg5/u4iyHNZYpuHLXob8gFIULGhEJZmi4EGIb6e WD+71pgeSs+GchHyaqU0D4YKXqq2kWIsgxayA7MGvA65ANYLwCBaMEuEf7R6fvikYQmU DMp1IiEoR9NdwYpw6sR6XLUx6f1i8V4IpWqUtGmEtJqQ+hBr6MD9da6y1PJjRLkwQKUr 1QQQ== 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=n+FlrssXUyf+27P3zqpNeadQUF1GbyakCHuF+5DpqII=; b=mYbAqsQLgNDbDA8ylpe5abpP2XgYRAQWxDP/D9MSF8hLqbpLc7XcmunbU4Rr8HJZAR rVYA4MSbssJO/pqLR8ZWDJ9AhZZuLdYQbU+6Ja2loCQZIEwpSlvGG/ZQckuMKPiF+Iph Khi6E/PcJK3tcKlx0J0Y4FLM8lnCs2nNK/BMZSD56iihRuu+wJWx0xHBZKF74qez1cpq GY1OD4wBx16OeArW8w7Wgu3ws17Ix+IsydEwNZq3qAZqi1p7VJCV04FhY/zRci6eZjsG uJD8+md/BTEhrukzHmq7Izy/+RQNYy4trY6TxiqdjLWXMlk99gqfgN564iEaidB6PxKe poUQ== X-Gm-Message-State: AOAM533PEHV3Ks/2L5SoVzAxM2A/ubZfFNzbIvVSOdnMLkl5D9t1QSam UEJNgB8Fy/1tR8fhAqjwMnKm6A== X-Received: by 2002:a5d:5642:: with SMTP id j2mr78271778wrw.19.1594626435718; Mon, 13 Jul 2020 00:47:15 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:15 -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 , Kumar Santhanam , Sangeetha Gnanasekaran , Nikith Ganigarakoppal , Jack Wang Subject: [PATCH v2 26/29] scsi: pm8001: pm8001_init: Demote obvious misuse of kerneldoc and update others Date: Mon, 13 Jul 2020 08:46:42 +0100 Message-Id: <20200713074645.126138-27-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 More bitrot issues with function documentation not keeping up with API changes. Fixes the following W=1 kernel build warning(s): drivers/scsi/pm8001/pm8001_init.c:64: warning: cannot understand function prototype: 'const struct pm8001_chip_info pm8001_chips[] = ' drivers/scsi/pm8001/pm8001_init.c:86: warning: cannot understand function prototype: 'struct scsi_host_template pm8001_sht = ' drivers/scsi/pm8001/pm8001_init.c:115: warning: cannot understand function prototype: 'struct sas_domain_function_template pm8001_transport_ops = ' drivers/scsi/pm8001/pm8001_init.c:212: warning: Function parameter or member 'irq' not described in 'pm8001_interrupt_handler_msix' drivers/scsi/pm8001/pm8001_init.c:237: warning: Function parameter or member 'irq' not described in 'pm8001_interrupt_handler_intx' drivers/scsi/pm8001/pm8001_init.c:265: warning: Function parameter or member 'ent' not described in 'pm8001_alloc' drivers/scsi/pm8001/pm8001_init.c:624: warning: Function parameter or member 'pm8001_ha' not described in 'pm8001_init_sas_add' drivers/scsi/pm8001/pm8001_init.c:624: warning: Excess function parameter 'chip_info' description in 'pm8001_init_sas_add' drivers/scsi/pm8001/pm8001_init.c:900: warning: Function parameter or member 'pm8001_ha' not described in 'pm8001_setup_msix' drivers/scsi/pm8001/pm8001_init.c:900: warning: Excess function parameter 'chip_info' description in 'pm8001_setup_msix' drivers/scsi/pm8001/pm8001_init.c:900: warning: Excess function parameter 'irq_handler' description in 'pm8001_setup_msix' drivers/scsi/pm8001/pm8001_init.c:981: warning: Function parameter or member 'pm8001_ha' not described in 'pm8001_request_irq' drivers/scsi/pm8001/pm8001_init.c:981: warning: Excess function parameter 'chip_info' description in 'pm8001_request_irq' Cc: Kumar Santhanam Cc: Sangeetha Gnanasekaran Cc: Nikith Ganigarakoppal Signed-off-by: Lee Jones Acked-by: Jack Wang --- drivers/scsi/pm8001/pm8001_init.c | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/pm8001/pm8001_init.c b/drivers/scsi/pm8001/pm8001_init.c index 9e99262a2b9dd..20fa96cbc9d3d 100644 --- a/drivers/scsi/pm8001/pm8001_init.c +++ b/drivers/scsi/pm8001/pm8001_init.c @@ -57,7 +57,7 @@ MODULE_PARM_DESC(link_rate, "Enable link rate.\n" static struct scsi_transport_template *pm8001_stt; -/** +/* * chip info structure to identify chip key functionality as * encryption available/not, no of ports, hw specific function ref */ @@ -80,7 +80,7 @@ LIST_HEAD(hba_list); struct workqueue_struct *pm8001_wq; -/** +/* * The main structure which LLDD must register for scsi core. */ static struct scsi_host_template pm8001_sht = { @@ -109,7 +109,7 @@ static struct scsi_host_template pm8001_sht = { .track_queue_depth = 1, }; -/** +/* * Sas layer call this function to execute specific task. */ static struct sas_domain_function_template pm8001_transport_ops = { @@ -129,9 +129,9 @@ static struct sas_domain_function_template pm8001_transport_ops = { }; /** - *pm8001_phy_init - initiate our adapter phys - *@pm8001_ha: our hba structure. - *@phy_id: phy id. + * pm8001_phy_init - initiate our adapter phys + * @pm8001_ha: our hba structure. + * @phy_id: phy id. */ static void pm8001_phy_init(struct pm8001_hba_info *pm8001_ha, int phy_id) { @@ -155,9 +155,8 @@ static void pm8001_phy_init(struct pm8001_hba_info *pm8001_ha, int phy_id) } /** - *pm8001_free - free hba - *@pm8001_ha: our hba structure. - * + * pm8001_free - free hba + * @pm8001_ha: our hba structure. */ static void pm8001_free(struct pm8001_hba_info *pm8001_ha) { @@ -205,6 +204,7 @@ static void pm8001_tasklet(unsigned long opaque) * pm8001_interrupt_handler_msix - main MSIX interrupt handler. * It obtains the vector number and calls the equivalent bottom * half or services directly. + * @irq: interrupt number * @opaque: the passed outbound queue/vector. Host structure is * retrieved from the same. */ @@ -230,6 +230,7 @@ static irqreturn_t pm8001_interrupt_handler_msix(int irq, void *opaque) /** * pm8001_interrupt_handler_intx - main INTx interrupt handler. + * @irq: interrupt number * @dev_id: sas_ha structure. The HBA is retrieved from sas_has structure. */ @@ -257,8 +258,8 @@ static u32 pm8001_request_irq(struct pm8001_hba_info *pm8001_ha); /** * pm8001_alloc - initiate our hba structure and 6 DMAs area. - * @pm8001_ha:our hba structure. - * + * @pm8001_ha: our hba structure. + * @ent: PCI device ID structure to match on */ static int pm8001_alloc(struct pm8001_hba_info *pm8001_ha, const struct pci_device_id *ent) @@ -615,7 +616,7 @@ static void pm8001_post_sas_ha_init(struct Scsi_Host *shost, /** * pm8001_init_sas_add - initialize sas address - * @chip_info: our ha struct. + * @pm8001_ha: our ha struct. * * Currently we just set the fixed SAS address to our HBA,for manufacture, * it should read from the EEPROM @@ -893,8 +894,7 @@ static int pm8001_configure_phy_settings(struct pm8001_hba_info *pm8001_ha) #ifdef PM8001_USE_MSIX /** * pm8001_setup_msix - enable MSI-X interrupt - * @chip_info: our ha struct. - * @irq_handler: irq_handler + * @pm8001_ha: our ha struct. */ static u32 pm8001_setup_msix(struct pm8001_hba_info *pm8001_ha) { @@ -975,7 +975,7 @@ static u32 pm8001_setup_irq(struct pm8001_hba_info *pm8001_ha) /** * pm8001_request_irq - register interrupt - * @chip_info: our ha struct. + * @pm8001_ha: our ha struct. */ static u32 pm8001_request_irq(struct pm8001_hba_info *pm8001_ha) { From patchwork Mon Jul 13 07:46:43 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235312 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2610825ilg; Mon, 13 Jul 2020 00:47:20 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwDdhCovLSGJmoFdg1s2VYlQAJ/Q/BuB5tKHLPnjZ6XXOSMBfD7Ib7AA1Ukq/dD+A1bxxb8 X-Received: by 2002:a17:906:d8db:: with SMTP id re27mr71229356ejb.554.1594626440449; Mon, 13 Jul 2020 00:47:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626440; cv=none; d=google.com; s=arc-20160816; b=eS7Uo6SJt20Z+Iz22TDsOVLSMwjBIFulIB0Htu6zfZKMNRT2vWmJdSytunkka/nWji xfFgQMzNYaDZaIIN/as+UQxjlsrUZt7KX0pXLeGvI7jXvBvqJSWmV0KEXFfKfLb5PSfD SAelUcUYSTVdaHc9fXChVA9HEmU4hVjP4IJ9TPGmZUBNzK12Lls2Kybbups2WYxbsaDM 9RtYMB0i/ck2eA8fyMfar/VQzDgvMWU4QCWwFZoV6eV/DO0FcmipLDLq2FYocnl+8auQ LfukvAg8hwZ808nqAPlsR8tO0rqPimv5rRlpojNnOUscUER6nLz0stiZzeWydvJEhFMx ruZg== 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=3sXxKpQgrnotRyFJvyRPk0Xs+GRdftij+k/kTivXzV0=; b=hzuaOOJHtx/i94zmutezlnD/HnJ+aJNeNT9izldjhl3gBM02aw2ZWkJXkE+Z8oOZSn lNWhK/mwiUASm0NJmoJsDvQ2YhPk+KxbrIPoAZyJHkSWUQ//APBYJE5OJ3TjGfDmQ+U+ Z5mvwGtqD3ym1iLzK1hurwzdTLX5JsSON9rOSJJynO/lTh3YqnrLDjbxs1FYldVkjcz/ IFZuZcQKqoqt+xVgh4p5KFAace7j6InCDPNb+hOI+gXodcQGgvvus7eaChtxsez9ZzZH lfeFOj9WZHeTSpySOT5FH6RBx7f26rh9DaZh6wtL73vVAGzI7x8z5nxDYp3W38CFHke0 0pHQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="LZAtex/W"; 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 cw13si9205477edb.135.2020.07.13.00.47.20 for ; Mon, 13 Jul 2020 00:47:20 -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="LZAtex/W"; 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 S1729418AbgGMHrT (ORCPT ); Mon, 13 Jul 2020 03:47:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50468 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729408AbgGMHrS (ORCPT ); Mon, 13 Jul 2020 03:47:18 -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 C7640C061755 for ; Mon, 13 Jul 2020 00:47:17 -0700 (PDT) Received: by mail-wr1-x442.google.com with SMTP id a6so14662136wrm.4 for ; Mon, 13 Jul 2020 00:47:17 -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=3sXxKpQgrnotRyFJvyRPk0Xs+GRdftij+k/kTivXzV0=; b=LZAtex/WvZHUpRfBeIZuZKGHFkUEF40F92oWBBEHmfCNjAnSVVxMm34PN6BoS2WVBR KYr1bV+zFda1yL2IObHPGtXWzfFJEGpKUzjdRuvs3HDedNofLTE6NLNjnzxRcOd+Ards wA7tDnCIGATq+LFB7AgoBTKCJ0tsXjcRqLrFmjdYvkXpCT1sLQ7Vpp9gi+pLf2sWWWfG sR39e13edBAyWagxr31HeBUwhCgNqplIi15GyHABbVhdMFjB7/TBZAzAn1rPM7pP82hL UVraZPM3LCSfFxR+7TY1H46QW8UjSKNRhVcy1bSB6JY+4Ip/HZexJKDyijDXIgcEdqh7 XAWA== 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=3sXxKpQgrnotRyFJvyRPk0Xs+GRdftij+k/kTivXzV0=; b=RqfW+/eR5JLgeWLHxDmPlU61R24FoUCMXE8ZAgHrx/6C3vVkcyHU5dFjvJk7J2ECKp MiJQ624BE3znLzrgEHGhZjuPPUDzh1T6YHhd4/cH2N3CsVJLU4JUfxT3VXqZMG0b6n9c OvSiFgG+ySwMj8YZo4E/7IzcJYMq3u6632hGmdnSH3gSkDKgPwyh6ohJPvw9nkWGdryZ jM/7AVyjMmeJlXyJW+58dU5GUfmxzkpUybJJ8F0nuICUKayDPYKQpxUCULx79RVfLeXl zYQCDyLL7kiyCf0ltwV0IpPUIUPGJpRQDAzSLqsFyepeHS4JUH9xScfD89fIV31iHQHS lv5g== X-Gm-Message-State: AOAM531eC/8lTCVD9FrfgtSF18tnVgvXkUSb+XelQ9bHCWY4qig+p0yW mP3Rwj1N/MYI3lWYyrNqyj+29A== X-Received: by 2002:adf:f20a:: with SMTP id p10mr83083836wro.41.1594626436567; Mon, 13 Jul 2020 00:47:16 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:16 -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 , Luben Tuikov Subject: [PATCH v2 27/29] scsi: aic94xx: aic94xx_hwi: Repair kerneldoc formatting error and remove extra param Date: Mon, 13 Jul 2020 08:46:43 +0100 Message-Id: <20200713074645.126138-28-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Function parameters need to be documented with format '@.*: '. 'to' is not longer asd_start_timers()'s function parameter. Fixes the following W=1 kernel build warning(s): drivers/scsi/aic94xx/aic94xx_hwi.c:589: warning: Function parameter or member 'asd_ha' not described in 'asd_init_ctxmem' drivers/scsi/aic94xx/aic94xx_hwi.c:1157: warning: Excess function parameter 'to' description in 'asd_start_scb_timers' Cc: Luben Tuikov Signed-off-by: Lee Jones --- drivers/scsi/aic94xx/aic94xx_hwi.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/aic94xx/aic94xx_hwi.c b/drivers/scsi/aic94xx/aic94xx_hwi.c index c5a46c59d4f80..9256ab7b25227 100644 --- a/drivers/scsi/aic94xx/aic94xx_hwi.c +++ b/drivers/scsi/aic94xx/aic94xx_hwi.c @@ -575,7 +575,7 @@ static int asd_extend_cmdctx(struct asd_ha_struct *asd_ha) /** * asd_init_ctxmem -- initialize context memory - * asd_ha: pointer to host adapter structure + * @asd_ha: pointer to host adapter structure * * This function sets the maximum number of SCBs and * DDBs which can be used by the sequencer. This is normally @@ -1146,7 +1146,6 @@ static void asd_swap_head_scb(struct asd_ha_struct *asd_ha, /** * asd_start_timers -- (add and) start timers of SCBs * @list: pointer to struct list_head of the scbs - * @to: timeout in jiffies * * If an SCB in the @list has no timer function, assign the default * one, then start the timer of the SCB. This function is From patchwork Mon Jul 13 07:46:44 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235314 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2611042ilg; Mon, 13 Jul 2020 00:47:44 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz1x1y7000AH05P7Rsz+hFhZPZkxlDDMoaN58VRIUeKHx81kr0pLUEztlBtrd2WSuw7dIay X-Received: by 2002:a17:906:57c5:: with SMTP id u5mr55488659ejr.311.1594626464318; Mon, 13 Jul 2020 00:47:44 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626464; cv=none; d=google.com; s=arc-20160816; b=TV14KvJG4e3hmZWGg3yEFuCPBHcYy66EPogMTT0+RA1ZgPDM0jRkBHpQWrJhv3bttE 9FN3QRKIE7k0gha+rMtbIbYZMSC/TXjqoskgZOM7Y70PbbT4LxxNnsncaOg01lzY1NDo Q3lGAedmzTZTdd7XDZ9pRIvW75qZY4wqjIC6l+fPB9iUxSIjMjmvYwFBMk+AleNRXW5Z Al6cxidCt7YaE7I18yK6KD0YDJNfMJ1hiDKHe8AeL5hGFk1V94TmMYR39ydDYg91yzQ1 M3VHhJDXsH6Qk+wIfbH4mvFG15hlNQG9Hu+j0sAAw0Rzt74yoRurxrlR2+3n1Y2Dr+da IIlA== 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=d7D7AfDQQG73fSw4f21gOz4vhVntWScnapCoKvjgVSM=; b=KAWD4fu/3FjFxzGlwoEZNaXhfIbdc6kVvkj9V/R5wun1zX0EhrKyOAcl7D5BK3Bbj0 BiUKYcmgYVImKdbgGtkeXbkoeFUQyw+Z3Sh45sEk3vQ1Yg1Ltr0opoK/bFnJHqtGqoaQ nMAquQ8NmUpp0XC4baZesVpvHqY4gASgsudWHBo75HqT8Dc9nwP6vbX8V48QeiTfO0un rC4Tj0D3+Y2FIzlhIdn7xkXbF48gsO6vaAY0aNLbb1gZXy2weJZ8LEO+lVyVt8EErOH3 xM1EdQqS0LGoXu6jRQgndYo1s1ILFWHhAinQANHcq/3AU/7COyMr987dqpnx45Ic2MAZ rZcA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=vV+NVLZb; 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 fi17si8664769ejb.724.2020.07.13.00.47.44 for ; Mon, 13 Jul 2020 00:47:44 -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=vV+NVLZb; 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 S1729516AbgGMHrk (ORCPT ); Mon, 13 Jul 2020 03:47:40 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50478 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729423AbgGMHrT (ORCPT ); Mon, 13 Jul 2020 03:47:19 -0400 Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 287A7C061755 for ; Mon, 13 Jul 2020 00:47:19 -0700 (PDT) Received: by mail-wm1-x343.google.com with SMTP id l2so12174727wmf.0 for ; Mon, 13 Jul 2020 00:47:19 -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=d7D7AfDQQG73fSw4f21gOz4vhVntWScnapCoKvjgVSM=; b=vV+NVLZbcCzd4H3LMTl7g1rbRAL4pQW36HVzYwkRoNO7H8voiAmmb1Ft/Ig7C9LqAN 5NElhgHT2E+DngzMp3xd9PzgBACBMSL8PKud4STlFQNDR488sZRESJlnOIhg6LCGA4IP rDwVwXp+sxZclZMMgDjZKriAl/1M+xdQKZqbKpi7WqPwgOpauWacugk41diIdooz92zq ZFF00fG+2EZXpSQFE6auRlu+aBEMoFFJLmUV2WwFzybWIeyjeiqTcanXL20tvjoiTyHN fsYhJ+CxX5aXYUhwoJeEzHlNhHW7gQeq7rpZl5sAHNPl8Z8VepXO+NMz/87JgOQTHgAn PSbQ== 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=d7D7AfDQQG73fSw4f21gOz4vhVntWScnapCoKvjgVSM=; b=F279f82pSQzR9dY/ztK5vcq27l34P5IcW7Af4MQZzH4lGYx+GGkzZ7loh3b8DMW5/j s6lNjEAjVkDqhS8Bb+q7aPLv8uHCvQhUBwDRUWs3b5YqEalh7txzzUYBPkzvvnSq9Bwz nryRMFV1L99ukHTN44uuwO92WZFJ7V+PWewaOo3lKrqSKb71dC5L83U5cj2wQ4RTqX+4 hFe6ojOum3vWZc5I+65E36EEjdibFLj2R7pnocX7WXk4wdkRKFv8p9mnf1fnreO0ZUXb CQUODIurhH18cfe9I7SygpqcxUb6mkeSdASByZXnltzNivLsbt3jRSdWq3Oi1/qoSdSU E9NQ== X-Gm-Message-State: AOAM530IysRWZBGBSRDnndbHHVe/4UxhlpLvZhUB+Gs2zADkivzg42L8 Ye1tOLuFVd6iwshz13UcIxc9FA== X-Received: by 2002:a7b:cd10:: with SMTP id f16mr18044156wmj.86.1594626437839; Mon, 13 Jul 2020 00:47:17 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:17 -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 , Adaptec OEM Raid Solutions , "PMC-Sierra, Inc" Subject: [PATCH v2 28/29] scsi: aacraid: aachba: Fix a bunch of function doc formatting errors Date: Mon, 13 Jul 2020 08:46:44 +0100 Message-Id: <20200713074645.126138-29-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 And a few missing/excessive parameter descriptions. Fixes the following W=1 kernel build warning(s): drivers/scsi/aacraid/aachba.c:358: warning: Function parameter or member 'dev' not described in 'aac_get_config_status' drivers/scsi/aacraid/aachba.c:358: warning: Function parameter or member 'commit_flag' not described in 'aac_get_config_status' drivers/scsi/aacraid/aachba.c:358: warning: Excess function parameter 'common' description in 'aac_get_config_status' drivers/scsi/aacraid/aachba.c:450: warning: Function parameter or member 'dev' not described in 'aac_get_containers' drivers/scsi/aacraid/aachba.c:450: warning: Excess function parameter 'common' description in 'aac_get_containers' drivers/scsi/aacraid/aachba.c:568: warning: Function parameter or member 'scsicmd' not described in 'aac_get_container_name' drivers/scsi/aacraid/aachba.c:796: warning: Function parameter or member 'scsicmd' not described in 'aac_probe_container_callback1' drivers/scsi/aacraid/aachba.c:796: warning: Excess function parameter 'dev' description in 'aac_probe_container_callback1' drivers/scsi/aacraid/aachba.c:796: warning: Excess function parameter 'cid' description in 'aac_probe_container_callback1' drivers/scsi/aacraid/aachba.c:1105: warning: Function parameter or member 'scsicmd' not described in 'aac_get_container_serial' drivers/scsi/aacraid/aachba.c:1961: warning: Excess function parameter 'phys_luns' description in 'aac_set_safw_attr_all_targets' drivers/scsi/aacraid/aachba.c:1961: warning: Excess function parameter 'rescan' description in 'aac_set_safw_attr_all_targets' drivers/scsi/aacraid/aachba.c:3394: warning: Cannot understand * on line 3394 - I thought it was a doc line drivers/scsi/aacraid/aachba.c:3687: warning: Cannot understand * on line 3687 - I thought it was a doc line drivers/scsi/aacraid/aachba.c:3752: warning: Cannot understand * on line 3752 - I thought it was a doc line drivers/scsi/aacraid/aachba.c:3795: warning: Cannot understand * on line 3795 - I thought it was a doc line Cc: Adaptec OEM Raid Solutions Cc: "PMC-Sierra, Inc" Signed-off-by: Lee Jones --- drivers/scsi/aacraid/aachba.c | 17 +++-------------- 1 file changed, 3 insertions(+), 14 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/aacraid/aachba.c b/drivers/scsi/aacraid/aachba.c index 2b868f8db8ffe..7ae1e545a255c 100644 --- a/drivers/scsi/aacraid/aachba.c +++ b/drivers/scsi/aacraid/aachba.c @@ -561,7 +561,7 @@ static void get_container_name_callback(void *context, struct fib * fibptr) scsicmd->scsi_done(scsicmd); } -/** +/* * aac_get_container_name - get container name, none blocking. */ static int aac_get_container_name(struct scsi_cmnd * scsicmd) @@ -786,8 +786,7 @@ static int _aac_probe_container(struct scsi_cmnd * scsicmd, int (*callback)(stru /** * aac_probe_container - query a logical volume - * @dev: device to query - * @cid: container identifier + * @scsicmd: the scsi command block * * Queries the controller about the given volume. The volume information * is updated in the struct fsa_dev_info structure rather than returned. @@ -1098,7 +1097,7 @@ static void get_container_serial_callback(void *context, struct fib * fibptr) scsicmd->scsi_done(scsicmd); } -/** +/* * aac_get_container_serial - get container serial, none blocking. */ static int aac_get_container_serial(struct scsi_cmnd * scsicmd) @@ -1952,8 +1951,6 @@ static int aac_get_safw_attr_all_targets(struct aac_dev *dev) /** * aac_set_safw_attr_all_targets- update current hba map with data from FW * @dev: aac_dev structure - * @phys_luns: FW information from report phys luns - * @rescan: Indicates scan type * * Update our hba map with the information gathered from the FW */ @@ -3391,15 +3388,12 @@ int aac_dev_ioctl(struct aac_dev *dev, unsigned int cmd, void __user *arg) } /** - * * aac_srb_callback * @context: the context set in the fib - here it is scsi cmd * @fibptr: pointer to the fib * * Handles the completion of a scsi command to a non dasd device - * */ - static void aac_srb_callback(void *context, struct fib * fibptr) { struct aac_srb_reply *srbreply; @@ -3684,13 +3678,11 @@ static void hba_resp_task_failure(struct aac_dev *dev, } /** - * * aac_hba_callback * @context: the context set in the fib - here it is scsi cmd * @fibptr: pointer to the fib * * Handles the completion of a native HBA scsi command - * */ void aac_hba_callback(void *context, struct fib *fibptr) { @@ -3749,14 +3741,12 @@ void aac_hba_callback(void *context, struct fib *fibptr) } /** - * * aac_send_srb_fib * @scsicmd: the scsi command block * * This routine will form a FIB and fill in the aac_srb from the * scsicmd passed in. */ - static int aac_send_srb_fib(struct scsi_cmnd* scsicmd) { struct fib* cmd_fibcontext; @@ -3792,7 +3782,6 @@ static int aac_send_srb_fib(struct scsi_cmnd* scsicmd) } /** - * * aac_send_hba_fib * @scsicmd: the scsi command block * From patchwork Mon Jul 13 07:46:45 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 235313 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2610957ilg; Mon, 13 Jul 2020 00:47:32 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwj7yjAElE+2JINAiQo+wqMVpMhBgTxwug7xnFlzSSVRsLO+m83Mf3g/TtwupTYK2dcJS5O X-Received: by 2002:a17:906:a28b:: with SMTP id i11mr71331799ejz.524.1594626452030; Mon, 13 Jul 2020 00:47:32 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594626452; cv=none; d=google.com; s=arc-20160816; b=xYjB9udxS5h7F4+BH30nsInwBBjXVyq25yHsEGXrthmhrv86mYcPujA1WvSb+qfRN1 YER7URw+5fXwxWEqi4PK7OJscBi3ylwnBbXZl/VfbVbt4Gw3R0N8F9y8q2/SMKBn1RIy fLnu+iKHdok/Mfs4kHDgdeZYHcBQ7zflm0dpu5dRB6Ql0gk4gkYXmHrQHU0q7hNDA4EQ mvMHFEzUG3mU2FABJ9XGG+nVqzTKQgxaA7iKbWm1pfKfpaYAMwBON4/AlEOLSj3xgQ29 2k7LMOMpZxT+os6s16JjHVItdCKu1QsklLAQW2oystjwJRUFPx5oh+0oRHajKC6jm7fy IJkA== 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=XQHRlmYiMy5z0WnxtNKRalmwQyJTVSmo3hN7/2Qvzas=; b=js2nSt111668ksJ/IAkj/1nxfk88WkektKHIkv2YyS7TocQ2FVjpWy8APkogp/5Iyq r6r7mgfWlL7T+tWmn3874foDxQ3pXaeY/S6TrQMV6LtWrC0fDhqbsUhIeZEJwlDo0sxV HGAr5r2qbLE5h4mUNpO5N+OQXbEvkgpD7IVLO4c3UR2N6vMVoohW6QJj4dDVATp4SFDR 9egbhet9RquE29dp5cBRbyz9OHmM9gcgO2jJOAdDC7dQwteeA0qwFcRbUD+Gy+9W/XPu +czgaHmbtFqrG84a+tb++pMjzaa0qk3NJgbzNGZ3EWXbGsqXhz0hKze11tFNzGb0UWRp xa8g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=KHL9TfqH; 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 n6si8220317ejs.278.2020.07.13.00.47.31 for ; Mon, 13 Jul 2020 00:47:32 -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=KHL9TfqH; 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 S1729478AbgGMHrb (ORCPT ); Mon, 13 Jul 2020 03:47:31 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50484 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729430AbgGMHrU (ORCPT ); Mon, 13 Jul 2020 03:47:20 -0400 Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 39DD4C08C5DB for ; Mon, 13 Jul 2020 00:47:20 -0700 (PDT) Received: by mail-wm1-x342.google.com with SMTP id o8so12308042wmh.4 for ; Mon, 13 Jul 2020 00:47:20 -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=XQHRlmYiMy5z0WnxtNKRalmwQyJTVSmo3hN7/2Qvzas=; b=KHL9TfqHuic2Hz/gCGjHqEV4aXb+rqiIxhW2H0SIf95PQRa4bMGKzxcKNY/V0HaQCh FV3WMI7KMqZvdJMZLQIqhkncE2ybjODT8FbtRsxDnKV+4nRN9UaArVXi4PibDxnCCBgh Ga86GDhHwA3vJDwJOPNCgFmgF2wgxvnOjM7T1IXrGAtLr5AN6fKxkJGta0KvX7tr0g/v 08KZHR0URgb652sx8tDibXdv/bjWR5rZvhMtIpKtL+K9M+MoW+jJe8/n9qMF8rmDJq6A bDBxqpp+t/g4wU79ff6v94+pBQFa0Pz5/QlwG64QEbTWP7WxFnU32Eiml8L1gkX7+TQF NRGw== 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=XQHRlmYiMy5z0WnxtNKRalmwQyJTVSmo3hN7/2Qvzas=; b=f/fFJc0DWSkl/TXn1o8HPvro3zJEAx8jUwypUjvqw4y2G/f0OVo6ImUelH5li71GFd tOe/shE5P2tKk0WwOaxwXTsakTK3acBHWLP1017o92ifZKhWBOyaZA6Np87BaF/M6d9g 3t6PAYIrgCMk3Rw1SLoOoyowwONgjJJ4xIQVh32vq5ypXhglyNi9LSPimz+erLhtqoxO +GvbekU+DkEvnIR1RRAauZBJVcc4drZSlgAr2Dlf8sL07pL2PnZtdNiw4gxAElLUTAoz 2Yv6H4jj0U2AXwJCL9WR8oEzovSAyD3bwdRYbpwe+7d58E4bJJLpudz26hYtCuZhWGYq 8R1A== X-Gm-Message-State: AOAM533+NvWi0QnrNw2jHTDlxDSmr0I/UfFJWp2cJVUFMkKBdRoRGUXi bBzo7KU50g7WTT8Hw1gOtqSYL2heGOo= X-Received: by 2002:a1c:4d11:: with SMTP id o17mr17319246wmh.134.1594626438923; Mon, 13 Jul 2020 00:47:18 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id k11sm25142488wrd.23.2020.07.13.00.47.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 00:47:18 -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 , QLogic-Storage-Upstream@qlogic.com Subject: [PATCH v2 29/29] scsi: qla4xxx: ql4_init: Provide a missing function param description and fix formatting Date: Mon, 13 Jul 2020 08:46:45 +0100 Message-Id: <20200713074645.126138-30-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713074645.126138-1-lee.jones@linaro.org> References: <20200713074645.126138-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 Kerneldoc function parameter references need to be in the format '@.*: ', else the kerneldoc checker gets confused. Fixes the following W=1 kernel build warning(s): drivers/scsi/qla4xxx/ql4_init.c: In function ‘ql4xxx_set_mac_number’: drivers/scsi/qla4xxx/ql4_init.c:17:10: warning: variable ‘func_number’ set but not used [-Wunused-but-set-variable] drivers/scsi/qla4xxx/ql4_init.c: In function ‘qla4xxx_pci_config’: drivers/scsi/qla4xxx/ql4_init.c:664:6: warning: variable ‘status’ set but not used [-Wunused-but-set-variable] from drivers/scsi/qla4xxx/ql4_init.c:9: from drivers/scsi/qla4xxx/ql4_init.c:9: drivers/scsi/qla4xxx/ql4_init.c:953: warning: Function parameter or member 'is_reset' not described in 'qla4xxx_initialize_adapter' drivers/scsi/qla4xxx/ql4_init.c:1168: warning: Function parameter or member 'ha' not described in 'qla4xxx_process_ddb_changed' drivers/scsi/qla4xxx/ql4_init.c:1168: warning: Function parameter or member 'fw_ddb_index' not described in 'qla4xxx_process_ddb_changed' drivers/scsi/qla4xxx/ql4_init.c:1168: warning: Function parameter or member 'state' not described in 'qla4xxx_process_ddb_changed' drivers/scsi/qla4xxx/ql4_init.c:1168: warning: Function parameter or member 'conn_err' not described in 'qla4xxx_process_ddb_changed' Cc: QLogic-Storage-Upstream@qlogic.com Signed-off-by: Lee Jones --- drivers/scsi/qla4xxx/ql4_init.c | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/qla4xxx/ql4_init.c b/drivers/scsi/qla4xxx/ql4_init.c index 2bf5e3e639e1a..5963127f7d2ef 100644 --- a/drivers/scsi/qla4xxx/ql4_init.c +++ b/drivers/scsi/qla4xxx/ql4_init.c @@ -945,6 +945,7 @@ void qla4xxx_free_ddb_index(struct scsi_qla_host *ha) /** * qla4xxx_initialize_adapter - initiailizes hba * @ha: Pointer to host adapter structure. + * @is_reset: Is this init path or reset path * * This routine parforms all of the steps necessary to initialize the adapter. * @@ -1156,9 +1157,9 @@ int qla4xxx_flash_ddb_change(struct scsi_qla_host *ha, uint32_t fw_ddb_index, /** * qla4xxx_process_ddb_changed - process ddb state change - * @ha - Pointer to host adapter structure. - * @fw_ddb_index - Firmware's device database index - * @state - Device state + * @ha: Pointer to host adapter structure. + * @fw_ddb_index: Firmware's device database index + * @state: Device state * * This routine processes a Decive Database Changed AEN Event. **/