From patchwork Tue Jul 21 16:41:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 246924 Delivered-To: patch@linaro.org Received: by 2002:a54:2c11:0:0:0:0:0 with SMTP id g17csp2712485ecp; Tue, 21 Jul 2020 09:44:09 -0700 (PDT) X-Google-Smtp-Source: ABdhPJx3vBF8zlGOsKl4wgD94pngiqO7BM8C6kBP1oat4THk1SGM64AU4N153PdRU45/t7d08Agv X-Received: by 2002:a17:906:950c:: with SMTP id u12mr25547084ejx.37.1595349849863; Tue, 21 Jul 2020 09:44:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1595349849; cv=none; d=google.com; s=arc-20160816; b=a8GE9eD9zjLgJ37lJkb20i7yHeuGJMFEY7PK3I7Uiji9CbuVmFxdOsGF6hjYh8A9GM 5A32mSESlqpROoYWVtO+KzQoEvnEvBmf7vC+BJ0YNTlS+KEOP5VgsvlSDiq9JANT78CC nOSiEBUrwoZiIoC3OJGoRR/P1sPXDz19Jts11V6FJdqrJkZ9PmFwqIKlQJqKJjkrwIIC a6XVvgC/dxxn8PEcgs5wOr2YI/g9hsEBbqDbrqELF3LDBl5JJugTdtu1lgAlNwKMNhd5 yjhT8oTE5nD7KPOlyPTywO46tx4CcvtHnzeTcbbvaqodmirULBhmK1Kx5R6Z0i6iofUn yeUA== 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=XGTsDAIvYg7OoXRgnP3n/W6+fXiTQfVQsRFU0wHYrcE=; b=HZBvMG+gfnPyClkdG8G7qIOVxwLrLyfuxbgMJf8n5GVPNHBJevRP6EXfgjVHBOfyK/ Up/y67llQgyC5AEGEbs1CFXvZrR0uchtBBLKKvJ5W8US62At6h/t69cTC5EAWgKJLe2o mN21gZW1QxvA+aNpG7sfD47/WCafrKyximmgMQGHzgjRPVjyrymkNee1RpJEU6lOeDUa c3bD87nNfgcNAmhmSyG6Cf4HG5AEZiKxVVEse/B/7HHtBEwb/rc1N52owrrgWJz0nD7o N/PFNeryJm8xeEeIv8SD3lnQf0SXAveKnFZhj0LQ6Fhq24QqguZ+IsjBiIOsnWU2nnhO CJAQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=mjULXsS+; 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 h14si12945050edr.586.2020.07.21.09.44.09 for ; Tue, 21 Jul 2020 09:44: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=mjULXsS+; 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 S1730905AbgGUQn5 (ORCPT ); Tue, 21 Jul 2020 12:43:57 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46938 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1730684AbgGUQm2 (ORCPT ); Tue, 21 Jul 2020 12:42:28 -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 48298C0619DF for ; Tue, 21 Jul 2020 09:42:28 -0700 (PDT) Received: by mail-wr1-x444.google.com with SMTP id z15so21825011wrl.8 for ; Tue, 21 Jul 2020 09:42:28 -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=XGTsDAIvYg7OoXRgnP3n/W6+fXiTQfVQsRFU0wHYrcE=; b=mjULXsS+2dTrdCLkuMlJ2woTYq6hqIau2y6VEUHF8aT9eWMLiH4W//CdsBJRoCQvP3 xHUdpwQ8WlRgcf6LuuTjIPBJTAECVhXmWla3NRyPtEHp/uPxm13MgH5fJFzygR73Dnac 4WV4CevyfD8n3Vwt0PSVfnHWEKfit4Pml3BZRVDv0LxRK1JAnxw4Ng4FFSB/SAZCfg+c L44fbzar46IgCbXiXXZJsG50oMsh2LeqIAMyK0a6vrnKQtdrYcuOnvHetsmBhUw81fCo c7ilCsxZBvGaNY0H2o+kvNlGIAm35wFuRgbP1fGCcPrgU4QTM0qaZbRuZYQJP5zQeV+6 metg== 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=XGTsDAIvYg7OoXRgnP3n/W6+fXiTQfVQsRFU0wHYrcE=; b=dYVsXDykEBmzwFzKCcdsoPD7IPVddF6hFQE20BFd3CNba9pV/zitW4ceaRJp1+nI3n eWGrkxXbnJqXeGxkIT4D9/R0j2OuhRhESqphm1yMcEYwnk4MKAMFT1X3klAdHbs3Me4Q fuXBepmA4J+khIq9VsvPvju+IONBRPZ7B/mAB+CO9kMeAVgT6Lh6Q/8rc/y00K45wwKz 6dHl+dfztzDPJucAV4mU8PGbIjbQ+5QTGOw0wXJlkEJp18wALlAtJjDVh6Y1Qlwze/MI ReuJGbAG8v2GpNNBU5uOBXfpmTu8Mg6gMN+5PwDaKX4jBbM2sfZI3ZMuu3tuyffvbU8T XjoA== X-Gm-Message-State: AOAM533FTdwz3rI8uZrfS+OVEbuupIh5Q1uMlh5pLe+Plue01dJsRey+ lHaNKcUHfPjsyqv3AD5Y2SDTiQ== X-Received: by 2002:adf:f10a:: with SMTP id r10mr26815356wro.406.1595349747035; Tue, 21 Jul 2020 09:42:27 -0700 (PDT) Received: from localhost.localdomain ([2.27.167.94]) by smtp.gmail.com with ESMTPSA id m4sm3933524wmi.48.2020.07.21.09.42.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 21 Jul 2020 09:42:26 -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 21/40] scsi: qla4xxx: ql4_mbx: Fix-up incorrectly documented parameter Date: Tue, 21 Jul 2020 17:41:29 +0100 Message-Id: <20200721164148.2617584-22-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200721164148.2617584-1-lee.jones@linaro.org> References: <20200721164148.2617584-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 Also demote incomplete header from kerneldoc. Fixes the following W=1 kernel build warning(s): from drivers/scsi/qla4xxx/ql4_mbx.c:9: drivers/scsi/qla4xxx/ql4_mbx.c:53: warning: Excess function parameter 'ret' description in 'qla4xxx_is_intr_poll_mode' drivers/scsi/qla4xxx/ql4_mbx.c:832: warning: Function parameter or member 'fw_ddb_entry_dma' not described in 'qla4xxx_get_fwddb_entry' drivers/scsi/qla4xxx/ql4_mbx.c:832: warning: Function parameter or member 'conn_err_detail' not described in 'qla4xxx_get_fwddb_entry' drivers/scsi/qla4xxx/ql4_mbx.c:832: warning: Function parameter or member 'tcp_source_port_num' not described in 'qla4xxx_get_fwddb_entry' drivers/scsi/qla4xxx/ql4_mbx.c:832: warning: Function parameter or member 'connection_id' not described in 'qla4xxx_get_fwddb_entry' drivers/scsi/qla4xxx/ql4_mbx.c:1271: warning: Function parameter or member 'ddb_entry' not described in 'qla4xxx_reset_target' drivers/scsi/qla4xxx/ql4_mbx.c:1271: warning: Excess function parameter 'db_entry' description in 'qla4xxx_reset_target' drivers/scsi/qla4xxx/ql4_mbx.c:1271: warning: Excess function parameter 'un_entry' description in 'qla4xxx_reset_target' Cc: QLogic-Storage-Upstream@qlogic.com Signed-off-by: Lee Jones --- drivers/scsi/qla4xxx/ql4_mbx.c | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/qla4xxx/ql4_mbx.c b/drivers/scsi/qla4xxx/ql4_mbx.c index 02636b4785c58..bc8de7d402d58 100644 --- a/drivers/scsi/qla4xxx/ql4_mbx.c +++ b/drivers/scsi/qla4xxx/ql4_mbx.c @@ -47,7 +47,7 @@ void qla4xxx_process_mbox_intr(struct scsi_qla_host *ha, int out_count) /** * qla4xxx_is_intr_poll_mode – Are we allowed to poll for interrupts? * @ha: Pointer to host adapter structure. - * @ret: 1=polling mode, 0=non-polling mode + * returns: 1=polling mode, 0=non-polling mode **/ static int qla4xxx_is_intr_poll_mode(struct scsi_qla_host *ha) { @@ -810,7 +810,7 @@ int qla4xxx_get_firmware_status(struct scsi_qla_host * ha) return QLA_SUCCESS; } -/** +/* * qla4xxx_get_fwddb_entry - retrieves firmware ddb entry * @ha: Pointer to host adapter structure. * @fw_ddb_index: Firmware's device database index @@ -1259,8 +1259,7 @@ int qla4xxx_reset_lun(struct scsi_qla_host * ha, struct ddb_entry * ddb_entry, /** * qla4xxx_reset_target - issues target Reset * @ha: Pointer to host adapter structure. - * @db_entry: Pointer to device database entry - * @un_entry: Pointer to lun entry structure + * @ddb_entry: Pointer to device database entry * * This routine performs a TARGET RESET on the specified target. * The caller must ensure that the ddb_entry pointers