From patchwork Wed Mar 17 09:11:55 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403071 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294271jai; Wed, 17 Mar 2021 02:13:26 -0700 (PDT) X-Google-Smtp-Source: ABdhPJywSV+RUHumc592U+8Eo5ct+m6gNsF5ckP2aB72EMMUtUR1KQm8dXPscZHPtuxPCDZceNFQ X-Received: by 2002:a17:906:f203:: with SMTP id gt3mr18715097ejb.346.1615972406667; Wed, 17 Mar 2021 02:13:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972406; cv=none; d=google.com; s=arc-20160816; b=ulBPCtWjaJ73nnXB1KJtWFl+O40XP4xG6VWj8OG06+SG3MgO7IruMo0OmNyXtT9X8t tqDpsYCR2t/wk++gWJ8SOd6THAt+b49ak1xL6gWCe823O7Bj5Y0HrXsPlZ0zbYfahUh2 3kRBDSMrI2EbFmAt0nZwsH6MhapNV6+Sw9FC0xwykLemEsSdzKBikuXjxCdkhCAB3QFE y9UwsGJhHZL33KZTd5njcC6veTipSn3rOEnnkudo3byHZ9DPwwwjqC/xvjMs8KU+KYAT PDXVi8Ik8QbBsiWYYbv8E/6GLsnlEMrtonjeibcGyWLtxwGg0nidWAPF/TibGmOL3axS QXzQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=789UHYUvVMzCBbNg3UASk3n+nFZmY80q4S9W+NeV8Bg=; b=JNWbyKqSPpCB/pr3snO2JS12M/pk+wf5MbliYwLiXrVQvywGvIbI5BTyAF9jnDUf7u 6aTbl7lvq4xgaQ9Ma4MSfFpnBg7eBFtUH9arTf3gAh7IvLhuR1U50+Vs1TNc3l6w8EIm RBmA3fjkEZVKxcev7TVGCMlFhDPzTo1oQqpHO0PLYDE6ZsTIDRCcdaC5oq3rsZdPaTs2 /hRHufj9prIQF68CoMa3e1BNmXNPAfScOnMBrt9oM5GNH6CI92izXFsW1so+V4t8w98a slJH2+Hw+Lx7EFXU7YeHyznGaj47Bx2F/s9qMM+yWoyiOxsnneTswSbVk7f1CNlFZlOz +5CA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=WFW0sq+z; 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 t15si15461864edq.164.2021.03.17.02.13.26 for ; Wed, 17 Mar 2021 02:13:26 -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=WFW0sq+z; 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 S229972AbhCQJMz (ORCPT ); Wed, 17 Mar 2021 05:12:55 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42632 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230166AbhCQJMm (ORCPT ); Wed, 17 Mar 2021 05:12:42 -0400 Received: from mail-wr1-x431.google.com (mail-wr1-x431.google.com [IPv6:2a00:1450:4864:20::431]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C8681C061763 for ; Wed, 17 Mar 2021 02:12:41 -0700 (PDT) Received: by mail-wr1-x431.google.com with SMTP id v4so990637wrp.13 for ; Wed, 17 Mar 2021 02:12:41 -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=789UHYUvVMzCBbNg3UASk3n+nFZmY80q4S9W+NeV8Bg=; b=WFW0sq+ziqOsjD8Iegw5o3qclzUow5ppaB10QpJpjUdB1ZS/1pwY3QhWX4IKKISPH0 VADtvkNA40g7exp5m9DEu0cx6qSrq/lVF4Naq+wafPw0wAUrm/nH44pAm19tV5lwe2K1 9BtL9UMOSf8KQyukj8TeTg4wPddjnjaN6+CjYF806OnRKJ0fuaVOcrAIFXsXWv8FCxae fWC17C/eg2eimNcSG7JV4Bybk3/emq7L4Dli3Yai4zhrjbFkiwQwAhukjLjixHxn5AU6 Z/h0tzwLyb3Xs0hFnvsOosHdTJ8LSZFltvClu4n6TPgvx+ByJMpfDFVykWq8/7vLSomr /nEA== 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=789UHYUvVMzCBbNg3UASk3n+nFZmY80q4S9W+NeV8Bg=; b=uFX6Q1Y/b/Ev1Dr9IyXFVtff5l3WE99C6R1ui75hVyRejMiq1whZfZ5rnddCdP7JA5 q2+/tEmQcuFB2uVvz821DBE/KaMrnCBjp7LcnO05Dz8IH860+FgrEC1xzuPyv9ZTI2um Cgpb0E12B86zNOoHsv2XIQkck7H06OXulxEJU+wMZTgn1rYSwPtRT7A0M4w+GiZCe0N3 bKsyE1Q0S1a+K7F2zKsaLvAA6dNWfvPK0UDqYfU6XKE79YrHAvzoTsYy12Dc8ZNhskl6 CIlLrza8GHrzKqi7KKn2YDX6bYmrm7YX7d807sk3ZvpzpSVeWbV/VWbxXq55MEz8X5o3 Vwag== X-Gm-Message-State: AOAM533tMdo9via6ax/UfxF6lVX9A8NJb2+O74uD7r8qLojZmqGi6Rug DR3CbJ9E/yZnKt2zby04eh4IEQ== X-Received: by 2002:a5d:6412:: with SMTP id z18mr3343778wru.214.1615972360513; Wed, 17 Mar 2021 02:12:40 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:40 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Hannes Reinecke , "James E.J. Bottomley" , "Martin K. Petersen" , Linux GmbH , "Leonard N. Zubkoff" , linux-scsi@vger.kernel.org Subject: [PATCH 01/36] scsi: myrb: Demote non-conformant kernel-doc headers and fix others Date: Wed, 17 Mar 2021 09:11:55 +0000 Message-Id: <20210317091230.2912389-2-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/myrb.c:91: warning: Function parameter or member 'pdev' not described in 'myrb_create_mempools' drivers/scsi/myrb.c:91: warning: Function parameter or member 'cb' not described in 'myrb_create_mempools' drivers/scsi/myrb.c:141: warning: Function parameter or member 'cb' not described in 'myrb_destroy_mempools' drivers/scsi/myrb.c:153: warning: Function parameter or member 'cmd_blk' not described in 'myrb_reset_cmd' drivers/scsi/myrb.c:164: warning: Function parameter or member 'cb' not described in 'myrb_qcmd' drivers/scsi/myrb.c:164: warning: Function parameter or member 'cmd_blk' not described in 'myrb_qcmd' drivers/scsi/myrb.c:187: warning: Function parameter or member 'cb' not described in 'myrb_exec_cmd' drivers/scsi/myrb.c:187: warning: Function parameter or member 'cmd_blk' not described in 'myrb_exec_cmd' drivers/scsi/myrb.c:208: warning: Function parameter or member 'cb' not described in 'myrb_exec_type3' drivers/scsi/myrb.c:208: warning: Function parameter or member 'op' not described in 'myrb_exec_type3' drivers/scsi/myrb.c:208: warning: Function parameter or member 'addr' not described in 'myrb_exec_type3' drivers/scsi/myrb.c:231: warning: Function parameter or member 'cb' not described in 'myrb_exec_type3D' drivers/scsi/myrb.c:231: warning: Function parameter or member 'op' not described in 'myrb_exec_type3D' drivers/scsi/myrb.c:231: warning: Function parameter or member 'sdev' not described in 'myrb_exec_type3D' drivers/scsi/myrb.c:231: warning: Function parameter or member 'pdev_info' not described in 'myrb_exec_type3D' drivers/scsi/myrb.c:341: warning: Function parameter or member 'cb' not described in 'myrb_get_errtable' drivers/scsi/myrb.c:388: warning: Function parameter or member 'cb' not described in 'myrb_get_ldev_info' drivers/scsi/myrb.c:440: warning: Function parameter or member 'cb' not described in 'myrb_get_rbld_progress' drivers/scsi/myrb.c:440: warning: Function parameter or member 'rbld' not described in 'myrb_get_rbld_progress' drivers/scsi/myrb.c:472: warning: Function parameter or member 'cb' not described in 'myrb_update_rbld_progress' drivers/scsi/myrb.c:533: warning: Function parameter or member 'cb' not described in 'myrb_get_cc_progress' drivers/scsi/myrb.c:580: warning: Function parameter or member 'cb' not described in 'myrb_bgi_control' drivers/scsi/myrb.c:671: warning: Function parameter or member 'cb' not described in 'myrb_hba_enquiry' drivers/scsi/myrb.c:782: warning: Function parameter or member 'cb' not described in 'myrb_set_pdev_state' drivers/scsi/myrb.c:782: warning: Function parameter or member 'sdev' not described in 'myrb_set_pdev_state' drivers/scsi/myrb.c:782: warning: Function parameter or member 'state' not described in 'myrb_set_pdev_state' drivers/scsi/myrb.c:808: warning: Function parameter or member 'cb' not described in 'myrb_enable_mmio' drivers/scsi/myrb.c:808: warning: Function parameter or member 'mmio_init_fn' not described in 'myrb_enable_mmio' drivers/scsi/myrb.c:913: warning: Function parameter or member 'cb' not described in 'myrb_get_hba_config' drivers/scsi/myrb.c:1200: warning: Function parameter or member 'cb' not described in 'myrb_unmap' drivers/scsi/myrb.c:1236: warning: Function parameter or member 'cb' not described in 'myrb_cleanup' drivers/scsi/myrb.c:2249: warning: Function parameter or member 'dev' not described in 'myrb_is_raid' drivers/scsi/myrb.c:2260: warning: Function parameter or member 'dev' not described in 'myrb_get_resync' drivers/scsi/myrb.c:2287: warning: Function parameter or member 'dev' not described in 'myrb_get_state' drivers/scsi/myrb.c:2493: warning: Function parameter or member 'cb' not described in 'myrb_err_status' drivers/scsi/myrb.c:2493: warning: Function parameter or member 'error' not described in 'myrb_err_status' drivers/scsi/myrb.c:2493: warning: Function parameter or member 'parm0' not described in 'myrb_err_status' drivers/scsi/myrb.c:2493: warning: Function parameter or member 'parm1' not described in 'myrb_err_status' Cc: Hannes Reinecke Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Linux GmbH Cc: "Leonard N. Zubkoff" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/myrb.c | 47 ++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 24 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/myrb.c b/drivers/scsi/myrb.c index 3d8e91c07dc77..d469a48897774 100644 --- a/drivers/scsi/myrb.c +++ b/drivers/scsi/myrb.c @@ -82,7 +82,7 @@ static const char *myrb_raidlevel_name(enum myrb_raidlevel level) return NULL; } -/** +/* * myrb_create_mempools - allocates auxiliary data structures * * Return: true on success, false otherwise. @@ -134,7 +134,7 @@ static bool myrb_create_mempools(struct pci_dev *pdev, struct myrb_hba *cb) return true; } -/** +/* * myrb_destroy_mempools - tears down the memory pools for the controller */ static void myrb_destroy_mempools(struct myrb_hba *cb) @@ -146,7 +146,7 @@ static void myrb_destroy_mempools(struct myrb_hba *cb) dma_pool_destroy(cb->dcdb_pool); } -/** +/* * myrb_reset_cmd - reset command block */ static inline void myrb_reset_cmd(struct myrb_cmdblk *cmd_blk) @@ -157,7 +157,7 @@ static inline void myrb_reset_cmd(struct myrb_cmdblk *cmd_blk) cmd_blk->status = 0; } -/** +/* * myrb_qcmd - queues command block for execution */ static void myrb_qcmd(struct myrb_hba *cb, struct myrb_cmdblk *cmd_blk) @@ -177,7 +177,7 @@ static void myrb_qcmd(struct myrb_hba *cb, struct myrb_cmdblk *cmd_blk) cb->next_cmd_mbox = next_mbox; } -/** +/* * myrb_exec_cmd - executes command block and waits for completion. * * Return: command status @@ -198,7 +198,7 @@ static unsigned short myrb_exec_cmd(struct myrb_hba *cb, return cmd_blk->status; } -/** +/* * myrb_exec_type3 - executes a type 3 command and waits for completion. * * Return: command status @@ -220,7 +220,7 @@ static unsigned short myrb_exec_type3(struct myrb_hba *cb, return status; } -/** +/* * myrb_exec_type3D - executes a type 3D command and waits for completion. * * Return: command status @@ -332,7 +332,7 @@ static void myrb_get_event(struct myrb_hba *cb, unsigned int event) ev_buf, ev_addr); } -/** +/* * myrb_get_errtable - retrieves the error table from the controller * * Executes a type 3 command and logs the error table from the controller. @@ -377,7 +377,7 @@ static void myrb_get_errtable(struct myrb_hba *cb) } } -/** +/* * myrb_get_ldev_info - retrieves the logical device table from the controller * * Executes a type 3 command and updates the logical device table. @@ -427,7 +427,7 @@ static unsigned short myrb_get_ldev_info(struct myrb_hba *cb) return status; } -/** +/* * myrb_get_rbld_progress - get rebuild progress information * * Executes a type 3 command and returns the rebuild progress @@ -462,11 +462,10 @@ static unsigned short myrb_get_rbld_progress(struct myrb_hba *cb, return status; } -/** +/* * myrb_update_rbld_progress - updates the rebuild status * * Updates the rebuild status for the attached logical devices. - * */ static void myrb_update_rbld_progress(struct myrb_hba *cb) { @@ -523,7 +522,7 @@ static void myrb_update_rbld_progress(struct myrb_hba *cb) cb->last_rbld_status = status; } -/** +/* * myrb_get_cc_progress - retrieve the rebuild status * * Execute a type 3 Command and fetch the rebuild / consistency check @@ -571,7 +570,7 @@ static void myrb_get_cc_progress(struct myrb_hba *cb) rbld_buf, rbld_addr); } -/** +/* * myrb_bgi_control - updates background initialisation status * * Executes a type 3B command and updates the background initialisation status @@ -660,7 +659,7 @@ static void myrb_bgi_control(struct myrb_hba *cb) bgi, bgi_addr); } -/** +/* * myrb_hba_enquiry - updates the controller status * * Executes a DAC_V1_Enquiry command and updates the controller status. @@ -772,7 +771,7 @@ static unsigned short myrb_hba_enquiry(struct myrb_hba *cb) return MYRB_STATUS_SUCCESS; } -/** +/* * myrb_set_pdev_state - sets the device state for a physical device * * Return: command status @@ -796,7 +795,7 @@ static unsigned short myrb_set_pdev_state(struct myrb_hba *cb, return status; } -/** +/* * myrb_enable_mmio - enables the Memory Mailbox Interface * * PD and P controller types have no memory mailbox, but still need the @@ -901,7 +900,7 @@ static bool myrb_enable_mmio(struct myrb_hba *cb, mbox_mmio_init_t mmio_init_fn) return true; } -/** +/* * myrb_get_hba_config - reads the configuration information * * Reads the configuration information from the controller and @@ -1193,7 +1192,7 @@ static int myrb_get_hba_config(struct myrb_hba *cb) return ret; } -/** +/* * myrb_unmap - unmaps controller structures */ static void myrb_unmap(struct myrb_hba *cb) @@ -1229,7 +1228,7 @@ static void myrb_unmap(struct myrb_hba *cb) } } -/** +/* * myrb_cleanup - cleanup controller structures */ static void myrb_cleanup(struct myrb_hba *cb) @@ -2243,7 +2242,7 @@ static struct scsi_host_template myrb_template = { /** * myrb_is_raid - return boolean indicating device is raid volume - * @dev the device struct object + * @dev: the device struct object */ static int myrb_is_raid(struct device *dev) { @@ -2254,7 +2253,7 @@ static int myrb_is_raid(struct device *dev) /** * myrb_get_resync - get raid volume resync percent complete - * @dev the device struct object + * @dev: the device struct object */ static void myrb_get_resync(struct device *dev) { @@ -2281,7 +2280,7 @@ static void myrb_get_resync(struct device *dev) /** * myrb_get_state - get raid volume status - * @dev the device struct object + * @dev: the device struct object */ static void myrb_get_state(struct device *dev) { @@ -2480,7 +2479,7 @@ static void myrb_monitor(struct work_struct *work) queue_delayed_work(cb->work_q, &cb->monitor_work, interval); } -/** +/* * myrb_err_status - reports controller BIOS messages * * Controller BIOS messages are passed through the Error Status Register From patchwork Wed Mar 17 09:11:56 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403073 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294290jai; Wed, 17 Mar 2021 02:13:28 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyIjnMB24gLfvXJRr9syU7n++2hXJDgz82n68f2fKgGb/BXfmXysKKVe3cuOGjoh39f92P6 X-Received: by 2002:aa7:dd99:: with SMTP id g25mr40250605edv.230.1615972408676; Wed, 17 Mar 2021 02:13:28 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972408; cv=none; d=google.com; s=arc-20160816; b=p1jnJuhzVRmg6Wo7Sn7hwqVFi0bWKFYDCg/wllkBONerL8zaSdSSOBpOaWVIuV5oms cJOhg3LD2ZjJRFYggEDyIsWG1F6ZL/hFSzVck3JC/CroQEIFdg4G8X7vnWM76QPd8c3Y HJrKWrz/Ki3Z0KOQ2kRtAzVhLlcmUWTkhqW4YCeuiDJv9+W1S3tcFJ87PyD5Kt5cZJDX p4hqOp8pxQ7ZFacyY8PeM6lSN5lO7FQNz6PErwGMBi3BwbSFAVo+nlchtnlmdsFS9Z6c oRchj3Kra6AVkr9HGl5/IOYcneGP16HdlZQ/i19b5U4iPkFRBbIGhKkG2XKikPH6xixW GpMw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=/Ist2WriQgAxq9syOJncEZN/L5jXNPETHQWe8qT5KR4=; b=RFoqqP79FVyLngB0Y1VeAPVVc729Mct1tM1RdiWU0SqnYD1nZV81jlrraorhVB4vh0 vFlu73Sm7TpCfcafxfEDaAFyqMz8TPe5jYQk0tDW1ply7hhXzGSV0uiCmvmJMKWyNAR3 cyRohFwI0BWFKYcN9T4ZXmh1keDuHFfsXVJ4OBCH0DuKAP/sMqaHjTeYtKg8UL11jbrV NYKl21/qKpc5j70wQCSNmBLcAxrm8KET2MuZFsOeG4pJYHfKYM8JyKhtKQB3OE7+roAU GyYwcIpVz4R2y1adQAmx8NLCvOIwpoS298VctdJya9Lcc65ieQUOz+GXkacJwGj0D17k bNJA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=hLzEuHn8; 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 t15si15461864edq.164.2021.03.17.02.13.28 for ; Wed, 17 Mar 2021 02:13: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=hLzEuHn8; 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 S229964AbhCQJM4 (ORCPT ); Wed, 17 Mar 2021 05:12:56 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42640 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230171AbhCQJMn (ORCPT ); Wed, 17 Mar 2021 05:12:43 -0400 Received: from mail-wr1-x42a.google.com (mail-wr1-x42a.google.com [IPv6:2a00:1450:4864:20::42a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C110FC061765 for ; Wed, 17 Mar 2021 02:12:42 -0700 (PDT) Received: by mail-wr1-x42a.google.com with SMTP id k8so1004643wrc.3 for ; Wed, 17 Mar 2021 02:12:42 -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=/Ist2WriQgAxq9syOJncEZN/L5jXNPETHQWe8qT5KR4=; b=hLzEuHn8Dns9Vhn27orHSyf4UKao9+a+puBhH1H69THyHVYuHN6f8svXJWqSWwy8Vb fEcGWwVL4ZS6RIxF8xGjkLuIpQ11I+t2yBr5dDekfAk9V7YpqmSFEZ0ScuWMt5ind6Tn wk7HtjGa2iNPd+aRXcnPdhwYfIUqtzr/ekeb0o8gK6YnWYYJVRwZmIf+tr2/NS/+Fq5T /RWOjcSaUu+IubRpjgKnJwGsOuQCtxEXeASIu2BllR/F2b4ykC0degWjp1aB9l2Ufx7M M+Z5BWXThT0+8NV/5FctN8rjj90hEkgu/Wn9+D1ZmeS/D8xbxKOQQrWUE30JWmLekK9/ 9/iw== 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=/Ist2WriQgAxq9syOJncEZN/L5jXNPETHQWe8qT5KR4=; b=q9L2V0dWVP/1WIDIV4Qvo7ea4tlY33mgvYc2G2CrV7VY2G2Mj2MzqA/g0sH0xmB2Ot tUpHgi5DeP7/7dvcb+plJgAbDlir7xqjBYGg3WOIcr9bNBTsPrFmT1y1c06MvDb4VKTk AkrumcQ0GqaVrJ1+vQFlqsbvPuEwA1jrLNJVZACCxb6WOZ+lE8P9070ontA7AHPCfO8M wYiIsFurudJGyG3byeAOKiP1xHJ/as02QNqHTjkqgdEUIGNHtxtT8dtNAeXl7Xk84Zc2 ZeRt0BrR0kKkJJHKEVuYELPBeKJ+AGvSB/Cj7uJgOqlvHxqzOdoQx7ypujd4EddTMpMp FOKw== X-Gm-Message-State: AOAM532MR3iDgnMugTwBKNO7ly8e9QykmVS2r/0k5Jh6XnL7M92WSc7S qnhe8fC8iqvknjW37J4iEobjJNGoWTkrkA== X-Received: by 2002:a5d:4e52:: with SMTP id r18mr3532653wrt.28.1615972361513; Wed, 17 Mar 2021 02:12:41 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:41 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Brian King , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 02/36] scsi: ipr: Fix incorrect function names in their headers Date: Wed, 17 Mar 2021 09:11:56 +0000 Message-Id: <20210317091230.2912389-3-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/ipr.c:5335: warning: expecting prototype for ipr_eh_dev_reset(). Prototype was for __ipr_eh_dev_reset() instead drivers/scsi/ipr.c:5594: warning: expecting prototype for ipr_eh_abort(). Prototype was for ipr_scan_finished() instead drivers/scsi/ipr.c:5616: warning: expecting prototype for ipr_eh_host_reset(). Prototype was for ipr_eh_abort() instead drivers/scsi/ipr.c:6725: warning: expecting prototype for ipr_info(). Prototype was for ipr_ioa_info() instead Cc: Brian King Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/ipr.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/ipr.c b/drivers/scsi/ipr.c index e451102b9a299..fd6c974c2754e 100644 --- a/drivers/scsi/ipr.c +++ b/drivers/scsi/ipr.c @@ -5321,7 +5321,7 @@ static int ipr_sata_reset(struct ata_link *link, unsigned int *classes, } /** - * ipr_eh_dev_reset - Reset the device + * __ipr_eh_dev_reset - Reset the device * @scsi_cmd: scsi command struct * * This function issues a device reset to the affected device. @@ -5583,7 +5583,7 @@ static int ipr_cancel_op(struct scsi_cmnd *scsi_cmd) } /** - * ipr_eh_abort - Abort a single op + * ipr_scan_finished - Abort a single op * @shost: scsi host struct * @elapsed_time: elapsed time * @@ -5606,7 +5606,7 @@ static int ipr_scan_finished(struct Scsi_Host *shost, unsigned long elapsed_time } /** - * ipr_eh_host_reset - Reset the host adapter + * ipr_eh_abort - Reset the host adapter * @scsi_cmd: scsi command struct * * Return value: @@ -6715,7 +6715,7 @@ static int ipr_ioctl(struct scsi_device *sdev, unsigned int cmd, } /** - * ipr_info - Get information about the card/driver + * ipr_ioa_info - Get information about the card/driver * @host: scsi host struct * * Return value: From patchwork Wed Mar 17 09:11:57 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403074 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294298jai; Wed, 17 Mar 2021 02:13:29 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyFRCY/CTMaOxg1XoDoq/DQOxu3p9DCx8cV90D7fhR1IqUuqjycVzSuPbtuy7j0l5zEieLa X-Received: by 2002:a17:907:36e:: with SMTP id rs14mr33390148ejb.42.1615972409463; Wed, 17 Mar 2021 02:13:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972409; cv=none; d=google.com; s=arc-20160816; b=eNJ8KRPf6krkSin32msvpRUSnwJYe5FPBam8Zw7ah1QpBRLTYkylI/R8g9wX9ujvDB whzpCHXXdtKPKYI5hp+TKFibG0ep3dZXt9s9BUFl448QhTdJjDLJr67Iq5Iz3FZC2TXp KqTmpjOvzTuzRtbmixntVOhT6TQxckTw5CKQ49bjVtztKWSpO9WWH4SVPHELh8rgR6mn MoVagGoacRsLQd/25gAViE4UrpwUQiWV5QrwQQo6/de6MEDAoKm5iKN1r4Bcfhxfu7oC t5meU86kNTKP02n8kN7qfn3UFxmbdCDhcqe45WpfcKjI+SA/3SrdFM/iCOIiQQ9Ma9aH Pm/w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=+02nW2PCCLBAyTUDbzKGlxZllc8oSt5ULWtL7I/vEo0=; b=L3vTN5MNAg8d5AkbvEDfys/Tb8HXU80egbKb7TsmnPpO4TZ2f4wJnDiRIML+dj4QhV vg16s9jeaxBZAvI/ikQefv3JlsNSuUpcK2KAYxSRf73oxDitnEO3WfvV3Z3iftlaiuoM rnM+khHoejNCAE+/wWeJSfgDonrkZ4n8VNYeuT2vsV2stFodK0hJ18coBmTniMFNhwcE rvgP4I+bffztCzWdESzujuxbdrtqfYXhs6MOHUoN6k2n6myOJfmzl1KRuwY9ZOqpCc90 65dwQKi8SdL/kcAVBfqhpXVRqhmWYzzV+yhTAgSaIWDZB/Lmxozo/L3XLNWVnzytWvFo /fmA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=cTTi5LmX; 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 t15si15461864edq.164.2021.03.17.02.13.29 for ; Wed, 17 Mar 2021 02:13:29 -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=cTTi5LmX; 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 S230026AbhCQJNA (ORCPT ); Wed, 17 Mar 2021 05:13:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42640 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230173AbhCQJMo (ORCPT ); Wed, 17 Mar 2021 05:12:44 -0400 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DAA12C06174A for ; Wed, 17 Mar 2021 02:12:43 -0700 (PDT) Received: by mail-wr1-x433.google.com with SMTP id e9so995693wrw.10 for ; Wed, 17 Mar 2021 02:12:43 -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=+02nW2PCCLBAyTUDbzKGlxZllc8oSt5ULWtL7I/vEo0=; b=cTTi5LmX6VahXgRKVRGD5W5vktQwvHyWromSFIZbDUbKKC8WcwJWRsZgTD5g1y8QgJ mxWgu7mmNQfduLkX/GOYaAHoxej51MY/Aczry9GcFTeXZULPPhxSvO7YY/v2D2G/PHsv ZHsMEu3Jm1pvSndWEPqCZ+FXPSKAjQrVeAsPfEaYpqJAkmDP4ysx2tPy4zewHxTwXUXb bFfCRbOpDYS5GeXSqU7JlzAnx2I58ZhOKmxGxzoX27ADuuZPTKHpBB6IVGjiEZZwNw3N OfoG4z4sAmw28Wnz+xSx8TCngOS8RSPeyWgHMR9ka9FKYDfWOzS2RZbxlBuQ5mF3BeX3 5bLQ== 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=+02nW2PCCLBAyTUDbzKGlxZllc8oSt5ULWtL7I/vEo0=; b=Wds+9RBN0LqxRBrBPIxBNwLjKKZRtWHj8CTVPI+kCYsT4nqZ7Gms7EVpozSH4i3GCZ IR33KsSD8cbrLsuzmFHzZSTNAtzb2QVblSSXCZim7pVkLrrqvV1px1lMHGBJJkMzBcfr s1kwfKBWcNT2Srbvmk8Ef5UFWjpnhciW0jBuX/PNti83adVsSObZS4gvvaSNyjtrk4QU cRkNTPcuTofn/jI1gQKru+5yGYAv/PcOkzokzSgPqswAItHJ9zMOt+oquHWw7Z/ObJXu QR38jbIzxlMZlE7f1lmdI02jNucQLXPPCkGZjYn2QS+hXza2PaLKe5RajD/Y33hqJeh8 L3tw== X-Gm-Message-State: AOAM532yjMCyOZp/HpIMOn63A+P8adr9Hhlh2FwPjhG6Iwurs6gHdprz zHxK0C34YJZYEyTNyHT4u/iJng== X-Received: by 2002:adf:b30f:: with SMTP id j15mr3359420wrd.132.1615972362691; Wed, 17 Mar 2021 02:12:42 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:42 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , Marvell , linux-scsi@vger.kernel.org Subject: [PATCH 03/36] scsi: mvumi: Fix formatting and doc-rot issues Date: Wed, 17 Mar 2021 09:11:57 +0000 Message-Id: <20210317091230.2912389-4-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/mvumi.c:191: warning: Function parameter or member 'sg_count' not described in 'mvumi_make_sgl' drivers/scsi/mvumi.c:1301: warning: Function parameter or member 'ob_frame' not described in 'mvumi_complete_cmd' drivers/scsi/mvumi.c:2084: warning: Function parameter or member 'shost' not described in 'mvumi_queue_command' drivers/scsi/mvumi.c:2084: warning: Excess function parameter 'done' description in 'mvumi_queue_command' Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Marvell Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/mvumi.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/mvumi.c b/drivers/scsi/mvumi.c index 71b6a1f834cd7..f41982a4b3abd 100644 --- a/drivers/scsi/mvumi.c +++ b/drivers/scsi/mvumi.c @@ -182,7 +182,7 @@ static void mvumi_release_mem_resource(struct mvumi_hba *mhba) * @mhba: Adapter soft state * @scmd: SCSI command from the mid-layer * @sgl_p: SGL to be filled in - * @sg_count return the number of SG elements + * @sg_count: return the number of SG elements * * If successful, this function returns 0. otherwise, it returns -1. */ @@ -1295,6 +1295,7 @@ static unsigned char mvumi_start(struct mvumi_hba *mhba) * mvumi_complete_cmd - Completes a command * @mhba: Adapter soft state * @cmd: Command to be completed + * @ob_frame: Command response */ static void mvumi_complete_cmd(struct mvumi_hba *mhba, struct mvumi_cmd *cmd, struct mvumi_rsp_frame *ob_frame) @@ -2076,8 +2077,8 @@ static unsigned char mvumi_build_frame(struct mvumi_hba *mhba, /** * mvumi_queue_command - Queue entry point + * @shost: Scsi host to queue command on * @scmd: SCSI command to be queued - * @done: Callback entry point */ static int mvumi_queue_command(struct Scsi_Host *shost, struct scsi_cmnd *scmd) From patchwork Wed Mar 17 09:11:58 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403076 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294307jai; Wed, 17 Mar 2021 02:13:30 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwEltyetHwSVu7sJrSQ3vfXFYWzvrSZJ6CHB4TLzCTz+Wa4N5R5DnRZIXC2bEL+ZTsV+56Z X-Received: by 2002:a17:906:f891:: with SMTP id lg17mr34533509ejb.69.1615972410566; Wed, 17 Mar 2021 02:13:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972410; cv=none; d=google.com; s=arc-20160816; b=rK0Ya3FmLZ8kM4QYsAYCQvj3xdgycMdJBfTnsJafnbhDNQh8SVwyL7tJOU4pzGVvI9 uGnN/AnZhxaZOJIg4da37un8kOMVqCAtFp+LIn7aZuyjTP5QJCQhnRuZRixHXl0Qz1Xm ay4lreYtRg8TkPlVTixMemnKgg6pRF80/0yQuOx71GUodvj1R7qa6PopgSJNRe8Uw5Ca 7fAbW95TfP9pztMqGA+mhSxe5Fj22713i4x3oqauNGt71EADU5Rn3uMx8pqUXutfABZ4 79W+0n9TKL07lo1+cr6xDP7Q0ZWq2exHwk03XIUtzRcrbAJ4KN6ydRlaHaqfgSjorCEs EUgw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=4JQChJrJ8kh/QX5GDHmU/NgjW9SKy0ixrD8GB81+Yao=; b=lp4lrhaFmRpIwH+L7ND8hkFpRRl6ix4aalhuaKbw0LBb77hUHwdEI2+5CJn85L3nM7 px6XStCBKkZSWUc0veaSQ0oMlhtFVzX5sZWgNJJVqvRwoKhWc2AvuGZbTti1D64wVIQn eVbhwSwHi6plNVdja8KWWkhJc6DRzozjJufljhYXSRVYaBh+OqgCqPQfJsPAl/nRFcJM sb8Zkvkm3TL6tM6G0pce91QkCmLvifZRCjzlWA/pd21WtetjbCpymIyZS+vdl1SBAy49 xErDm2OFtO3dFuBY+ZXzKj1wd+g8rFN7+fSma5IlbL9A3Na97zUfdPpiEZNIpuL+eCnX E7dw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=okAQv3Rj; 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 t15si15461864edq.164.2021.03.17.02.13.30 for ; Wed, 17 Mar 2021 02:13:30 -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=okAQv3Rj; 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 S230113AbhCQJNB (ORCPT ); Wed, 17 Mar 2021 05:13:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42640 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230177AbhCQJMp (ORCPT ); Wed, 17 Mar 2021 05:12:45 -0400 Received: from mail-wr1-x432.google.com (mail-wr1-x432.google.com [IPv6:2a00:1450:4864:20::432]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C823BC06174A for ; Wed, 17 Mar 2021 02:12:44 -0700 (PDT) Received: by mail-wr1-x432.google.com with SMTP id 61so990807wrm.12 for ; Wed, 17 Mar 2021 02:12:44 -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=4JQChJrJ8kh/QX5GDHmU/NgjW9SKy0ixrD8GB81+Yao=; b=okAQv3RjlV9ZaNNVDcKjLsomhYzxhr4oD6fJFOAwmr5rRTu8VFX8yb2E3SHIselm0l I0cWZkRI6AR1WjHsNnzSNL3y2aO9KF/FmdS/M4Ul9LpbLnylwWiGXp0crsoX6KldnEWy a/50lCBknJ0UC536Vn+04VKmyMl5ObPWHb0e5ysqVlu9rkdR6pZHtxQMfNGlQH0NUxAA CqGWDSC1jBc+ZJJ0LsIleZ894Srcji12b1tGe53uUvWyAyZZ3M5monKS/dEMD/ANs7Vq oKtKmW6mYFIILSm1X3pJ/jRZ1007toWHnF/dkRw0AhljPTU/XIJA2TzUGZfOQ69hl3j0 HE0A== 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=4JQChJrJ8kh/QX5GDHmU/NgjW9SKy0ixrD8GB81+Yao=; b=qqlXFvXwWI7I3GNAhW6u16QnqD1AqlKayOtWyNvOikTi4P/y9uub9Rtz0T3boDmTNG KEcTrsyiK3Kprbvmq63G6yt4E86239RnQVMDWuTqM8Eb0k8X01+u+zjOF0okgscd1cCo T8Efo62DhO8PKQcpr8LqsKu1SJU8I51GcNvluETSC1RKe4wYy9XJjwh6auSPwTA4ApCx s5E/idlkacuytvNf8QeU6rJTU1v1dm3LYwUJ9aIEk45rmO76tCpFJfek52Qc82rHbfdE LhZgc7J0M4xUDXThmzaVggkeT4jspNvzNqQqX6gs+IVv+zL9XMqcIAmxM8WNdfnx7D95 +yrA== X-Gm-Message-State: AOAM533Q/jK/KvB6LnaiNq/piOeGWJNQccPeUAlJap6U2yq3CXzDi0P0 k31a/df/Wv934UC+Uj6+KhiIGoKYXJWMWw== X-Received: by 2002:adf:eb8e:: with SMTP id t14mr3340153wrn.20.1615972363572; Wed, 17 Mar 2021 02:12:43 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:43 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , Hannes Reinecke , Le Moal , Shaun Tancheff , linux-scsi@vger.kernel.org Subject: [PATCH 04/36] scsi: sd_zbc: Place function name into header Date: Wed, 17 Mar 2021 09:11:58 +0000 Message-Id: <20210317091230.2912389-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/sd_zbc.c:137: warning: wrong kernel-doc identifier on line: Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Hannes Reinecke Cc: Le Moal Cc: Shaun Tancheff Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/sd_zbc.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/sd_zbc.c b/drivers/scsi/sd_zbc.c index ee558675eab4a..232f624c3704f 100644 --- a/drivers/scsi/sd_zbc.c +++ b/drivers/scsi/sd_zbc.c @@ -134,7 +134,7 @@ static int sd_zbc_do_report_zones(struct scsi_disk *sdkp, unsigned char *buf, } /** - * Allocate a buffer for report zones reply. + * sd_zbc_alloc_report_buffer() - Allocate a buffer for report zones reply. * @sdkp: The target disk * @nr_zones: Maximum number of zones to report * @buflen: Size of the buffer allocated From patchwork Wed Mar 17 09:11:59 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403075 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294304jai; Wed, 17 Mar 2021 02:13:30 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzZ4AZAGYtwAgajfjzrbw9gWFMXd3r2W7Mgxz4lm+qgcgFEaHjNJUs7TE/dThxFTir/ib/L X-Received: by 2002:a17:906:f10c:: with SMTP id gv12mr34344260ejb.53.1615972410194; Wed, 17 Mar 2021 02:13:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972410; cv=none; d=google.com; s=arc-20160816; b=mwkXNCFcdwrt3uoYsBxzdM39azcAmrCy2uHR2FXhL9KFAQtAbX0G3TSkZbqYKBA+4Z QAPAkDLjboa/AJR9Iurl75bGbrqzIUofoAh28uLTcEZbsgehY1jSeloEApuYr1IO3OoQ +nZ8MlGvVaIg+Dwj9rbVzJPIOSw1cTyAsUGm5Mtr7VvS5f5jxidiXIcJYGXCRpuf/jpD M/wk8Gxm1ZJrscniSmf2kHVP7QSJZEJlyIvk5ah/5ZEyVqGg9Q3OjyQ00OZqMkMQQOvQ laGNjaFT9ZnP9faoJY04mMpOMmFiktcyPzCe+NL4GCx3MAJ6RCZAhvEEwzh6GBcumwZE GtcQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=DxBUihBpj0mKnAYokfmFfqQi/8TivCP0fpcxrk6Lfks=; b=OKsgONKrRW+TXAOdxlope3ORZPaWsqZJXee78LP8n6nvFtli8AlpjZgCZ4LNjcAt3t sPaf6VsjD0x/8F8M+Sw5Bl89ThGMhakPVECgZPWIPbQ0i7QaeCrDEGXgS/tNpkngMNLC 42XXtg5SqK0tB8YOS3HlXvV45sUwBAHYE/ysNm/D8+RO85M+lEZWtDyj3SqphIajs+wV PV7S5UeGXm4U1mTwGX4cPhdyaFQFk65oC8Nf4wGt8FTo/ClWdfvnyVaOtebHWrONipS8 f8Y0xvfKst6iBXOHsn8kbcrjoB/uC8bT2vxoMhatSZjVCamipqjR2hyBLkZzyZvBWqnZ lq4A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Ui0dB7Oe; 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 t15si15461864edq.164.2021.03.17.02.13.30 for ; Wed, 17 Mar 2021 02:13:30 -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=Ui0dB7Oe; 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 S230150AbhCQJNC (ORCPT ); Wed, 17 Mar 2021 05:13:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42646 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230182AbhCQJMq (ORCPT ); Wed, 17 Mar 2021 05:12:46 -0400 Received: from mail-wr1-x429.google.com (mail-wr1-x429.google.com [IPv6:2a00:1450:4864:20::429]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DED9CC061760 for ; Wed, 17 Mar 2021 02:12:45 -0700 (PDT) Received: by mail-wr1-x429.google.com with SMTP id x13so1002029wrs.9 for ; Wed, 17 Mar 2021 02:12:45 -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=DxBUihBpj0mKnAYokfmFfqQi/8TivCP0fpcxrk6Lfks=; b=Ui0dB7OenZAPPVMZCZSdQfKlwNSOx/NTZDSmaT5mZ/Hi85rGycIoxmFWvu2mpFFiVA K4DCbssfzwGsyvT2ze1tS6bBYH2TLiOCmGRc4fnfVGbjPO/HmwhKsu5vJL8uEM9Yjtd0 K473EDvnWnkAI+eo78zuWPCgHnAxp7MTQxGCGoaD1V4qqXp9oP3aVHrXoxtrDXKVuiIL B/iiUZP4mzvwZsa14HAg1RsEpWjPqrMq2nzJxMxrAfQWQelSFH/Hvd2KaCxDtkRqgbGO /1wic4JNZb3CerZGVGHmvMYXkj48TSzBvL4ZFaWrTBAzkwFlgrgYhlRHGyzyU4B2RKyq Kfag== 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=DxBUihBpj0mKnAYokfmFfqQi/8TivCP0fpcxrk6Lfks=; b=lmXHDG3UoAAptXpgJ+05unOGiwPCTY9cur5PYkEPEW5ZzdNzBASw6b67NYLeTyjQyY 1ZeRYTr4IOcd9uKdYt8/bq5q+zuqGsn0sU06njtGfhU0puFBl9LCO/fJUEcWrfajspzG usmOQBWX4U7l18djnvYrTqBvdNq8gfuVUJoajL/O460gnvvkojKBloD5UmFZczatdJSg NuKTK+auRwUB3JE7GO1BIbxfLQHvJQ60dQ8x0rKw/sPRm7kpp/TlpYmdttpQLTyM42P8 DtA54VJ9NW+3U4j/SuQGlPWVmq/5Kp554yxavgTbziB0RDDZjyeb0gHTqnUw9ZisIsEJ bGhw== X-Gm-Message-State: AOAM5308MKTjVGjUpaglqdpUwHfDQiDAcBlRcrktfT7+cxB+pQMNneww vhqhiVmJZ7qLjXPaCZoIJQxGlQ== X-Received: by 2002:adf:c641:: with SMTP id u1mr3334554wrg.332.1615972364586; Wed, 17 Mar 2021 02:12:44 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:44 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , Anil Ravindranath , linux-scsi@vger.kernel.org Subject: [PATCH 05/36] scsi: pmcraid: Fix a whole host of kernel-doc issues Date: Wed, 17 Mar 2021 09:11:59 +0000 Message-Id: <20210317091230.2912389-6-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/pmcraid.c:455: warning: Function parameter or member 'intrs' not described in 'pmcraid_enable_interrupts' drivers/scsi/pmcraid.c:455: warning: Excess function parameter 'intr' description in 'pmcraid_enable_interrupts' drivers/scsi/pmcraid.c:543: warning: Function parameter or member '' not described in 'pmcraid_ioa_reset' drivers/scsi/pmcraid.c:543: warning: expecting prototype for pmcraid_bist_done(). Prototype was for pmcraid_ioa_reset() instead drivers/scsi/pmcraid.c:603: warning: Function parameter or member 't' not described in 'pmcraid_reset_alert_done' drivers/scsi/pmcraid.c:603: warning: Excess function parameter 'cmd' description in 'pmcraid_reset_alert_done' drivers/scsi/pmcraid.c:638: warning: Function parameter or member '' not described in 'pmcraid_notify_ioastate' drivers/scsi/pmcraid.c:638: warning: Function parameter or member 'u32' not described in 'pmcraid_notify_ioastate' drivers/scsi/pmcraid.c:638: warning: expecting prototype for pmcraid_reset_alert(). Prototype was for pmcraid_notify_ioastate() instead drivers/scsi/pmcraid.c:687: warning: Function parameter or member 't' not described in 'pmcraid_timeout_handler' drivers/scsi/pmcraid.c:687: warning: Excess function parameter 'cmd' description in 'pmcraid_timeout_handler' drivers/scsi/pmcraid.c:858: warning: expecting prototype for pmcraid_fire_command(). Prototype was for _pmcraid_fire_command() instead drivers/scsi/pmcraid.c:972: warning: Function parameter or member '' not described in 'pmcraid_querycfg' drivers/scsi/pmcraid.c:972: warning: expecting prototype for pmcraid_get_fwversion_done(). Prototype was for pmcraid_querycfg() instead drivers/scsi/pmcraid.c:1398: warning: Function parameter or member 'aen_msg' not described in 'pmcraid_notify_aen' drivers/scsi/pmcraid.c:1398: warning: Function parameter or member 'data_size' not described in 'pmcraid_notify_aen' drivers/scsi/pmcraid.c:1398: warning: Excess function parameter 'type' description in 'pmcraid_notify_aen' drivers/scsi/pmcraid.c:1781: warning: Function parameter or member '' not described in 'pmcraid_initiate_reset' drivers/scsi/pmcraid.c:1781: warning: expecting prototype for pmcraid_process_ldn(). Prototype was for pmcraid_initiate_reset() instead drivers/scsi/pmcraid.c:1887: warning: Function parameter or member '' not described in 'pmcraid_reinit_buffers' drivers/scsi/pmcraid.c:1887: warning: expecting prototype for pmcraid_reset_enable_ioa(). Prototype was for pmcraid_reinit_buffers() instead drivers/scsi/pmcraid.c:2704: warning: Function parameter or member 'timeout' not described in 'pmcraid_reset_device' drivers/scsi/pmcraid.c:3025: warning: expecting prototype for pmcraid_eh_xxxx_reset_handler(). Prototype was for pmcraid_eh_device_reset_handler() instead drivers/scsi/pmcraid.c:3327: warning: expecting prototype for pmcraid_queuecommand(). Prototype was for pmcraid_queuecommand_lck() instead drivers/scsi/pmcraid.c:3437: warning: Function parameter or member 'inode' not described in 'pmcraid_chr_open' drivers/scsi/pmcraid.c:3437: warning: Function parameter or member 'filep' not described in 'pmcraid_chr_open' drivers/scsi/pmcraid.c:3437: warning: expecting prototype for pmcraid_open(). Prototype was for pmcraid_chr_open() instead drivers/scsi/pmcraid.c:3457: warning: Function parameter or member 'fd' not described in 'pmcraid_chr_fasync' drivers/scsi/pmcraid.c:3457: warning: Function parameter or member 'filep' not described in 'pmcraid_chr_fasync' drivers/scsi/pmcraid.c:3457: warning: Function parameter or member 'mode' not described in 'pmcraid_chr_fasync' drivers/scsi/pmcraid.c:3457: warning: expecting prototype for pmcraid_fasync(). Prototype was for pmcraid_chr_fasync() instead drivers/scsi/pmcraid.c:3574: warning: Function parameter or member 'ioctl_cmd' not described in 'pmcraid_ioctl_passthrough' drivers/scsi/pmcraid.c:3574: warning: Function parameter or member 'buflen' not described in 'pmcraid_ioctl_passthrough' drivers/scsi/pmcraid.c:3574: warning: Excess function parameter 'cmd' description in 'pmcraid_ioctl_passthrough' drivers/scsi/pmcraid.c:3905: warning: Function parameter or member 'filep' not described in 'pmcraid_chr_ioctl' drivers/scsi/pmcraid.c:3905: warning: Function parameter or member 'cmd' not described in 'pmcraid_chr_ioctl' drivers/scsi/pmcraid.c:3905: warning: Function parameter or member 'arg' not described in 'pmcraid_chr_ioctl' drivers/scsi/pmcraid.c:3905: warning: expecting prototype for pmcraid_ioctl(). Prototype was for pmcraid_chr_ioctl() instead drivers/scsi/pmcraid.c:3969: warning: cannot understand function prototype: 'const struct file_operations pmcraid_fops = ' drivers/scsi/pmcraid.c:3993: warning: Function parameter or member 'attr' not described in 'pmcraid_show_log_level' drivers/scsi/pmcraid.c:4015: warning: Function parameter or member 'attr' not described in 'pmcraid_store_log_level' drivers/scsi/pmcraid.c:4055: warning: Function parameter or member 'attr' not described in 'pmcraid_show_drv_version' drivers/scsi/pmcraid.c:4081: warning: Function parameter or member 'attr' not described in 'pmcraid_show_adapter_id' drivers/scsi/pmcraid.c:4081: warning: expecting prototype for pmcraid_show_io_adapter_id(). Prototype was for pmcraid_show_adapter_id() instead drivers/scsi/pmcraid.c:4600: warning: Function parameter or member 'pinstance' not described in 'pmcraid_allocate_cmd_blocks' drivers/scsi/pmcraid.c:5153: warning: Function parameter or member 'minor' not described in 'pmcraid_release_minor' Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Anil Ravindranath Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/pmcraid.c | 68 ++++++++++++++++++++---------------------- 1 file changed, 33 insertions(+), 35 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/pmcraid.c b/drivers/scsi/pmcraid.c index 834556ea21d20..c98e39eb04b24 100644 --- a/drivers/scsi/pmcraid.c +++ b/drivers/scsi/pmcraid.c @@ -443,15 +443,14 @@ static void pmcraid_disable_interrupts( * pmcraid_enable_interrupts - Enables specified interrupts * * @pinstance: pointer to per adapter instance structure - * @intr: interrupts to enable + * @intrs: interrupts to enable * * Return Value * None */ static void pmcraid_enable_interrupts( struct pmcraid_instance *pinstance, - u32 intrs -) + u32 intrs) { u32 gmask = ioread32(pinstance->int_regs.global_interrupt_mask_reg); u32 nmask = gmask & (~GLOBAL_INTERRUPT_MASK); @@ -533,15 +532,13 @@ static void pmcraid_reset_type(struct pmcraid_instance *pinstance) pinstance->ioa_unit_check = 1; } +static void pmcraid_ioa_reset(struct pmcraid_cmd *); /** * pmcraid_bist_done - completion function for PCI BIST - * @cmd: pointer to reset command + * @t: pointer to reset command * Return Value * none */ - -static void pmcraid_ioa_reset(struct pmcraid_cmd *); - static void pmcraid_bist_done(struct timer_list *t) { struct pmcraid_cmd *cmd = from_timer(cmd, t, timer); @@ -595,7 +592,7 @@ static void pmcraid_start_bist(struct pmcraid_cmd *cmd) /** * pmcraid_reset_alert_done - completion routine for reset_alert - * @cmd: pointer to command block used in reset sequence + * @t: pointer to command block used in reset sequence * Return value * None */ @@ -626,16 +623,16 @@ static void pmcraid_reset_alert_done(struct timer_list *t) } } +static void pmcraid_notify_ioastate(struct pmcraid_instance *, u32); /** * pmcraid_reset_alert - alerts IOA for a possible reset - * @cmd : command block to be used for reset sequence. + * @cmd: command block to be used for reset sequence. * * Return Value * returns 0 if pci config-space is accessible and RESET_DOORBELL is * successfully written to IOA. Returns non-zero in case pci_config_space * is not accessible */ -static void pmcraid_notify_ioastate(struct pmcraid_instance *, u32); static void pmcraid_reset_alert(struct pmcraid_cmd *cmd) { struct pmcraid_instance *pinstance = cmd->drv_inst; @@ -676,7 +673,7 @@ static void pmcraid_reset_alert(struct pmcraid_cmd *cmd) /** * pmcraid_timeout_handler - Timeout handler for internally generated ops * - * @cmd : pointer to command structure, that got timedout + * @t: pointer to command structure, that got timedout * * This function blocks host requests and initiates an adapter reset. * @@ -844,7 +841,7 @@ static void pmcraid_erp_done(struct pmcraid_cmd *cmd) } /** - * pmcraid_fire_command - sends an IOA command to adapter + * _pmcraid_fire_command - sends an IOA command to adapter * * This function adds the given block into pending command list * and returns without waiting @@ -961,6 +958,7 @@ static void pmcraid_ioa_shutdown(struct pmcraid_cmd *cmd) pmcraid_timeout_handler); } +static void pmcraid_querycfg(struct pmcraid_cmd *); /** * pmcraid_get_fwversion_done - completion function for get_fwversion * @@ -969,8 +967,6 @@ static void pmcraid_ioa_shutdown(struct pmcraid_cmd *cmd) * Return Value * none */ -static void pmcraid_querycfg(struct pmcraid_cmd *); - static void pmcraid_get_fwversion_done(struct pmcraid_cmd *cmd) { struct pmcraid_instance *pinstance = cmd->drv_inst; @@ -1382,10 +1378,9 @@ static void pmcraid_netlink_release(void) genl_unregister_family(&pmcraid_event_family); } -/** +/* * pmcraid_notify_aen - sends event msg to user space application * @pinstance: pointer to adapter instance structure - * @type: HCAM type * * Return value: * 0 if success, error value in case of any failure. @@ -1393,8 +1388,7 @@ static void pmcraid_netlink_release(void) static int pmcraid_notify_aen( struct pmcraid_instance *pinstance, struct pmcraid_aen_msg *aen_msg, - u32 data_size -) + u32 data_size) { struct sk_buff *skb; void *msg_header; @@ -1771,6 +1765,8 @@ static void pmcraid_process_ccn(struct pmcraid_cmd *cmd) } } +static void pmcraid_initiate_reset(struct pmcraid_instance *); +static void pmcraid_set_timestamp(struct pmcraid_cmd *cmd); /** * pmcraid_process_ldn - op done function for an LDN * @cmd: pointer to command block @@ -1778,9 +1774,6 @@ static void pmcraid_process_ccn(struct pmcraid_cmd *cmd) * Return value * none */ -static void pmcraid_initiate_reset(struct pmcraid_instance *); -static void pmcraid_set_timestamp(struct pmcraid_cmd *cmd); - static void pmcraid_process_ldn(struct pmcraid_cmd *cmd) { struct pmcraid_instance *pinstance = cmd->drv_inst; @@ -1878,14 +1871,14 @@ static void pmcraid_unregister_hcams(struct pmcraid_cmd *cmd) pmcraid_cancel_ldn(cmd); } +static void pmcraid_reinit_buffers(struct pmcraid_instance *); + /** * pmcraid_reset_enable_ioa - re-enable IOA after a hard reset * @pinstance: pointer to adapter instance structure * Return Value * 1 if TRANSITION_TO_OPERATIONAL is active, otherwise 0 */ -static void pmcraid_reinit_buffers(struct pmcraid_instance *); - static int pmcraid_reset_enable_ioa(struct pmcraid_instance *pinstance) { u32 intrs; @@ -2687,6 +2680,7 @@ static int pmcraid_error_handler(struct pmcraid_cmd *cmd) * pmcraid_reset_device - device reset handler functions * * @scsi_cmd: scsi command struct + * @timeout: command timeout * @modifier: reset modifier indicating the reset sequence to be performed * * This function issues a device reset to the affected device. @@ -2699,8 +2693,7 @@ static int pmcraid_error_handler(struct pmcraid_cmd *cmd) static int pmcraid_reset_device( struct scsi_cmnd *scsi_cmd, unsigned long timeout, - u8 modifier -) + u8 modifier) { struct pmcraid_cmd *cmd; struct pmcraid_instance *pinstance; @@ -3008,7 +3001,7 @@ static int pmcraid_eh_abort_handler(struct scsi_cmnd *scsi_cmd) } /** - * pmcraid_eh_xxxx_reset_handler - bus/target/device reset handler callbacks + * pmcraid_eh_device_reset_handler - bus/target/device reset handler callbacks * * @scmd: pointer to scsi_cmd that was sent to the resource to be reset. * @@ -3307,7 +3300,7 @@ static int pmcraid_copy_sglist( } /** - * pmcraid_queuecommand - Queue a mid-layer request + * pmcraid_queuecommand_lck - Queue a mid-layer request * @scsi_cmd: scsi command struct * @done: done function * @@ -3430,7 +3423,7 @@ static int pmcraid_queuecommand_lck( static DEF_SCSI_QCMD(pmcraid_queuecommand) -/** +/* * pmcraid_open -char node "open" entry, allowed only users with admin access */ static int pmcraid_chr_open(struct inode *inode, struct file *filep) @@ -3447,7 +3440,7 @@ static int pmcraid_chr_open(struct inode *inode, struct file *filep) return 0; } -/** +/* * pmcraid_fasync - Async notifier registration from applications * * This function adds the calling process to a driver global queue. When an @@ -3559,7 +3552,8 @@ static void pmcraid_release_passthrough_ioadls( * pmcraid_ioctl_passthrough - handling passthrough IOCTL commands * * @pinstance: pointer to adapter instance structure - * @cmd: ioctl code + * @ioctl_cmd: ioctl code + * @buflen: unused * @arg: pointer to pmcraid_passthrough_buffer user buffer * * Return value @@ -3894,7 +3888,7 @@ static int pmcraid_check_ioctl_buffer( return 0; } -/** +/* * pmcraid_ioctl - char node ioctl entry point */ static long pmcraid_chr_ioctl( @@ -3963,7 +3957,7 @@ static long pmcraid_chr_ioctl( return retval; } -/** +/* * File operations structure for management interface */ static const struct file_operations pmcraid_fops = { @@ -3981,6 +3975,7 @@ static const struct file_operations pmcraid_fops = { /** * pmcraid_show_log_level - Display adapter's error logging level * @dev: class device struct + * @attr: unused * @buf: buffer * * Return value: @@ -4000,6 +3995,7 @@ static ssize_t pmcraid_show_log_level( /** * pmcraid_store_log_level - Change the adapter's error logging level * @dev: class device struct + * @attr: unused * @buf: buffer * @count: not used * @@ -4042,6 +4038,7 @@ static struct device_attribute pmcraid_log_level_attr = { /** * pmcraid_show_drv_version - Display driver version * @dev: class device struct + * @attr: unused * @buf: buffer * * Return value: @@ -4068,6 +4065,7 @@ static struct device_attribute pmcraid_driver_version_attr = { /** * pmcraid_show_io_adapter_id - Display driver assigned adapter id * @dev: class device struct + * @attr: unused * @buf: buffer * * Return value: @@ -4589,7 +4587,7 @@ pmcraid_release_control_blocks( /** * pmcraid_allocate_cmd_blocks - allocate memory for cmd block structures - * @pinstance - pointer to per adapter instance structure + * @pinstance: pointer to per adapter instance structure * * Allocates memory for command blocks using kernel slab allocator. * @@ -5134,7 +5132,7 @@ static void pmcraid_shutdown(struct pci_dev *pdev) } -/** +/* * pmcraid_get_minor - returns unused minor number from minor number bitmap */ static unsigned short pmcraid_get_minor(void) @@ -5146,7 +5144,7 @@ static unsigned short pmcraid_get_minor(void) return minor; } -/** +/* * pmcraid_release_minor - releases given minor back to minor number bitmap */ static void pmcraid_release_minor(unsigned short minor) From patchwork Wed Mar 17 09:12:00 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403077 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294309jai; Wed, 17 Mar 2021 02:13:30 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyTJJSE4GR98kfvL+sT5sxSy0aUukY+f02rPkrDH1MMPfHEahqyBUZ/suu82ZOwDdcNpvW3 X-Received: by 2002:a17:906:af91:: with SMTP id mj17mr33031386ejb.230.1615972410878; Wed, 17 Mar 2021 02:13:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972410; cv=none; d=google.com; s=arc-20160816; b=i66B+e84w0WKp4tU5/RgswVWWSWGZorSSFZ23OhKilI9IvYXRBSloShyUTIhBIQdt/ ulgpCG/pRXYXS3uGMpfYibwembBgz3/JbeXCzj1XLXBWf14pYL3guAdEzSyB5rHj7n3j MyDq+rFr1FRIsa5kCcDfHhtS9Kdn8wXXQsee4ODhll1Bp9xt2uyBKANaLXqsC7UXphlo mNsRAMn/N+b+6iFA3Zz95F5siVgW4vNJe2SLHc4YZjo+Ogax2LEKoJHTzT3/81prxC5q Hv5P+qXLC8bZX2LAoDDNWRTXZPezMwX8aUy3IQxg7fB6KjqcNRHWI+1aRZDs0cTeT0dA qK3Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=oLJQSgQWxXN2wb6bBodFmEtoRfcnDqNqbqxISmqUROc=; b=xLpnrPTH0Zcw3eAH8ZUlmtXqirfqdr4cpp/RqI4K8CV2M+8mW2JNWrx1Xdt8Zvm7iK 3o+6k2SXc4XTR+rta5wQZFUQmAhA63Z67k2iuQYCqAcAIjM2afNAWUICHXwbIBNvNKCM O4a37i87qUNLle445AMBL0qKvUDZraTRs2uUG8HkegENK3x4AZCKPLPHuPVMY+XB7SYQ 14VPetuzLvjZgsBOaZryt9BYTixz9oZghwBvjv+eGRsaLSg/hJRCESlMT1NA9Mq7c45R YpXR0dmmYyWpsnrezWWsubcYV1bE87s12IxMS1RDwJcKy+X7vddtJHe82N3QnhhMUd0E R5bA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=aCK53FD1; 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 t15si15461864edq.164.2021.03.17.02.13.30 for ; Wed, 17 Mar 2021 02:13:30 -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=aCK53FD1; 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 S230164AbhCQJND (ORCPT ); Wed, 17 Mar 2021 05:13:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42640 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230186AbhCQJMr (ORCPT ); Wed, 17 Mar 2021 05:12:47 -0400 Received: from mail-wr1-x434.google.com (mail-wr1-x434.google.com [IPv6:2a00:1450:4864:20::434]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E5AF7C06174A for ; Wed, 17 Mar 2021 02:12:46 -0700 (PDT) Received: by mail-wr1-x434.google.com with SMTP id v11so1001217wro.7 for ; Wed, 17 Mar 2021 02:12:46 -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=oLJQSgQWxXN2wb6bBodFmEtoRfcnDqNqbqxISmqUROc=; b=aCK53FD1MvQhxDy9E5GlZ3fBCIB/5MJUl00lIdAFNFGX5slTA0hfmWWpQHXjPl5PYO Y3BeKR3dVg52uUnnUIY0wMhNntV0xmlQCOGFhxVPNUoZXDY22BML7bRnmGveD2UyEckb cnSZbwS+zC0aIilCAa8xL5mPJptbcts9RIjOBV+SE2PQRjbtCEx07IOjgCzWR9fnQu0Q dIgn17RFwXMMYfuyYelYCpSwBGxsPZuqjZyusCVkVw2Y+7eeik0G0LQr/d5uFrQN6n1s 636247jJTOF80YvNmqvdE7itXQNisLSmsT7MNCmTIQ/D3wQUQ92YKBjPgUhmHXXGq6RP fO0g== 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=oLJQSgQWxXN2wb6bBodFmEtoRfcnDqNqbqxISmqUROc=; b=ZWnEekM7LGv0QD9R3n7pckAkV+FS5YjYjeOMg4e5R9xb2riWqyQ3RAsoFjPKMJup5K +hAF5g26em6m5csbMZSvBO2AGunXmEYIpmyA7I9oedkqKaKcgYV2Lv/m8i1BDRiFicwq uzSvVc8Pu9QLMS5LhI6cZBYqiX8wz+m+tpfLDsFBptVkj8ax8ZyXpOYQmCHpN0OFsakb MSYOH4lAwC9fG1Dwn0YR9sqx+enc1YtQCM5MKsxF+OXjkAQarQLJJuVcQtj6+mRoPswL bqkJxNHJEhCczAvVcc/zHuLsWhagPxKUib1zMJH5oPiO+8202WufUIadL97cDvuf+/1s cxSA== X-Gm-Message-State: AOAM533LD6FwR3G4Z1oxknSoI2nzYNEhJMeUnal/6Gux5ku9kgpGoz3l pzRLr1XJ0uCSOpptwWHWskyjpg== X-Received: by 2002:adf:bbc2:: with SMTP id z2mr3207702wrg.180.1615972365666; Wed, 17 Mar 2021 02:12:45 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:45 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , Drew Eckhardt , Eric Youngdale , Jirka Hanika , Richard Gooch , Torben Mathiasen , Alex Davis , Douglas Gilbert , Badari Pulavarty , willy@debian.org, Kurt Garloff , linux-scsi@vger.kernel.org Subject: [PATCH 06/36] scsi: sd: Fix function name in header Date: Wed, 17 Mar 2021 09:12:00 +0000 Message-Id: <20210317091230.2912389-7-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/sd.c:1537: warning: expecting prototype for sd_ioctl(). Prototype was for sd_ioctl_common() instead Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Drew Eckhardt Cc: Eric Youngdale Cc: Jirka Hanika Cc: Richard Gooch Cc: Torben Mathiasen Cc: Alex Davis Cc: Douglas Gilbert Cc: Badari Pulavarty Cc: willy@debian.org Cc: Kurt Garloff Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/sd.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/sd.c b/drivers/scsi/sd.c index ed0b1bb99f083..91c34ee972c79 100644 --- a/drivers/scsi/sd.c +++ b/drivers/scsi/sd.c @@ -1519,7 +1519,7 @@ static int sd_getgeo(struct block_device *bdev, struct hd_geometry *geo) } /** - * sd_ioctl - process an ioctl + * sd_ioctl_common - process an ioctl * @bdev: target block device * @mode: FMODE_* mask * @cmd: ioctl command number From patchwork Wed Mar 17 09:12:01 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403078 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294319jai; Wed, 17 Mar 2021 02:13:31 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxzR114qMRyd1xI7Uioe3A4His24IipkTj3qAfdnjKUBlBTYLR60KzYscVYTJVAdVj6eOGs X-Received: by 2002:a17:906:f10c:: with SMTP id gv12mr34344343ejb.53.1615972411587; Wed, 17 Mar 2021 02:13:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972411; cv=none; d=google.com; s=arc-20160816; b=B1LObG5/Yg/2HHlvlgT7C5HC8VZkIGAe2DFeLMei0r3Ms0ei8XPck+Y6vDxZlB05zQ sbP7BgIykl1LyEBEhLJjbqRgxzXqdktIZCa5HcPPu0whTpKfY0q2qjiwuORK4Sq82Sm8 RuAj52e1Z+lZsktBopSDUEIf6uASPlh5EDqXDnRsE8A8ITnNlgzNarz8si40Ds1QRE6F 763WI1py2paqCQbALEaj+oRbAWnp64l4OgAEoBDgywZb/bXcC8yOdnqZ50HQo0a2Vqdb HDoBGgJ3J1wHdTOD3ybLHdaA5Av4ZvefDdqWHvUwt/mU3wYvtShvGssDeHmmWRtAwsvl p7EQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=ju0nafCi1O1H+VksywNmGUTcL4SOkVENGA5NZEQLAiw=; b=LDub9PsvmV0haKvFy0wTovJgl18M6bRhlZS4FG2OKeK0OWH2PM+io4w0kjeiOzZ4Hn HYi3XlxVbWd02Mr0o5+UG+bodFI7ZO1Mj+XHh2HJfquwGSTsEGrrD5sRJWdsYkAivslo ssuNmlgpWrkz9p2vbi/wrHESjA21d5pTBygfglOhi00Lqe7TBgt9EEAREiAZJQBlgKkW 68AyVlAgcwCn+CvRwNs91V5kCEPfioKpsDcNPf5sUuGQcxA17D40PHASOYHbh636K50c z8U6JPNauNXtakDJRWec6M5WEygBNejvSq4mUbGMjv1xPDY4jZogrG2TmV41frkrvZK5 rdzA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="pWT5ZE/u"; 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 t15si15461864edq.164.2021.03.17.02.13.31 for ; Wed, 17 Mar 2021 02:13: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="pWT5ZE/u"; 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 S230182AbhCQJND (ORCPT ); Wed, 17 Mar 2021 05:13:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42646 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229873AbhCQJMs (ORCPT ); Wed, 17 Mar 2021 05:12:48 -0400 Received: from mail-wm1-x331.google.com (mail-wm1-x331.google.com [IPv6:2a00:1450:4864:20::331]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BB6D2C061760 for ; Wed, 17 Mar 2021 02:12:47 -0700 (PDT) Received: by mail-wm1-x331.google.com with SMTP id g20so1017541wmk.3 for ; Wed, 17 Mar 2021 02:12:47 -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=ju0nafCi1O1H+VksywNmGUTcL4SOkVENGA5NZEQLAiw=; b=pWT5ZE/udqJFqJG/0FLccNuDLSdqXLiitLqZdOFgO0hqwLKkt9UhHjYinOUBujTEd2 v/mjiGlFXO+o8TM9wOckdKXlDG8XD+j0rtLpdOn/v45uM73eic62HdOQ7W2B79bY1EHh wqDF8Kw3KxUDs5t1GoEZ0Nll2D58WdQAtZPK2uFp2FoSugqV3J1p7MuAlP4OTGvM8IO4 tIVXY3iHUI3pzVsnYY6Dz6PgT9CPn/cN9UxUvs/IJXq7TkkK/3j3iGAK6ZAQUMBIPvT5 2osJrCW1aqJS7GG0EECxLHUGN3FajseSgKoMcKC1/kJ1IKsqoKIsvuzD2Q5ds4WkLRHX 1KaA== 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=ju0nafCi1O1H+VksywNmGUTcL4SOkVENGA5NZEQLAiw=; b=mch7LDZ8UJmyRZcQ176QKQBnQ4IylvD+X/sdK5ZjUJ/4sSbBduZHY8VUdxeGZ8/dl4 WD0QHG1r3OwL6aNcrH0F/7/8bUcQ+CWAftU8GMzuqkcLQSghV0APEBjWXonReOlLJ8ua isHb8pjXikEedIoz7VypzlX6sfnV+EGf5CKWF/EgFlU+Cf7d59jydxVeZb1MyEX/Hqrv p+2XDsvIjlt8uVjUGSDHrTNNeDzy4XIPXW8DqpQ1Y7QaZxK8N4eMVj/bnSA91v/4wILE X6WOdRo1+HsVckQ5cBzRvn1rn3sKRQPz0f6ZcLLnUw/yUmKb4jzCuZ3b5r9XSoLxYj9U b47A== X-Gm-Message-State: AOAM5323XScYjk6pyGLnTQvTpk5Qg41T/To7MJ5WPfR1gUPgYSijqJAA EXmsonkO5LthswFtFvKaL9HAYQ== X-Received: by 2002:a05:600c:9:: with SMTP id g9mr2772291wmc.134.1615972366574; Wed, 17 Mar 2021 02:12:46 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:46 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , David Chaw , Luben Tuikov , linux-scsi@vger.kernel.org Subject: [PATCH 07/36] scsi: aic94xx: aic94xx_dump: Correct misspelling of function asd_dump_seq_state() Date: Wed, 17 Mar 2021 09:12:01 +0000 Message-Id: <20210317091230.2912389-8-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/aic94xx/aic94xx_dump.c:729: warning: expecting prototype for ads_dump_seq_state(). Prototype was for asd_dump_seq_state() instead Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Lee Jones Cc: David Chaw Cc: Luben Tuikov Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/aic94xx/aic94xx_dump.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/aic94xx/aic94xx_dump.c b/drivers/scsi/aic94xx/aic94xx_dump.c index 47a663a39dcce..552f1913e95ec 100644 --- a/drivers/scsi/aic94xx/aic94xx_dump.c +++ b/drivers/scsi/aic94xx/aic94xx_dump.c @@ -721,7 +721,7 @@ static void asd_dump_lseq_state(struct asd_ha_struct *asd_ha, int lseq) } /** - * ads_dump_seq_state -- dump CSEQ and LSEQ states + * asd_dump_seq_state -- dump CSEQ and LSEQ states * @asd_ha: pointer to host adapter structure * @lseq_mask: mask of LSEQs of interest */ From patchwork Wed Mar 17 09:12:02 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403079 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294327jai; Wed, 17 Mar 2021 02:13:32 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwk+2zdJ5XX/T9FqRpgO5eiZvxG3Hb6ldM3XrxQbCHmzSIK2fjvSfy9veyLta8+DhugmiYl X-Received: by 2002:a17:906:a2d3:: with SMTP id by19mr33492220ejb.98.1615972412278; Wed, 17 Mar 2021 02:13:32 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972412; cv=none; d=google.com; s=arc-20160816; b=AauQFFyeIVPvUypONc6PA+8PgzRlxUt2nUBgSOWvTX/BMZZzjxe0UKV/UeYuUyNC+k 7r/5ZNpKW3cNcsb7AkOdVk+tLR6AAp/l89drPpYOWj4VN5DRW9whwQbQUrWir46iyz/W yCW1ZOqjA0GwdrhtuUU9EX2NqeKlR0QKM4DYGkIv0MkYIVCiCqfbaKxyLgmhDqZm9oBQ d+IB5jY4jYCZiTfpaWVQhZKHMLMvRbD/HlCX5XFMrwum1hdLOAsmyfCovS9MZZqx0biF 7XN/vJXKw0pyvy2umv90KzxmtbZYi8Jtv9vDnfeXSQynB5QRGcZAru4TrFumQ+CgofY6 lLWA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=JOb+P/qw104YPM5H9Pk4ZXuOVMmz3snbpqZtEzxVXZA=; b=XdktNyfWTh9EvbOPe+hAPxj9orJ3QMHRyErCwQEti9i/j0BlcegznbpO9R4dw6BsDq PTKngnH8cjsPzs6afBSr89riWJESV8d06F8GD6/p9/N1iCo1jyubgvLJv2FOJQmhxmBe emyxbsBS5uHJVr8DFQNqxO+F+5AcEqGT1JksQcLMB89yM30XWaCECA1W24MhHCvI+q1j fVspKAPi2A+Zdiwqs2j1/wTH6inFUOwnEJ2ldHuEH9aLmJaBoFLU35FD+4vk1rQv02rP g9T5J3LEuCfWeno+zBvDyVGS1HT/VMT14A0CN3eIaTzHGCWrsLjQ1Y9TsabRZRo+arQY pngQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=F1h9Xpvv; 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 t15si15461864edq.164.2021.03.17.02.13.32 for ; Wed, 17 Mar 2021 02:13: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=F1h9Xpvv; 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 S230224AbhCQJNE (ORCPT ); Wed, 17 Mar 2021 05:13:04 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42668 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230194AbhCQJMt (ORCPT ); Wed, 17 Mar 2021 05:12:49 -0400 Received: from mail-wr1-x434.google.com (mail-wr1-x434.google.com [IPv6:2a00:1450:4864:20::434]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 154A8C061762 for ; Wed, 17 Mar 2021 02:12:49 -0700 (PDT) Received: by mail-wr1-x434.google.com with SMTP id z2so1002513wrl.5 for ; Wed, 17 Mar 2021 02:12:49 -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=JOb+P/qw104YPM5H9Pk4ZXuOVMmz3snbpqZtEzxVXZA=; b=F1h9XpvvlAIfIaTIkV910sK2Dtfb9XwkVVfR/pBYqkkhyXvxA6dE/288OwsBxgb0+h kuNekb0Wva2qFigdWkqcNEOXvOoiAUK7KKb20zkPxk3Lo2IBg4gCQ/S7x40AXiIcVXBt xaHoN3HLXxGGbrOLe0/O1u3xMDQtPiK6bM0lD2QhG48Qfskhi+Qc4vaT/ImCWVMN8h1n UhSpU54xHEmcIz6v14p2tFZ5sMcJjalNQWiOrErgbSYL3499emaJbMxxwmsVHwIBIrTy W4lX0d9BiGRxtBPKYqxWnFJwWRZq/dfZ/SQpX9SDzU9Jwc9sBPlDwqV8+oMhIluNllQ0 TMLg== 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=JOb+P/qw104YPM5H9Pk4ZXuOVMmz3snbpqZtEzxVXZA=; b=e+8y2rqxFxWMBQQmERfhR4K7XW9Bvan+o2UQ7i0MsLlkJ9f1WPSe4QtQKRdmOPhCjq wokkvxl4MrXa5wZf8MlW8y5IMKTKR48XCcyktqgD/jq8FDNLdI4Xxo8P98Z4SnRfEWw2 U+3gIKe9kSoHExLOzmk9coJEyhTWrxtjJLc+v3F4lweEC2ZIebARMfK9WAHRiyLCXm+F 2FE7VNs2vg4U5P8T+tJXdqG2rX4dPg5RoKVIBot6fZkh7g5/SxuH0Xv92AzEOxAmEI4b OHZpjSrLg4ADfUI+9YI7y0xKZoxS1jCozdNVL+8RzXqrih43KWaUg7YKwm5sIYzErkrm 8GuQ== X-Gm-Message-State: AOAM533tbGsa/HEK4Gm1VlsZQjoILiHWqCqaF/v4rWbVQVOFLvSOdZkQ Z9VI+X7lsnVLdSFIfQs3gs6WmpXLKblZlg== X-Received: by 2002:adf:df10:: with SMTP id y16mr3323925wrl.372.1615972367856; Wed, 17 Mar 2021 02:12:47 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:47 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Subbu Seetharaman , Ketan Mukadam , Jitendra Bhivare , "James E.J. Bottomley" , "Martin K. Petersen" , linux-drivers@broadcom.com, linux-scsi@vger.kernel.org Subject: [PATCH 08/36] scsi: be2iscsi: be_main: Ensure function follows directly after its header Date: Wed, 17 Mar 2021 09:12:02 +0000 Message-Id: <20210317091230.2912389-9-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/be2iscsi/be_main.c:4935: warning: expecting prototype for beiscsi_show_boot_tgt_info(). Prototype was for BEISCSI_SYSFS_ISCSI_BOOT_FLAGS() instead Cc: Subbu Seetharaman Cc: Ketan Mukadam Cc: Jitendra Bhivare Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-drivers@broadcom.com Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/be2iscsi/be_main.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/be2iscsi/be_main.c b/drivers/scsi/be2iscsi/be_main.c index ab32ca535078d..eac67878b2b1b 100644 --- a/drivers/scsi/be2iscsi/be_main.c +++ b/drivers/scsi/be2iscsi/be_main.c @@ -4926,14 +4926,13 @@ void beiscsi_start_boot_work(struct beiscsi_hba *phba, unsigned int s_handle) schedule_work(&phba->boot_work); } +#define BEISCSI_SYSFS_ISCSI_BOOT_FLAGS 3 /** * beiscsi_show_boot_tgt_info() * Boot flag info for iscsi-utilities * Bit 0 Block valid flag * Bit 1 Firmware booting selected */ -#define BEISCSI_SYSFS_ISCSI_BOOT_FLAGS 3 - static ssize_t beiscsi_show_boot_tgt_info(void *data, int type, char *buf) { struct beiscsi_hba *phba = data; From patchwork Wed Mar 17 09:12:03 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403080 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294335jai; Wed, 17 Mar 2021 02:13:33 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxleQi5z0I7z6MrBT6ErpW+7mmgH2fODBQ6t7pcED2Sqfm1xxSbIYFiFScDov0gvMz3AWeL X-Received: by 2002:a17:906:f891:: with SMTP id lg17mr34533692ejb.69.1615972413471; Wed, 17 Mar 2021 02:13:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972413; cv=none; d=google.com; s=arc-20160816; b=G06cukrrtkr++4j7pRfcyUt8oNOzhZywK433AJO6lqcnD1nf/MEYkh35uoIrRf5ZQM Hin9Q0cc6GLw3L7qDfKue3IQ9vbqJ8qnFzTsNUbiAnIrt0pBAmwY9tAm0TKRRhx51Pko e5mCR4CKJ6PJNVnSIr4TvhziB6Ju/1H+cK3eP9CC8urg7+Cq0nXLo0vu3AFpNcFBR9rP 1QK3ofgkr8Oz0rZPK+B/x+JZhKtHLu6IAcC/8SRc7hm0z0VxmwH9LSjROYYW32/Zw5lU a83q35uP/6vi5Jyh6tfRBfejIYTzRV3lW07vnFKFDUf8Uq48gtmMjaYXCdp+VhoE3Msv 5mlg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=+cTXQTsH/Sbo5QzGWeCU2MjhmNBDgdRBi7pc9b8SsmM=; b=N1rE13AwCBKIMhTgxBg5SBDQxe1DuJlgmOZvYXd6gXIqQEUkodjF0TZVMob5H5KS0L HPTFf1O0bQBkJYHto5nAh83cFirXPz7OavUljiTQQ+Mdnu+gUK4MSHMJzcMUk6fkrqut 2zay7LsL1b3S/ib/0d61NulaPrD3MswDhqap7DKZoFxskbVIrXvyoo6vT8ziuW4hjzXy 6WwYSb0cNFDZ10QSCxnluNwXxygubViFAKOCQEOw92H3SRSA0Ky6Ek6E74smo51daqvf 3LeQ7sVjKsVasp20sbsL3uq8y9RlztLhNa33sQ9/Ytte37DCiFi74ng7eOU9RJfGgrEF 0B4Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=VYhSNkK+; 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 t15si15461864edq.164.2021.03.17.02.13.33 for ; Wed, 17 Mar 2021 02:13:33 -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=VYhSNkK+; 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 S230236AbhCQJNF (ORCPT ); Wed, 17 Mar 2021 05:13:05 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42646 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230196AbhCQJMu (ORCPT ); Wed, 17 Mar 2021 05:12:50 -0400 Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 06FD8C061760 for ; Wed, 17 Mar 2021 02:12:50 -0700 (PDT) Received: by mail-wm1-x332.google.com with SMTP id d8-20020a1c1d080000b029010f15546281so616967wmd.4 for ; Wed, 17 Mar 2021 02:12:49 -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=+cTXQTsH/Sbo5QzGWeCU2MjhmNBDgdRBi7pc9b8SsmM=; b=VYhSNkK+JDvxaEmc3cWAiu0oGoUR+6g+rSTKcBpFdz8wa43BR/IgIZj5E8XtoWoQpW SquXLOqc70jaB0HmeT4WGikLKxwDP4k8D4xwliE/brjI+/xnZ9hIM/juN/LNu3xw+Xnf A1Ok6qqfvoV7mRusCOcAGvafZNT3c1mIRTMmvew9G+LEtUisK+e+SfPTBDJJBCv8ZQ2e ssINX80lsZIijxEIMMtgvf9lTfLJO2j8ZVYWvHZOuLw404fiTjkOgePdQRnVsJrBHm5N TbPMQZrw798p5fPCCJkf4I4Z+oSumTsauziu0BvMYuSHs66hyMpTmkp7aKTAdEAN+nP8 OERw== 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=+cTXQTsH/Sbo5QzGWeCU2MjhmNBDgdRBi7pc9b8SsmM=; b=qH9i2yTnO9+IKGtI1O6r0DRWmGAi1rUKaBL8dLNo5D+9CShcbtijQkdY9oLfxYYyjD UtTYYsnoPogaf3wz/EGUmCWlBLM2afM1Bq3MfFtnUL5zuEIIpIcSQ581jYRj7E+cp9aV 2/FNYQ9tBImIJYWHtCJcfv3NKldXPLdQ6XcWBxBi3EJZWxEGz3vSOyNbRe8DSnSlz7/n IRKvwLLYXEcWuUPMAG/d7UWZrFTs/iaLHC8UnBwAPtjliTo+0zzDRMiiyvCAwYWA/esg H2/17xD/27BKYk/ZEax8AqB3p5xOGs3bGCLp2vB+ZwXbtlzBOj+S53UNPefPuuE0+1qp FpGw== X-Gm-Message-State: AOAM533JmX1WFcibtwew9ZclcI9PkprJJIJMffhYx3txIKTTQVKdxvvu DNSr7xz8Hb91rfyAekT7EJbn9g== X-Received: by 2002:a1c:7519:: with SMTP id o25mr2646901wmc.35.1615972368750; Wed, 17 Mar 2021 02:12:48 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:48 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Oliver Neukum , Ali Akcaagac , Jamie Lenehan , "James E.J. Bottomley" , "Martin K. Petersen" , "C.L. Huang" , Erich Chen , Kurt Garloff , dc395x@twibble.org, linux-scsi@vger.kernel.org Subject: [PATCH 09/36] scsi: dc395x: Fix some function param descriptions Date: Wed, 17 Mar 2021 09:12:03 +0000 Message-Id: <20210317091230.2912389-10-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/dc395x.c:4353: warning: Function parameter or member 'acb' not described in 'adapter_init' drivers/scsi/dc395x.c:4353: warning: Function parameter or member 'io_port_len' not described in 'adapter_init' drivers/scsi/dc395x.c:4353: warning: Excess function parameter 'host' description in 'adapter_init' Cc: Oliver Neukum Cc: Ali Akcaagac Cc: Jamie Lenehan Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: "C.L. Huang" Cc: Erich Chen Cc: Kurt Garloff Cc: dc395x@twibble.org Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/dc395x.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/dc395x.c b/drivers/scsi/dc395x.c index e28f8931e23f8..5503230006f87 100644 --- a/drivers/scsi/dc395x.c +++ b/drivers/scsi/dc395x.c @@ -4341,8 +4341,9 @@ static void adapter_init_chip(struct AdapterCtlBlk *acb) * tables etc etc. This basically gets all adapter information all up * to date, initialised and gets the chip in sync with it. * - * @host: This hosts adapter structure + * @acb: The adapter which we are to init. * @io_port: The base I/O port + * @io_port_len: The I/O port size * @irq: IRQ * * Returns 0 if the initialization succeeds, any other value on From patchwork Wed Mar 17 09:12:04 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403085 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294580jai; Wed, 17 Mar 2021 02:14:03 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwUW7PJKNB7+AbBSrbzrz8A+/oPwUleeL4sKUgu4Gfhx+KvNjC5wK7YFbD+TU0JI5s0AwdU X-Received: by 2002:a17:906:4801:: with SMTP id w1mr12565200ejq.475.1615972442971; Wed, 17 Mar 2021 02:14:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972442; cv=none; d=google.com; s=arc-20160816; b=0psFYj7aYcku2ZroToLLhfHbnY6zBgt2fmC/b0lKLAJ/TDzK4fhJMWMgDq1sOrQUl5 oiKsG/0R6OmYnw6ghsZ6+7jagJcbltPiILOgucbXD+kmCnmdNrK2ZWnNeoXacm8EuhOy 9VLLQCT9qTEd9w3NBUr8iaNFQELUjAWJHk/OX320md5cuySoAxoIwAVc6SBWQjfm+0jP 4Zss3ruzt5QDNATTafNBNdhZm+uQHGfCnAfTaFxqe7I+McaauGO1LabdlbLdyOhGbJ18 TVq/rjlh1+UXKk5bJmLun0n9rggnYeJ87Dq0fuUKtHUyk2ycZS6xYU3YIjLahi5WHnr+ 2OSw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=mmVm22Z3SbJdFCwvYkYccZgvkOVfVFM6WIi4/sN6y+8=; b=Sk5VWeAF+T9HRV+fEbDK+hQHu5PuI5Nvb/VCzar9HsNQzNRF89RGeFOhy51tc4+P07 QfJsyQlgTJpWE+ilmrDQNhwdKS6Ul78jlzbOcLp3pITkGIGmCq2oQ/b/rVUZyrb3wAlY qdqPurPDwX5RNhwS6ue1SSkKLRbg88nJZwj070ZbYrXCO3UqZIRLZXkgL+PgzdngdxPg CRLsVlNSoWNFn9aSqBRinHHq/+Q8FCHVk7qylFOmj28K9mURiSqSDzrUSJDPJFsbUJn8 3mQEDLQ2Mqq4O8DgxUw7CITKLbOMCmXfP20khuu9Ewheqj7oBEwcWZLPDbCtBh+1vslA IhZQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=a8vNEuCV; 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 t15si15461864edq.164.2021.03.17.02.14.02 for ; Wed, 17 Mar 2021 02:14: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=a8vNEuCV; 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 S230266AbhCQJNf (ORCPT ); Wed, 17 Mar 2021 05:13:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42646 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230020AbhCQJNA (ORCPT ); Wed, 17 Mar 2021 05:13:00 -0400 Received: from mail-wm1-x333.google.com (mail-wm1-x333.google.com [IPv6:2a00:1450:4864:20::333]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2CA8AC061762 for ; Wed, 17 Mar 2021 02:12:51 -0700 (PDT) Received: by mail-wm1-x333.google.com with SMTP id r10-20020a05600c35cab029010c946c95easo831806wmq.4 for ; Wed, 17 Mar 2021 02:12: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=mmVm22Z3SbJdFCwvYkYccZgvkOVfVFM6WIi4/sN6y+8=; b=a8vNEuCVQ+NCgglSdOUubA+3RisCfA1ki5nIjhK0BEddlRmSgWfN4sHriI2fdIdBuf 8Pth22d+tt8RMPzpAZgGELwc2SBNboK2J+nKe9KsqiWyQ4cA7PskHQm7w7o/JsxyWwVT 29vbkqQ8w1yQfAI6qmM5cbLoZvHf4PL21ialqbZEr4YwjN2AtvXQqShzQFugx7uhQqUM hJaaLDDaQ4Sx3IdKTqHHtOUwWq7Kx3oKDrmROilDu+Cf3gYXsjbJJ1/rxe5YPLvQS8Od +4CXHI4DRZ9GOdwFBK0H8+bw6MMhPyqS3DuHLRxlc5xfC6hxEzEt5AcLoqkg68mr3nq1 EyfA== 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=mmVm22Z3SbJdFCwvYkYccZgvkOVfVFM6WIi4/sN6y+8=; b=syvN6HGGW1REoQgzcvxHlU06+SDJP/pA6+u0Pac2LXBGyhlQ5B/qVng3UjRMEwmqf4 bWSEz3SGnBlvjis9hAwrh5MaiwO4R7WYdQzAcjiNjx2rZeGtph0UCEF3+hN1/JfwlRH+ 36cQxB3KZOEi5I6AIbWIrvS4fJ4d+cZkbj5HB+CwVWGFZBT+tjXmpKQUkUuxJGCObwIT ATkH2a07qllrWDUY8UBqvZyTW4RPYIFVL8xXKIXwQ4zd0Yi36fQ2kthYfuzz4dtp5vFh /IoDQVdwVW/6HmA2X1naZURqVUhBNX+yFK0jLAWIUvgNt818vNGiwYHYYbuZzLYlom83 E1lQ== X-Gm-Message-State: AOAM531Z7RcFA/BTW+p5JHYlDcgV1p6LsK9T6j8q4NdqTXIk5KUx7A3C sOSfCuZJq9XdE3vIGctS9ELqrw== X-Received: by 2002:a7b:cc85:: with SMTP id p5mr2759000wma.148.1615972369955; Wed, 17 Mar 2021 02:12:49 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:49 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , Bas Vermeulen , Christoph Hellwig , Brian Macy , linux-scsi@vger.kernel.org Subject: [PATCH 10/36] scsi: initio: Fix a few kernel-doc misdemeanours Date: Wed, 17 Mar 2021 09:12:04 +0000 Message-Id: <20210317091230.2912389-11-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/initio.c:560: warning: Excess function parameter 'num_scbs' description in 'initio_init' drivers/scsi/initio.c:1899: warning: expecting prototype for int_initio_scsi_resel(). Prototype was for int_initio_resel() instead drivers/scsi/initio.c:2615: warning: expecting prototype for i91u_queuecommand(). Prototype was for i91u_queuecommand_lck() instead drivers/scsi/initio.c:2667: warning: Function parameter or member 'dev' not described in 'i91u_biosparam' drivers/scsi/initio.c:2667: warning: expecting prototype for i91u_biospararm(). Prototype was for i91u_biosparam() instead drivers/scsi/initio.c:2740: warning: Function parameter or member 'host_mem' not described in 'i91uSCBPost' drivers/scsi/initio.c:2740: warning: Function parameter or member 'cblk_mem' not described in 'i91uSCBPost' drivers/scsi/initio.c:2740: warning: Excess function parameter 'host' description in 'i91uSCBPost' drivers/scsi/initio.c:2740: warning: Excess function parameter 'cmnd' description in 'i91uSCBPost' Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Bas Vermeulen Cc: Christoph Hellwig Cc: Brian Macy Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/initio.c | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/initio.c b/drivers/scsi/initio.c index 926a7045c2e5c..9b75e19a9bab1 100644 --- a/drivers/scsi/initio.c +++ b/drivers/scsi/initio.c @@ -546,7 +546,6 @@ static int initio_reset_scsi(struct initio_host * host, int seconds) /** * initio_init - set up an InitIO host adapter * @host: InitIO host adapter - * @num_scbs: Number of SCBS * @bios_addr: BIOS address * * Set up the host adapter and devices according to the configuration @@ -1887,7 +1886,7 @@ static int int_initio_scsi_rst(struct initio_host * host) } /** - * int_initio_scsi_resel - Reselection occurred + * int_initio_resel - Reselection occurred * @host: InitIO host adapter * * A SCSI reselection event has been signalled and the interrupt @@ -2601,7 +2600,7 @@ static void initio_build_scb(struct initio_host * host, struct scsi_ctrl_blk * c } /** - * i91u_queuecommand - Queue a new command if possible + * i91u_queuecommand_lck - Queue a new command if possible * @cmd: SCSI command block from the mid layer * @done: Completion handler * @@ -2650,9 +2649,9 @@ static int i91u_bus_reset(struct scsi_cmnd * cmnd) } /** - * i91u_biospararm - return the "logical geometry + * i91u_biosparam - return the "logical geometry * @sdev: SCSI device - * @dev; Matching block device + * @dev: Matching block device * @capacity: Sector size of drive * @info_array: Return space for BIOS geometry * @@ -2727,10 +2726,8 @@ static void i91u_unmap_scb(struct pci_dev *pci_dev, struct scsi_cmnd *cmnd) } } -/** +/* * i91uSCBPost - SCSI callback - * @host: Pointer to host adapter control block. - * @cmnd: Pointer to SCSI control block. * * This is callback routine be called when tulip finish one * SCSI command. From patchwork Wed Mar 17 09:12:05 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403092 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294664jai; Wed, 17 Mar 2021 02:14:09 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxvVCcF4vjwiOSu8RVFoMMrf7LIEeezaG2vsnr0j143IXo0NkN2Jk2hsB2rVKg2idkyejzW X-Received: by 2002:a17:906:c414:: with SMTP id u20mr33935543ejz.215.1615972449221; Wed, 17 Mar 2021 02:14:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972449; cv=none; d=google.com; s=arc-20160816; b=bhYjilBkf5nlhC8tW05a3rKH7/OoR7018qCY+ekPhGCwfCUlu2NntIBIUnscVZ1iPt hs6Dxi3sxY/8plSnx2kvgHcz/lr4VK9fAsWADWnyyWFnyhgWLwWwrtjcR93euw+kXq+I GLfhE5ev2O81tKBW+W8LnSYRh/dv17s5HLCYw022PddMhMpTGhE6L2U3rz4PRYNw/kfQ IlXE81NF2wKW208hJgnbpAIZ5IyUNRdIXxTitv9XmX8NFIiXR9AW8wM8Lv9YZqSbMZgK 5hiY24xo+jslJUOiXzbljrR3JCIT8lfqmfjPIdsds6VNYWSYcIXeHTf1je7FjoaQWTL2 MV4g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=Kpxpj9RY3Tz1buvtlliu/SfUSZOzhZdJwGgmrjmjL4c=; b=MKm+Y+0MyzMoyKrp94/eueTNCmZuDKxW8cbuUUf6fPT06Kezg7Zye3mDryYTSwJthP dMaxtQMllqxYUJaFYsWF4PawCRLjhR0LLp8gYPjl+HDtomO3MjPLwjUdtjEZl5bzjh6m HW4ExBnI23BDsmp89Aot3AghzAjjTkWiPWMbN5noaZ+3CYpSa3DSHNxTc9c8Ft0m0/t5 xefTI6TmnIpj5XAF587CnlQuJ1P5UqJqeydI+KXyJmiwJiZQa+XXLpp3m/RHSuqPEKft S1l4Gx56qtdmb6eQ+Ais9B3yp3yrhVbvSfDj+i3hPLGp2t1jXgko/i+0l3HfkrTFoqUQ kiTw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=ENZefxfv; 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 t15si15461864edq.164.2021.03.17.02.14.09 for ; Wed, 17 Mar 2021 02:14: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=ENZefxfv; 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 S230527AbhCQJNm (ORCPT ); Wed, 17 Mar 2021 05:13:42 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42682 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230024AbhCQJNA (ORCPT ); Wed, 17 Mar 2021 05:13:00 -0400 Received: from mail-wm1-x335.google.com (mail-wm1-x335.google.com [IPv6:2a00:1450:4864:20::335]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 786AFC061760 for ; Wed, 17 Mar 2021 02:12:52 -0700 (PDT) Received: by mail-wm1-x335.google.com with SMTP id 12so1009672wmf.5 for ; Wed, 17 Mar 2021 02:12: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=Kpxpj9RY3Tz1buvtlliu/SfUSZOzhZdJwGgmrjmjL4c=; b=ENZefxfvp2SbLaisye3tgbpbWWpQrCXHaTbdFnQ7jF7oVLFWuLPED510b4pzbTPx6T qJ5UbDkPqrEpjwDmL0+UAsVELrgLAvENpJPTWWlfYh2eQlxjTRuPukX5GWJKNpEghVUT W4Q1LEGGpAYTMeQkwi1t1LW6I/GWJB5BSOfowD1op7cj4/CdhHZTn1iAR+CMfkBYyT6s GbNmu/FnHvKkj+bOPh3PZKlJ2/C7BtTB5lvFL0si86sLj3r33gFpxhMQAAL+DuV/6OsL 6EYXH8JojSR2IBU8VJro4y67zxHzg5ab2q9OSE56Z8HtpjPSKA4x/mhmRZ8zpOeY7Ly1 befw== 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=Kpxpj9RY3Tz1buvtlliu/SfUSZOzhZdJwGgmrjmjL4c=; b=ebDrsNotUsqPIjjGZKxOD2lEbrY6yqyO3MO/O35zE6inR8Zop6yw661LOdFwCgs4uS BsnDNCtJCSmvr5TCM5kL3yixHHIs+DaL3LKcG4TstrmQzCBs8cuSMjU5XbXMWZ4pS8IG t15pmPub2PNjUgIk92O8ir9rriKrRLPDwHu2DCBJh0fPfYgMAyaWBH/NJSc8DWRe1TTG 5L0gqVNTXS5rkpaHYuEZwnYljpwVItbAnZJzWOulvXLyS/NT+mW8psab5We3JBvYzpAa Mhb5PyTTZunh+HBi2heNSFToqqIAnECcsx+2omKR/Wis2g/gterAsSxgRW4kEtECRNHL 6r0g== X-Gm-Message-State: AOAM533klSZODwzfRrSDmI3hqOokL6TPRpZv4l7Ejk/jHLzjnZ0XMlDm EH7OSR/rpvGRrH6Lu1iFfFkANA== X-Received: by 2002:a7b:c3cd:: with SMTP id t13mr2675160wmj.109.1615972371169; Wed, 17 Mar 2021 02:12:51 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:50 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , Doug Ledford , Christoph Hellwig , Alan Cox , linux-scsi@vger.kernel.org Subject: [PATCH 11/36] scsi: a100u2w: Fix some misnaming and formatting issues Date: Wed, 17 Mar 2021 09:12:05 +0000 Message-Id: <20210317091230.2912389-12-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/a100u2w.c:278: warning: expecting prototype for orc_exec_sb(). Prototype was for orc_exec_scb() instead drivers/scsi/a100u2w.c:596: warning: Function parameter or member 'target' not described in 'orc_device_reset' drivers/scsi/a100u2w.c:739: warning: Function parameter or member 'host' not described in 'orchid_abort_scb' drivers/scsi/a100u2w.c:739: warning: Function parameter or member 'scb' not described in 'orchid_abort_scb' drivers/scsi/a100u2w.c:915: warning: expecting prototype for inia100_queue(). Prototype was for inia100_queue_lck() instead Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Doug Ledford Cc: Christoph Hellwig Cc: Alan Cox Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/a100u2w.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/a100u2w.c b/drivers/scsi/a100u2w.c index c99224a128f82..c9ed210d77b39 100644 --- a/drivers/scsi/a100u2w.c +++ b/drivers/scsi/a100u2w.c @@ -269,7 +269,7 @@ static u8 orc_nv_read(struct orc_host * host, u8 address, u8 *ptr) } /** - * orc_exec_sb - Queue an SCB with the HA + * orc_exec_scb - Queue an SCB with the HA * @host: host adapter the SCB belongs to * @scb: SCB to queue for execution */ @@ -586,7 +586,7 @@ static int orc_reset_scsi_bus(struct orc_host * host) * orc_device_reset - device reset handler * @host: host to reset * @cmd: command causing the reset - * @target; target device + * @target: target device * * Reset registers, reset a hanging bus and kill active and disconnected * commands for target w/o soft reset @@ -727,7 +727,7 @@ static void orc_release_scb(struct orc_host *host, struct orc_scb *scb) spin_unlock_irqrestore(&(host->allocation_lock), flags); } -/** +/* * orchid_abort_scb - abort a command * * Abort a queued command that has been passed to the firmware layer @@ -902,7 +902,7 @@ static int inia100_build_scb(struct orc_host * host, struct orc_scb * scb, struc } /** - * inia100_queue - queue command with host + * inia100_queue_lck - queue command with host * @cmd: Command block * @done: Completion function * From patchwork Wed Mar 17 09:12:06 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403081 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294562jai; Wed, 17 Mar 2021 02:14:01 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzBpThklCUc0ySM1/3689AFUtrG4cwBlmAiyVTcIIqOGLjOAEeOpgrg1tP/rb16h5Ad5Ti+ X-Received: by 2002:a17:906:3409:: with SMTP id c9mr33731632ejb.314.1615972441229; Wed, 17 Mar 2021 02:14:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972441; cv=none; d=google.com; s=arc-20160816; b=PRT7PLUtaNldlPDRzDMgVQHT6h5U0YkDSMhXiqmoFxcKWWr7bkqHr4IMxxNdmyL+uA 1QxuHhUGepKGUi7rk+yO1XH7oHBJa/cvdM5+2s8Xkeh7ETsk05PI/jwa/goz/+Ye/Cy4 Nh7L/Hij+FqaljKW7CAkLgD5DdvksmcUaJrxq1o1AXn1CqOVtFh/7gcV88tB2QN4iDeR cmzjnWEs3v7ab1Fm+q5Y9XlR/9oK1b7chK24iYPcWarWhgnJ7kRRz/2gyzbtHed1yQlt Qr1jwnWHEodzFLHDAuHB2g+JxzN4qlV2batHIvMNtrs2nJD0q1qR3aaQ0xf8RZJoivDm DJZw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=+TrWWm0u4bkRuEOT45xP86ethIB2XLy+WRaBoR2YJ+Y=; b=fHU4cBUGZR41Wppa/EfvgNhaCp/aBbh2VMOaNiBnjohl5h5z+yUMMkMkaDESIV02cG e1937NONRbgzBDiofHLlua2lQl5onDz3s4QtZXKbuuWgKMRX5/nKNJgPMwEtIKWDIb3B uu83FmmaSzkLH+vkXHG9kmSkMR4K+BF6T7JhxumLjYg4aF+FcSe48jVWgOM/8fryDZ7N WXIl90HeYHSMNvb73i9aLBkTkn5EuLfHLC9xJWMXIdqWj1o/+oFu9rvjslTaMDFRkTTf 3d3X9/hOV0umFsE76oKswqya2ujUr+kV1Y+ISrHSA5LdtdVzgP9y/weCl9tzbeDYV9pc 5oeQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=VIU7VFuz; 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 t15si15461864edq.164.2021.03.17.02.14.01 for ; Wed, 17 Mar 2021 02:14: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=VIU7VFuz; 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 S230453AbhCQJN0 (ORCPT ); Wed, 17 Mar 2021 05:13:26 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42668 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230205AbhCQJMy (ORCPT ); Wed, 17 Mar 2021 05:12:54 -0400 Received: from mail-wr1-x430.google.com (mail-wr1-x430.google.com [IPv6:2a00:1450:4864:20::430]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AB429C06175F for ; Wed, 17 Mar 2021 02:12:53 -0700 (PDT) Received: by mail-wr1-x430.google.com with SMTP id b9so999260wrt.8 for ; Wed, 17 Mar 2021 02:12: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=+TrWWm0u4bkRuEOT45xP86ethIB2XLy+WRaBoR2YJ+Y=; b=VIU7VFuz5FaJXnrl9FYPf3rxVYPBQWgLnoJoYBjIu9hzCiLb2B7JVy56eYs6thk9pp nh8uALrJCoQWEGtoLIqMttVd2Gsig45UXefS1V8Dz6B4oPieaTqX8td379g90niYUFbJ goG0QarAtS3jmh6e5kQmM+C6LHSBySWO7ovtr3QSVC21mDhxEIgSFY7Uzb0GMeb5Vt51 K1zcE86PVNtkzSMJjp0c1Ba/1iClc4t/qBAVz5PPxLKbMZPJp0Elc2TonTJREObJc3Hi JFngZUqZhXxF8RS+wR8kjCNsZi7mfDYTaQDlgCnkV6bAsIsEvcMnSRdzBJdcjFI7Pbb8 As0g== 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=+TrWWm0u4bkRuEOT45xP86ethIB2XLy+WRaBoR2YJ+Y=; b=CX/iw3fbl580spI6XhT/EhHg3dGl1Tcoif9pg6OXR9uF9TtDK+h7/CbKn6FiZjjRLT SQEBjuDeuw3GIHLpV5nAdor09EUwUebaH/IUHvOax6tGukKdzgAIHufEusPIRQqdJFT1 T+ZcyBeItMjplQv3oExKK3zIvW0IUCeg/zqTSbcGrhrJKhQdMIZB4f0iveTjMkW2QWpX iqWvsd6EJzbgFFIl5Ae50DZr5hmPFfFMKQhAXWqiR+xyUlyh82nKHarLwl4VGD7FjXaE 59fe77wGFnMoTcnyqLgMBLoB+gTYVQG4/bDhi4OSvoXOQVej+dnuhMamjfUx2o3vs0Sm ZNUA== X-Gm-Message-State: AOAM531zEddhxkGQ840e0yrpNoPveQBuV8CyLXf1BrVfY6CvuxVaG2nN OerhJKWYpu0jmuxghO6kS7R/FA== X-Received: by 2002:adf:e7cf:: with SMTP id e15mr3375157wrn.346.1615972372441; Wed, 17 Mar 2021 02:12:52 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:52 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Hannes Reinecke , "James E.J. Bottomley" , "Martin K. Petersen" , Linux GmbH , "Leonard N. Zubkoff" , linux-scsi@vger.kernel.org Subject: [PATCH 12/36] scsi: myrs: Add missing ':' to make the kernel-doc checker happy Date: Wed, 17 Mar 2021 09:12:06 +0000 Message-Id: <20210317091230.2912389-13-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/myrs.c:1965: warning: Function parameter or member 'dev' not described in 'myrs_is_raid' drivers/scsi/myrs.c:1978: warning: Function parameter or member 'dev' not described in 'myrs_get_resync' drivers/scsi/myrs.c:2002: warning: Function parameter or member 'dev' not described in 'myrs_get_state' Cc: Hannes Reinecke Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Linux GmbH Cc: "Leonard N. Zubkoff" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/myrs.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/myrs.c b/drivers/scsi/myrs.c index 48e399f057d5c..588c0de006b02 100644 --- a/drivers/scsi/myrs.c +++ b/drivers/scsi/myrs.c @@ -1958,7 +1958,7 @@ static struct myrs_hba *myrs_alloc_host(struct pci_dev *pdev, /** * myrs_is_raid - return boolean indicating device is raid volume - * @dev the device struct object + * @dev: the device struct object */ static int myrs_is_raid(struct device *dev) @@ -1971,7 +1971,7 @@ myrs_is_raid(struct device *dev) /** * myrs_get_resync - get raid volume resync percent complete - * @dev the device struct object + * @dev: the device struct object */ static void myrs_get_resync(struct device *dev) @@ -1995,7 +1995,7 @@ myrs_get_resync(struct device *dev) /** * myrs_get_state - get raid volume status - * @dev the device struct object + * @dev: the device struct object */ static void myrs_get_state(struct device *dev) From patchwork Wed Mar 17 09:12:07 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403083 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294575jai; Wed, 17 Mar 2021 02:14:02 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyYJIl+jbBTHceiFb7abiMJkI4XYnzKDiU1zG2063Pn5zMGNrGOcvNOStFk2fR0CCxDui24 X-Received: by 2002:a17:906:170f:: with SMTP id c15mr33818415eje.358.1615972442267; Wed, 17 Mar 2021 02:14:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972442; cv=none; d=google.com; s=arc-20160816; b=U2+YRgtQDDu4uTncyFChKV9xo821y7Q6w3oYnkEXDM2xZY8ZiLMLX3/uDj654Trkjl A/45TzJFMAiCLortsBpCIqI+I6AahmeB0gV9Uda8iarhXqw7XKf1q9yG0nyK+XCEbasw BsxIk5k7aqV5X2KZBtSZhUDUNQ21XIkKKIQUKLzApb73toz8/nYclIZdt8RyI84RzklA qIcyzDHcpZ1TTT5CaAci38ZQ0eD8ll/dUySsO4E6G8Gca0vvvDd+/1QZqEezFEqTHeUI yW76FlP1vlNLuNHG0iYhv1eNaqlSpRRJpJmANemDfJQeGHhepOHUV0EYzDgSSfccDZRu oAHg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=Vmhs1GwnoiVlAu7kb1g3Gxa90rFDalixOIK/s/KOHnE=; b=AvjqaUZOpHdDPw/QKWjt3NIyIgZnmCWg8D8SeXtU/xZHBptkFb8/arfbK8oykM7W3y dOogTXzdRG9xFSsatsvqov67bALQJb+OtjwuoduxQuqWRnAEr7I33nBazUJ7oe1ilffi 5IWMOtdqmmPZ4q3cKeusK1KlCHCJ+DT2TrFm6rfFZs9FfZDW6j2K1PYDe7wqWo+sj6zp hqi0U51ob7FxfSH2dqIXyb9WKlg/y61rH2IJecnj+tLpUGI5mTO1+XSTJ7O2UcDWpa8z IIxdHMWdsnnO5PKmvweq/pGM7do4gS4f2aFPXpsJxcq0VQCinQkDitSejrffBTd8pT8e k5kQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=DbaKw0VJ; 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 t15si15461864edq.164.2021.03.17.02.14.02 for ; Wed, 17 Mar 2021 02:14: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=DbaKw0VJ; 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 S230127AbhCQJN3 (ORCPT ); Wed, 17 Mar 2021 05:13:29 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42638 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229956AbhCQJMz (ORCPT ); Wed, 17 Mar 2021 05:12:55 -0400 Received: from mail-wm1-x32a.google.com (mail-wm1-x32a.google.com [IPv6:2a00:1450:4864:20::32a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AA019C061763 for ; Wed, 17 Mar 2021 02:12:54 -0700 (PDT) Received: by mail-wm1-x32a.google.com with SMTP id y124-20020a1c32820000b029010c93864955so2934364wmy.5 for ; Wed, 17 Mar 2021 02:12: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=Vmhs1GwnoiVlAu7kb1g3Gxa90rFDalixOIK/s/KOHnE=; b=DbaKw0VJMPZu4EklwZJbn7HC7mc2LNcUskiTdj1Bmpr9nnc4e8ck82Tf3PTQv11emI G7YzPOxZEm8xGfmFa8AAHd7wotLOLG8M+SZkdf/ZbJu16JaIhblAuLvW0fDp7ejclX88 7zni7JUf0+WWWDSwGrJQnPK94pVCPVAwkZ64EqdpOXx/lBmEv0x1jyNX0Q7h9gx0zBKL KHehJsdYnuENu2Vd1ziFe2rvWUydLFz/2d4MkNz7ExahjUxPUh/6r/Q7dlgrLTQft+EV Y1vf1BwT6gBuZOkWIfnvotyW243Z/n2frAvHLD885kINTjKEVehs6WZK6xk8UGk0myk2 WrPA== 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=Vmhs1GwnoiVlAu7kb1g3Gxa90rFDalixOIK/s/KOHnE=; b=J2C5KfDLp496wqAIv9GqpUeOU6Ynb6Y1YrlrGBwYIkZ+iVt8hrOgk4pg8qNHyazkjm lj5UC9hYLuZMUXugZCpYm4R7MnMh1jQ9TH0gGUF6+KZ2ATvGTHKhrLnNssSyEEBqa38u oivk8FHs46BTHXlp0dU39Q+5rOsnGSYGZL4STAvcGH4d4drzafvJUxVX0Y2JBvmoIk6x Ih/8eerrUnAvCkAqER+QTGm3++b443dKXNaEQ8A014jb3uR6jWgqDs5Up5rCmiOJsqek 1GHGRGm2f/tyWYOlq8/Nl/2FTRD7sE5aX4CY/Dtq2ZTYWuymfLqO8jVHotiQsuYEf88C BsVg== X-Gm-Message-State: AOAM532DRsGuV5HZlHtdPEr7rG9DeVYp1X5n41VT72v3w0XAq48flqhZ mi1IZ2AwxPlaUyKR5q6PCCz/LQ== X-Received: by 2002:a1c:c244:: with SMTP id s65mr2729640wmf.96.1615972373507; Wed, 17 Mar 2021 02:12:53 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:53 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "James E.J. Bottomley" , "Martin K. Petersen" , Anil Ravindranath , linux-scsi@vger.kernel.org Subject: [PATCH 13/36] scsi: pmcraid: Correct function name pmcraid_show_adapter_id() in header Date: Wed, 17 Mar 2021 09:12:07 +0000 Message-Id: <20210317091230.2912389-14-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/pmcraid.c:4079: warning: expecting prototype for pmcraid_show_io_adapter_id(). Prototype was for pmcraid_show_adapter_id() instead Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Anil Ravindranath Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/pmcraid.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/pmcraid.c b/drivers/scsi/pmcraid.c index c98e39eb04b24..bffd9a9349e72 100644 --- a/drivers/scsi/pmcraid.c +++ b/drivers/scsi/pmcraid.c @@ -4063,7 +4063,7 @@ static struct device_attribute pmcraid_driver_version_attr = { }; /** - * pmcraid_show_io_adapter_id - Display driver assigned adapter id + * pmcraid_show_adapter_id - Display driver assigned adapter id * @dev: class device struct * @attr: unused * @buf: buffer From patchwork Wed Mar 17 09:12:08 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403082 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294570jai; Wed, 17 Mar 2021 02:14:02 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxr9SySbw+xVId+WLxygyX0aWC9eFctc2z7AFaXEqE/GdVgFiKp/uUxfAWOorL6OQ50b4Hw X-Received: by 2002:a17:907:2bf6:: with SMTP id gv54mr34784590ejc.514.1615972441947; Wed, 17 Mar 2021 02:14:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972441; cv=none; d=google.com; s=arc-20160816; b=aj/52V2oXgO1Ea42tvR/B8RW0+QfM7ywFNMi4JftAh2ypFjgLBBGLswQ06bhbSel+8 dR1JJtuM7bide5+n/RC+1FpwqGawtzpZjqVB/3HujOml4HSjmUfjsSvU5ukuqrba2EHE tHki66w70FaZQzoL7n2fb1Tq9JGpIHtVtW+asqjeS7dNugBy7lcnSe8jt0qMwGtff191 3qcFGR43M9Ury4fCyQzWnVfSZjwULWi67876tQnnm9OuT5zXvBEiN3tQgoXD/TYkj7fy VhNdmxQLPq958X3paCwLEex1bbROWllGro/CnscD6HHC0P0tBMy4efk8j7EShLZ6BBG0 dAVA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=bKVcoII/VExWgJlUv7/sN5c60FiIBMpvmlinKRnJimA=; b=AtM4hI+xwXqjUYdOvQqy6QDPLdsIvjNjaurRN2enp01okvDKzxZiqknOrucXszD64F FaHqoFmCmIxQ+YDcDZ3nvTn7KhXF5IMEFcKhqKQaFxuSacuuBtJw86Kz4XyT/tMEc91u eG0R7gKsCk3VLaE60ddqZ3F9iTCsjBxyaOt91Ezqp5Rya+SnjTj78HN1BrLqAWLLy1Z/ 85bQj5JvxKv7UXm0DwaiuvsbKbAKWkmuljws/p37B0A/MxaxdBswyh5tVT5GavakK820 AWlQ+cxw4pbmssutYfRvSR1DzeFmE4rUL+9NQW96UPNPm0uD0FqWBFYWHZSevcjLenDs KSvg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=MxXKhto9; 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 t15si15461864edq.164.2021.03.17.02.14.01 for ; Wed, 17 Mar 2021 02:14: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=MxXKhto9; 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 S229889AbhCQJN2 (ORCPT ); Wed, 17 Mar 2021 05:13:28 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42696 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229970AbhCQJM4 (ORCPT ); Wed, 17 Mar 2021 05:12:56 -0400 Received: from mail-wr1-x42f.google.com (mail-wr1-x42f.google.com [IPv6:2a00:1450:4864:20::42f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9771CC061765 for ; Wed, 17 Mar 2021 02:12:55 -0700 (PDT) Received: by mail-wr1-x42f.google.com with SMTP id k8so1005279wrc.3 for ; Wed, 17 Mar 2021 02:12: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=bKVcoII/VExWgJlUv7/sN5c60FiIBMpvmlinKRnJimA=; b=MxXKhto9q9aaLM4LCO+LShWyhOUYRtAJedAKRvWFVJ4lyEZrFWIQDR7Cuhk1eUJrTz suzen/yOMRsiTSkMEzH3O79wsm9zWNVKldu0eGmN6WUhQOtfIJ1eHxggcJbluxeOP314 Sq8r97Qego7DsLELU/HaMEr3KCt10tqRS3Mgu8s74sIl4htXqCk0hAUvnMpmOTIsh9wv u2xXkQBnHRnnuxhAYjKF8gOBdyKJEIjvLK0K8wV0EKaYTJRgfcToSL0YtwLGkwZY/ia7 B358sXL6rbbgVIBaPmoScZTJonU4vYEblWpjJo2XjGaL1RdMnR7ATEaUdtk0dyfNRWSz OOkw== 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=bKVcoII/VExWgJlUv7/sN5c60FiIBMpvmlinKRnJimA=; b=ZcSu/jlZLfyogllh2YqtvcpRKAm09ZxzEZZekeAk+6O2eM7d6svazd2kraFVQjMZbd DB/ti37qNCKfQT1+IT0RIOKZCf9fJSaf/cJNWRGUx6D3+s2W8ysxYp+01UkANBfOiLgx rnN5n7sh4TZf0V0Vy5n/dbCQm6i8+2ShsWLBSPwoBUgAvHFZatQBztGq7Ad4ZCyOep9q 6Cj4oCJL58u0ci49JmrXH/JRJvhbDo7EFfRHRZR62me+ikxipn7/W8N3qznwrES5IKDt LBPifp1nbBPm6v6whE4YVaxPWRMjnmwhTzfwLxrAONnpXMc3A9LPiKAOi/hdMgSwYWH7 gPeA== X-Gm-Message-State: AOAM533I8cuySAhC9zuu+6HRSw9FF5egTC7hPADgEakAuJZL5tgaisTp HVjHIf2mDbJ9H1Qr4XFDWTRJbQ== X-Received: by 2002:a5d:5088:: with SMTP id a8mr3403129wrt.294.1615972374378; Wed, 17 Mar 2021 02:12:54 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:53 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Sathya Prakash , Sreekanth Reddy , Suganath Prabu Subramani , "James E.J. Bottomley" , "Martin K. Petersen" , MPT-FusionLinux.pdl@avagotech.com, MPT-FusionLinux.pdl@broadcom.com, linux-scsi@vger.kernel.org Subject: [PATCH 14/36] scsi: mpt3sas: mpt3sas_scs: Fix a few kernel-doc issues Date: Wed, 17 Mar 2021 09:12:08 +0000 Message-Id: <20210317091230.2912389-15-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/mpt3sas/mpt3sas_scsih.c:763: warning: Function parameter or member 'sas_address' not described in '__mpt3sas_get_sdev_by_addr' drivers/scsi/mpt3sas/mpt3sas_scsih.c:763: warning: expecting prototype for mpt3sas_get_sdev_by_addr(). Prototype was for __mpt3sas_get_sdev_by_addr() instead drivers/scsi/mpt3sas/mpt3sas_scsih.c:4535: warning: expecting prototype for _scsih_check_for_pending_internal_cmds(). Prototype was for mpt3sas_check_for_pending_internal_cmds() instead drivers/scsi/mpt3sas/mpt3sas_scsih.c:6188: warning: Function parameter or member 'port_entry' not described in '_scsih_look_and_get_matched_port_entry' drivers/scsi/mpt3sas/mpt3sas_scsih.c:6188: warning: Function parameter or member 'matched_port_entry' not described in '_scsih_look_and_get_matched_port_entry' drivers/scsi/mpt3sas/mpt3sas_scsih.c:6188: warning: Function parameter or member 'count' not described in '_scsih_look_and_get_matched_port_entry' drivers/scsi/mpt3sas/mpt3sas_scsih.c:6959: warning: Function parameter or member 'port' not described in 'mpt3sas_expander_remove' drivers/scsi/mpt3sas/mpt3sas_scsih.c:10494: warning: expecting prototype for mpt3sas_scsih_reset_handler(). Prototype was for mpt3sas_scsih_pre_reset_handler() instead drivers/scsi/mpt3sas/mpt3sas_scsih.c:10536: warning: expecting prototype for mpt3sas_scsih_reset_handler(). Prototype was for mpt3sas_scsih_reset_done_handler() instead drivers/scsi/mpt3sas/mpt3sas_scsih.c:12303: warning: expecting prototype for scsih__ncq_prio_supp(). Prototype was for scsih_ncq_prio_supp() instead Cc: Sathya Prakash Cc: Sreekanth Reddy Cc: Suganath Prabu Subramani Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: MPT-FusionLinux.pdl@avagotech.com Cc: MPT-FusionLinux.pdl@broadcom.com Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/mpt3sas/mpt3sas_scsih.c | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/mpt3sas/mpt3sas_scsih.c b/drivers/scsi/mpt3sas/mpt3sas_scsih.c index 945531e94d7e4..23ecf2750ec79 100644 --- a/drivers/scsi/mpt3sas/mpt3sas_scsih.c +++ b/drivers/scsi/mpt3sas/mpt3sas_scsih.c @@ -749,9 +749,10 @@ __mpt3sas_get_sdev_by_rphy(struct MPT3SAS_ADAPTER *ioc, } /** - * mpt3sas_get_sdev_by_addr - get _sas_device object corresponding to provided + * __mpt3sas_get_sdev_by_addr - get _sas_device object corresponding to provided * sas address from sas_device_list list * @ioc: per adapter object + * @sas_address: device sas address * @port: port number * * Search for _sas_device object corresponding to provided sas address, @@ -4518,7 +4519,7 @@ _scsih_issue_delayed_sas_io_unit_ctrl(struct MPT3SAS_ADAPTER *ioc, } /** - * _scsih_check_for_pending_internal_cmds - check for pending internal messages + * mpt3sas_check_for_pending_internal_cmds - check for pending internal messages * @ioc: per adapter object * @smid: system request message index * @@ -6174,10 +6175,10 @@ enum hba_port_matched_codes { * _scsih_look_and_get_matched_port_entry - Get matched hba port entry * from HBA port table * @ioc: per adapter object - * @port_entry - hba port entry from temporary port table which needs to be + * @port_entry: hba port entry from temporary port table which needs to be * searched for matched entry in the HBA port table - * @matched_port_entry - save matched hba port entry here - * @count - count of matched entries + * @matched_port_entry: save matched hba port entry here + * @count: count of matched entries * * return type of matched entry found. */ @@ -6952,6 +6953,7 @@ _scsih_expander_add(struct MPT3SAS_ADAPTER *ioc, u16 handle) * mpt3sas_expander_remove - removing expander object * @ioc: per adapter object * @sas_address: expander sas_address + * @port: hba port entry */ void mpt3sas_expander_remove(struct MPT3SAS_ADAPTER *ioc, u64 sas_address, @@ -10487,7 +10489,7 @@ _scsih_scan_for_devices_after_reset(struct MPT3SAS_ADAPTER *ioc) } /** - * mpt3sas_scsih_reset_handler - reset callback handler (for scsih) + * mpt3sas_scsih_pre_reset_handler - reset callback handler (for scsih) * @ioc: per adapter object * * The handler for doing any required cleanup or initialization. @@ -10528,7 +10530,7 @@ mpt3sas_scsih_clear_outstanding_scsi_tm_commands(struct MPT3SAS_ADAPTER *ioc) } /** - * mpt3sas_scsih_reset_handler - reset callback handler (for scsih) + * mpt3sas_scsih_reset_done_handler - reset callback handler (for scsih) * @ioc: per adapter object * * The handler for doing any required cleanup or initialization. @@ -12295,7 +12297,7 @@ scsih_pci_mmio_enabled(struct pci_dev *pdev) } /** - * scsih__ncq_prio_supp - Check for NCQ command priority support + * scsih_ncq_prio_supp - Check for NCQ command priority support * @sdev: scsi device struct * * This is called when a user indicates they would like to enable From patchwork Wed Mar 17 09:12:09 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403090 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294644jai; Wed, 17 Mar 2021 02:14:07 -0700 (PDT) X-Google-Smtp-Source: ABdhPJx1MFt0r1u8zY+6TFJkiWDayi45pO45hpXSujln0S5kwzlgIJls9FmGbWxABsYgA6s6riKu X-Received: by 2002:a17:906:3e89:: with SMTP id a9mr17393248ejj.405.1615972447335; Wed, 17 Mar 2021 02:14:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972447; cv=none; d=google.com; s=arc-20160816; b=te6Uh+YNFmMBw0h+9eJWdh2g4EGesP9HBFAtdOT/azNDRamluVkGx7MsyLIf0hqIWY A7lRB1YcfruDo/zWh0ppToETgfpk/bwhqRI+TPfq06ExjAn03iflMZtf27Absx8XzNIo w+y+FiGIhJekTVp3o08V+H8qk9D5ovW5bA8q8oJW1TBBi8qjLUsyQbgHEOlVwFynhF29 PUvZmejxDwBpDOmAmqozZ2rXkRt/+53bxoTvZVMxxnzuC8JqtC7rXwc0qbWmtfmRZkQ2 gh1OYEIA7RN6iFAI5/tqiu1ZxU8WTF8Bj+GiETsTKYUAcYZ7z0WFq4zd3mFwd1l07BDN v+8w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=CwQndVf+ajRvG7BvBjO6FK3EJF72tSCBcXH+xkZnA9A=; b=nd61G4gVGj5gIsYEerPIj+mLeS4ORPJQCZskT1T53wLJdx/ob4j+CCmpf4ElpQ4gIG mL/dn/wEIFmuhqZtDdrPAOgTeBhGyrSkV8/YeJg/MAmgstBrTI4Y8R2nbd6tLzSiEmvy tnWZ+2PkAQrpL7gb+RVOkxczjX4goEg6RMZQHUrZ080dfDf/FuePYCtU83jPU4kDgSKw Ap8JtksGeALDoAs3S6nlylQDbqGoIr7f1JjdnttfB/b+j/dU+eXVb5sWPwmtSGwQjjSV XJR77vqNPGrc1GV54IjgJcUnDjS0Jb5ecu7kz8e00GDVq+9lb9Wk7tLrSRxLX9xgTozE Y1qw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=cAXpZfWb; 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 t15si15461864edq.164.2021.03.17.02.14.07 for ; Wed, 17 Mar 2021 02:14:07 -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=cAXpZfWb; 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 S230510AbhCQJNk (ORCPT ); Wed, 17 Mar 2021 05:13:40 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42706 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229996AbhCQJM5 (ORCPT ); Wed, 17 Mar 2021 05:12:57 -0400 Received: from mail-wr1-x432.google.com (mail-wr1-x432.google.com [IPv6:2a00:1450:4864:20::432]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DD4B6C0613D8 for ; Wed, 17 Mar 2021 02:12:56 -0700 (PDT) Received: by mail-wr1-x432.google.com with SMTP id 61so991444wrm.12 for ; Wed, 17 Mar 2021 02:12: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=CwQndVf+ajRvG7BvBjO6FK3EJF72tSCBcXH+xkZnA9A=; b=cAXpZfWbnwYLQJVEJPJuJoAGyyDL3+O2ZQp0SB0cXTfefaBs9II3OuXE5qb9u4u8A0 drgxbimN1BySjwmM659Xhu+412YUtXOG5TYow2HC9+UKJttZw7bomixtpiO5svjxx14E 7PzHl8RFlF1sHLB3rMiPLdpni4UoEGXwXeXBPdH/21QHhus1ulL9/VN4swFOA2+vo7O7 hgpRqnuJWEjhOLve2tO8x6GGvBrmIoC6WcZ6zK7jYcFtGEZWZJrXzbQl4FmmjEjfxs6l waPhgQ38yYJ8KyF4IMEArZfPKRC+tb0kmDt+YhdBXkZcCOtI7kTsfjv9IFQrh9fORuZ5 PhuQ== 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=CwQndVf+ajRvG7BvBjO6FK3EJF72tSCBcXH+xkZnA9A=; b=MfM1Ej4HVnj57eMVpM/eaAzYl0uFlupaDHY3odhAGK2VdiczdbTgLMdSekCq/lFOR+ a5S3oqsxvq7rqFQG7T6UGqaF2NlXmjTsrpQ5Hd3bO07RgYWyZds6zTgqffu2rhh728m2 TkLvM0o4ww3E/3RHB6ttB4o1QRUtbPFPCbR57cgevmCVTrYfRKuqyPe0VjoXZ4g9SH77 OD65XZvyG/TeqCbeF0aA85EQmnAl1L2jlynmfH7uRY5S5FeDOMF7XaigdqJuYRnwGDls jqi0k/N/7QYFaks1wRp7ZNWj30asmb4cxKIwgDLAcOunPzVLjsyJ1foh5K4C6Jcdb7IM eFLw== X-Gm-Message-State: AOAM533h56d3NbGqhX1dNREyTVL57HcVkOPgq2cNgOcWjl+oWNnIndo0 gQoYbW7LtE9NH79slc7n+RbMAA== X-Received: by 2002:adf:fecc:: with SMTP id q12mr3245072wrs.317.1615972375699; Wed, 17 Mar 2021 02:12:55 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:55 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Subbu Seetharaman , Ketan Mukadam , Jitendra Bhivare , "James E.J. Bottomley" , "Martin K. Petersen" , linux-drivers@broadcom.com, linux-scsi@vger.kernel.org Subject: [PATCH 15/36] scsi: be2iscsi: be_main: Demote incomplete/non-conformant kernel-doc header Date: Wed, 17 Mar 2021 09:12:09 +0000 Message-Id: <20210317091230.2912389-16-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/be2iscsi/be_main.c:4937: warning: Function parameter or member 'data' not described in 'beiscsi_show_boot_tgt_info' drivers/scsi/be2iscsi/be_main.c:4937: warning: Function parameter or member 'type' not described in 'beiscsi_show_boot_tgt_info' drivers/scsi/be2iscsi/be_main.c:4937: warning: Function parameter or member 'buf' not described in 'beiscsi_show_boot_tgt_info' Cc: Subbu Seetharaman Cc: Ketan Mukadam Cc: Jitendra Bhivare Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-drivers@broadcom.com Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/be2iscsi/be_main.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/be2iscsi/be_main.c b/drivers/scsi/be2iscsi/be_main.c index eac67878b2b1b..22cf7f4b8d8c8 100644 --- a/drivers/scsi/be2iscsi/be_main.c +++ b/drivers/scsi/be2iscsi/be_main.c @@ -4927,7 +4927,7 @@ void beiscsi_start_boot_work(struct beiscsi_hba *phba, unsigned int s_handle) } #define BEISCSI_SYSFS_ISCSI_BOOT_FLAGS 3 -/** +/* * beiscsi_show_boot_tgt_info() * Boot flag info for iscsi-utilities * Bit 0 Block valid flag From patchwork Wed Mar 17 09:12:10 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403091 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294655jai; Wed, 17 Mar 2021 02:14:08 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxr64sLEaShIfY0btSO0lnZpdyD8szo3TBXifvRIbjVgaCyS9YlZTlAyoTsLpsCOdezO7+6 X-Received: by 2002:a05:6402:34d5:: with SMTP id w21mr19878786edc.14.1615972448329; Wed, 17 Mar 2021 02:14:08 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972448; cv=none; d=google.com; s=arc-20160816; b=R4Fr48uPeWrukmQJ8jyvjXXqm3VLcybv6Ud9SOmu8QISM7D2butbNBMrMgi5uAyaAv b7mZ5md4vLbzHMBpKNc9zT+9B/1P61gpM+MpA4heMshLq3nuxIs9LmglhF90YaqBLDDh nSqjuuoh3RIajMTalPuqiOv/3uDBoGn6ZRkRDP3rYMMOGsxT5h9AeRGgdj3eeM4NwLmv A12u18drGeL2SAilN8cLIPHazmtRDKPVEeo8WxSjRfktewdnZ2l+r5gSfA/0cB0GghSh FoNywjYjhR5IFllbSwU+qus9HW296I0+DtVfmd7w+ZVcsoFDiZa72jSoQRCVM5Mj6gVJ vm/w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=kAs8M6LvCni1AxZtMiy/7Jhupvn0PeB9iWWImdUoyng=; b=JT+5K4ITLOFlq7ul+381BFWHTCpDOkzr8lXjixYTEfSozQVi3HwFFW2kFWm9zr4qUF JUuqr1FQrwM83CiT/YwHqBGbYr77+uCbKLqDcNn8+oiKzDwNenVKbH2Iuf5GkGFXPZit rJFFE/cLHpP5xJmmOBfvX3M6WWNtNb+6MJCANHkSmBxzgjMoYubQiJTED154awI80SBj Q/iDRNiKFpjw2daGfKBToFIR7J5tC1evSbP9HrNh7mb2ZffIitzSt6xg6vserwocYKGW tXfzqHh4XO/+87E+VoaTo6dx47Va2t0HJhvwlfsgSu9D6SlRSu7bkvJnaZ3+dyEKLxTq NwFg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=dOuwjexZ; 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 t15si15461864edq.164.2021.03.17.02.14.08 for ; Wed, 17 Mar 2021 02:14:08 -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=dOuwjexZ; 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 S230513AbhCQJNm (ORCPT ); Wed, 17 Mar 2021 05:13:42 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42710 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229535AbhCQJM6 (ORCPT ); Wed, 17 Mar 2021 05:12:58 -0400 Received: from mail-wr1-x434.google.com (mail-wr1-x434.google.com [IPv6:2a00:1450:4864:20::434]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C51F2C0613DA for ; Wed, 17 Mar 2021 02:12:57 -0700 (PDT) Received: by mail-wr1-x434.google.com with SMTP id 61so991495wrm.12 for ; Wed, 17 Mar 2021 02:12: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=kAs8M6LvCni1AxZtMiy/7Jhupvn0PeB9iWWImdUoyng=; b=dOuwjexZ6wC8sNSwRHSAJd1yffddWk6tT8J1eOur7C8+ACY+A5MFIVQVuJXLmhjO6z gz/R9JxHMYZe2O3cac18XIhV8puI8vVnAa0BZL9XpUzPmBhAxE2Fg4zTRsmU0gaQbvG5 O3sNTwgd425gBcT/ykPCHfWIeKT8mfZpWEdgQSVAmrmO0xb0h7KnpmaVTn/1vnM7Y/Tz MhFmn2Yg8fUiIGDnG+Yne1uqE+3v37KRRFZFBPOW46pkkAqCa02WkA3MnaZpLw6NkTLM 83C5cxThHKyzD8DRA5QaL5D8gz/oEkE2h0UJKjiTYYtoIZu/clC/+qBTdseSaTmRXC1t Yx/w== 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=kAs8M6LvCni1AxZtMiy/7Jhupvn0PeB9iWWImdUoyng=; b=mfNTHoAD71eP0Nqpc13b66or0LEe8Bz3oZoKRt5tRBRLmN9aO+WFNDy5A5T9eFVXYa V12qnJRp0X1BE5J3onDTVPZfgs2x0HnzugV9tXhMdUChBergwVOSTzOZ0qQcrU4eZyv6 bYkKhf1NExA0vkZw5Cpr3nvcx0Yz/pov/UlrNGttFy07OF3/6DW0xFqqnHOiD9oNA/AW c6STFhN7sQh4iC6Mkg/eEPCuzfQpkpX643cWTciSNoCBIu67KXbFUs/9UboX/5dQ0qFv UyVn8wMmB7/6UDRLH7++BNKFe7OMAfjoXqZO7MZF9OgdX7BDMQQoAJaZqB0WrZt99skY mMzw== X-Gm-Message-State: AOAM5319S/z2HZ9sF0CgQhGsWVRxSBMExwd+idSYVVLNXd96X3K5SclM bHcHnTx+Ks951H4ugBZhww5gEA== X-Received: by 2002:a5d:4e85:: with SMTP id e5mr3415639wru.218.1615972376578; Wed, 17 Mar 2021 02:12:56 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:56 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 16/36] scsi: isci: phy: Fix a few different kernel-doc related issues Date: Wed, 17 Mar 2021 09:12:10 +0000 Message-Id: <20210317091230.2912389-17-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/phy.c:354: warning: Function parameter or member 'iphy' not described in 'phy_get_non_dummy_port' drivers/scsi/isci/phy.c:354: warning: expecting prototype for If the phy is(). Prototype was for phy_get_non_dummy_port() instead drivers/scsi/isci/phy.c:364: warning: wrong kernel-doc identifier on line: drivers/scsi/isci/phy.c:401: warning: wrong kernel-doc identifier on line: drivers/scsi/isci/phy.c:611: warning: Function parameter or member 'iphy' not described in 'sci_phy_complete_link_training' drivers/scsi/isci/phy.c:611: warning: Excess function parameter 'sci_phy' description in 'sci_phy_complete_link_training' drivers/scsi/isci/phy.c:1170: warning: Cannot understand * drivers/scsi/isci/phy.c:1222: warning: Cannot understand * drivers/scsi/isci/phy.c:1432: warning: Function parameter or member 'sas_phy' not described in 'isci_phy_control' drivers/scsi/isci/phy.c:1432: warning: Excess function parameter 'phy' description in 'isci_phy_control' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/phy.c | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/phy.c b/drivers/scsi/isci/phy.c index 1b87d9080ebeb..7ca7621f77479 100644 --- a/drivers/scsi/isci/phy.c +++ b/drivers/scsi/isci/phy.c @@ -361,11 +361,9 @@ struct isci_port *phy_get_non_dummy_port(struct isci_phy *iphy) } /** - * This method will assign a port to the phy object. + * sci_phy_set_port() - This method will assign a port to the phy object. * @out]: iphy This parameter specifies the phy for which to assign a port * object. - * - * */ void sci_phy_set_port( struct isci_phy *iphy, @@ -398,11 +396,11 @@ enum sci_status sci_phy_initialize(struct isci_phy *iphy, } /** - * This method assigns the direct attached device ID for this phy. + * sci_phy_setup_transport() - This method assigns the direct attached device ID for this phy. * - * @iphy The phy for which the direct attached device id is to + * @iphy: The phy for which the direct attached device id is to * be assigned. - * @device_id The direct attached device ID to assign to the phy. + * @device_id: The direct attached device ID to assign to the phy. * This will either be the RNi for the device or an invalid RNi if there * is no current device assigned to the phy. */ @@ -597,7 +595,7 @@ static void sci_phy_start_sata_link_training(struct isci_phy *iphy) /** * sci_phy_complete_link_training - perform processing common to * all protocols upon completion of link training. - * @sci_phy: This parameter specifies the phy object for which link training + * @iphy: This parameter specifies the phy object for which link training * has completed. * @max_link_rate: This parameter specifies the maximum link rate to be * associated with this phy. @@ -1167,8 +1165,8 @@ static void sci_phy_starting_final_substate_enter(struct sci_base_state_machine } /** - * - * @sci_phy: This is the struct isci_phy object to stop. + * scu_link_layer_stop_protocol_engine() + * @iphy: This is the struct isci_phy object to stop. * * This method will stop the struct isci_phy object. This does not reset the * protocol engine it just suspends it and places it in a state where it will @@ -1219,7 +1217,8 @@ static void scu_link_layer_start_oob(struct isci_phy *iphy) } /** - * + * scu_link_layer_tx_hard_reset() + * @iphy: This is the struct isci_phy object to stop. * * This method will transmit a hard reset request on the specified phy. The SCU * hardware requires that we reset the OOB state machine and set the hard reset @@ -1420,7 +1419,7 @@ void isci_phy_init(struct isci_phy *iphy, struct isci_host *ihost, int index) /** * isci_phy_control() - This function is one of the SAS Domain Template * functions. This is a phy management function. - * @phy: This parameter specifies the sphy being controlled. + * @sas_phy: This parameter specifies the sphy being controlled. * @func: This parameter specifies the phy control function being invoked. * @buf: This parameter is specific to the phy function being invoked. * From patchwork Wed Mar 17 09:12:11 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403086 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294593jai; Wed, 17 Mar 2021 02:14:04 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwj33zMhrLOxBUzmD9KoEvUUqg1AwOUS7zZUeGbWaQ8jdN9g5RYeDg94sF5D7s1kzhoyl2U X-Received: by 2002:a17:906:73cd:: with SMTP id n13mr33508482ejl.535.1615972444067; Wed, 17 Mar 2021 02:14:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972444; cv=none; d=google.com; s=arc-20160816; b=cQm4cqGwYuZGSISNevdt8159j0JjAwP9zJ2kK3eCnNd860SLCM3WMdweyaNFJ5v7+G X6Wq5UpUgTzaEYptQTCKRBZJgV/IW3N9MtlPXvqNwRjVqD84KC3fVlGatJ1w8Wq5mOUR N1/srUGfZLvHHWIZQLkuUeCWTK/yKdsb4sL7HMxn6hxMDElPM02bK4yBvzXUDGJfbPN1 ylJQvsIGQl583NRk0oVoocFFKtRDd5vss/5Ve0NqS0pqzis9pn0MaEtIcdvFqlz5j1Gg hvCP6qN9PmN8jPTWR7LX08NzwmpMKfk629i+N5Kjah4Jm+XPgfKnduzMRMilXGnflubx bGcQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=2WzJnbFL63fAV5MF42unVnj6zPztfqCHzahd4B5nEa4=; b=AxePQayW9KGqp9o+S+cOlWOFZ1l8YW9R6VQjZKXOCFZD3mMJCggoFGMNbcnTxNiPAR uyjVYNdJ9+72Wc8xgzNyt+UHZ4ZKYAOT6pFgBWQXtw2LatfWvKauBmGXoeUqI6uOKoJn qqz1nYAL2c3aJe/h+wg+DXKDjLZquqCSHFpFxrsrb+vNx150DDwYQV7wQ47TQZiJ5NTI sVHocZ2ycgE+HkqDfyebB3KztdHpzUDzYMcxQiAI++GMXiMGsfz2V7JsdYtSywx9nEqA nsaRkbAq+itUDK8zx1Nxgp+YHC9Q660tsX3Py7XNtOfHTC+wZkpqogK9HBRwovMFLzZl t7Sw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=jZUCRs8H; 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 t15si15461864edq.164.2021.03.17.02.14.03 for ; Wed, 17 Mar 2021 02:14:04 -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=jZUCRs8H; 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 S230393AbhCQJNh (ORCPT ); Wed, 17 Mar 2021 05:13:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42638 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230039AbhCQJNB (ORCPT ); Wed, 17 Mar 2021 05:13:01 -0400 Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0776AC0613DB for ; Wed, 17 Mar 2021 02:12:59 -0700 (PDT) Received: by mail-wm1-x332.google.com with SMTP id r10-20020a05600c35cab029010c946c95easo832025wmq.4 for ; Wed, 17 Mar 2021 02:12: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=2WzJnbFL63fAV5MF42unVnj6zPztfqCHzahd4B5nEa4=; b=jZUCRs8H69Csf5GhLrFIyA4rweatwr5fIlLJsoTfOZCevrPenu0dFtLGuORdXc2276 2Jkd2Ts0hUStkN6TbwYXKHElcc00A3iOyZ68bsVRYT9ohIaBIYri9u/kClPJPP9LXDsE R7riR2wJUO1CGCWXqFtnMzjImY/oPqxtL406B6FX7pHyM8UnhI3vjV931tGiXRh1FKRM ZH+0/sNADp74b6brzumnXVo+PMTF2snqJqE9qmHykwBnTPIv6bTrC3Fc2brOZMBuj4RK 2EJK9JccG0CyvMBYRmw1yei1MUr6x5WPwzlfPuo4K+gea1JdHh81fDketrOqFQ0Sum5U IXvg== 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=2WzJnbFL63fAV5MF42unVnj6zPztfqCHzahd4B5nEa4=; b=d+DKEcx91jsC4py1FTXmxPt8oUud7azPnasgoVDJIAzpYFLg/LK9S9+KxhEWt2+1ia j0AH+dxtrRwNi2Wu5dz26Er3GUr4NBLrtpEZAdllfogL8u9B1E6sgt2Y7Z2QEbsvy5nY WlywEw9MQwJJPW56doTKW+xKcGEFNAspks2L7tOfSAxoMk4+YrQYqVzCGSLNRsztDxkY +UbS+WpP00y/J4eFsfDAezyeN99K5ZH/0I1oyV+MiE3aoir3+VztF0+RSObMf7XgI15H ypq0SeR/5MVV/ZgKDu8AnIzqbbBmLfzr+vC3hFQuVskyW7V7P8ENWi3mCka4CguGVxMw 7pJQ== X-Gm-Message-State: AOAM533CzaMqcWoafEHt7F7JqJw3Nr8r2P3dpVflUPh/Y/KAuPqCUlT5 e0nrhDH33K1DYsaVTW8uyu5Utw== X-Received: by 2002:a05:600c:198c:: with SMTP id t12mr2650590wmq.183.1615972377801; Wed, 17 Mar 2021 02:12:57 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:57 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Satish Kharat , Sesidhar Baddela , Karan Tilak Kumar , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 17/36] scsi: fnic: fnic_scsi: Demote non-conformant kernel-doc headers Date: Wed, 17 Mar 2021 09:12:11 +0000 Message-Id: <20210317091230.2912389-18-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/fnic/fnic_scsi.c:183: warning: Function parameter or member 'fnic' not described in '__fnic_set_state_flags' drivers/scsi/fnic/fnic_scsi.c:183: warning: Function parameter or member 'st_flags' not described in '__fnic_set_state_flags' drivers/scsi/fnic/fnic_scsi.c:183: warning: Function parameter or member 'clearbits' not described in '__fnic_set_state_flags' drivers/scsi/fnic/fnic_scsi.c:2296: warning: Function parameter or member 'fnic' not described in 'fnic_scsi_host_start_tag' drivers/scsi/fnic/fnic_scsi.c:2296: warning: Function parameter or member 'sc' not described in 'fnic_scsi_host_start_tag' drivers/scsi/fnic/fnic_scsi.c:2316: warning: Function parameter or member 'fnic' not described in 'fnic_scsi_host_end_tag' drivers/scsi/fnic/fnic_scsi.c:2316: warning: Function parameter or member 'sc' not described in 'fnic_scsi_host_end_tag' Cc: Satish Kharat Cc: Sesidhar Baddela Cc: Karan Tilak Kumar Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/fnic/fnic_scsi.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/fnic/fnic_scsi.c b/drivers/scsi/fnic/fnic_scsi.c index 36744968378ff..e619a82f921b1 100644 --- a/drivers/scsi/fnic/fnic_scsi.c +++ b/drivers/scsi/fnic/fnic_scsi.c @@ -173,7 +173,7 @@ static int free_wq_copy_descs(struct fnic *fnic, struct vnic_wq_copy *wq) } -/** +/* * __fnic_set_state_flags * Sets/Clears bits in fnic's state_flags **/ @@ -2287,7 +2287,7 @@ static int fnic_clean_pending_aborts(struct fnic *fnic, return ret; } -/** +/* * fnic_scsi_host_start_tag * Allocates tagid from host's tag list **/ @@ -2307,7 +2307,7 @@ fnic_scsi_host_start_tag(struct fnic *fnic, struct scsi_cmnd *sc) return dummy->tag; } -/** +/* * fnic_scsi_host_end_tag * frees tag allocated by fnic_scsi_host_start_tag. **/ From patchwork Wed Mar 17 09:12:12 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403088 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294624jai; Wed, 17 Mar 2021 02:14:06 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwD9nAGS8n31U4gHrwAlXcyUXzkC4U9wsWVzyVPH9Ht7u1Q3rK+APpgHrGVCTeIXaWaqkoz X-Received: by 2002:aa7:c815:: with SMTP id a21mr41332985edt.38.1615972446491; Wed, 17 Mar 2021 02:14:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972446; cv=none; d=google.com; s=arc-20160816; b=AZ+scty403HgASqKS2QWwF1hQPIB3135GIBaTFRjfkE/tqOayIReNH0UuA7qiEh1Yt XG64xpX1P/Zk8x3hbbLfgGI4MTTdk0ycxOfD0k3chjcHgrG3w/Lzf0oTg45fKMJX4M5B j+e75gYu73exaoXdr/8npT8L3gmEGyGI6xHNkyMkASKRxEBui3sda4CywNIHKMGaq/Zj q7R1cOe6kkHfb+WyVceHWX/4Lc0s+8cajstKR91Aztb1oDl8b/5Crbtpz4JRZ0AsXHF4 elChZ4H9Tpf656ToCchLiUlof2qg5r+S017UpyDEBinqEcHgctuDKv1mxkWecJTKFSMm XTGg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=1cUaH1b/K2O6ERJ+bzFiuL6brJDSqamBpVZhrZptGlg=; b=lj3UgGwRknhU5L+poXPc9v+V5+pqWCQ65LBE7HE4VXMSk5DA12amHoW0d9gU57ITWC nbfxp1x6u1YJ4bNspSypbEyul6a1H/BK6Clnp0sQZz6DCZMLStC4gyTGXdLw0TlJtQ3Q QtX8m90EmaEh7En9PNM7qrWfxlzpmcqOk/SEZI5gECGgC65zwTpjlYZxHcm1z9PYJJLh CqGzB5PTuuLO1s36Tlg3R6fnPVBz1p2a7sdTZXw1DC1v+01XWzoiufnYo0bhWI2Q735+ oWTXOfGHhVuczo28r6HeAQMHmbW8M/i11siHqlv3qLbJffFKvv40KqK3I9JrLUdP+6ku S5vQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Im7bMn59; 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 t15si15461864edq.164.2021.03.17.02.14.06 for ; Wed, 17 Mar 2021 02:14:06 -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=Im7bMn59; 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 S230475AbhCQJNi (ORCPT ); Wed, 17 Mar 2021 05:13:38 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42696 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230121AbhCQJNB (ORCPT ); Wed, 17 Mar 2021 05:13:01 -0400 Received: from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com [IPv6:2a00:1450:4864:20::32f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D8E33C0613DD for ; Wed, 17 Mar 2021 02:12:59 -0700 (PDT) Received: by mail-wm1-x32f.google.com with SMTP id m20-20020a7bcb940000b029010cab7e5a9fso2934864wmi.3 for ; Wed, 17 Mar 2021 02:12: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=1cUaH1b/K2O6ERJ+bzFiuL6brJDSqamBpVZhrZptGlg=; b=Im7bMn59N95huVs4Cu4fmRc+YGmxvRCVAMpXXHJhZWc1pJOWrIaZSXIMXl5w8V/lSr YJvntp3NAD6/3rrIW26RPA/WItV8qBpPgULuGC28khbozZ3k0Wat4XlD95GvkSkAcv/C m9I9ObxabwTJhuGmzCzb+q2778Y7BK4eg8xjD2eNFMcmovc078KN0GGDrR5MuMfEm50a tymDrTgN/8qneiFeUnZPu26PhGPvhZWbj9LIZIRCHW7UoMBpiwULAAe899JKIAj5ns7y GBvbRmTzzUbXt2Pm5fvtFywSkRAIhrl/c7jj55xm2xPaZIDxCWy/vgce1cC3REk9Wmc5 fvnw== 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=1cUaH1b/K2O6ERJ+bzFiuL6brJDSqamBpVZhrZptGlg=; b=J0tgQF6dpXgDRJe5dzSd5hXyLIhcyGUMGQHBa8x4RXO/Of869Z0wlI5CP7eVEJftmE O63tcmfQ3a9XC61ESP4JmLkEeovoO/4EqT50k2EAIPRvnERDPevkLUrmzxcITqNoUk++ HcQUe2n/ga608V3ZMnzdBOpPJsmFcFwcFyImWCKTMMLDBlan0lA+amq3gqLPmmBylrfG H59AmOX2qggqzMpoEER15OhUwj4Ycf86tFrbefn0luA9/SvNcCHnHBTw/qNO3TP+zyS+ usHivqfjKvpPYkhHCk+oOQbrbzIg0DgWd+VtUeqnW8oPKUwLqJPucXxSChQ7la+pUxh3 Ahjw== X-Gm-Message-State: AOAM532+PBADOXdhTIcXqT4sKneRPenMinQo4Rq4Z+u9a+2GLw3u9sGt p7qJ/q91f7gAw6d0YTfz6k393A== X-Received: by 2002:a1c:f404:: with SMTP id z4mr2748623wma.39.1615972378673; Wed, 17 Mar 2021 02:12:58 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:58 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Satish Kharat , Sesidhar Baddela , Karan Tilak Kumar , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 18/36] scsi: fnic: fnic_fcs: Kernel-doc headers must contain the function name Date: Wed, 17 Mar 2021 09:12:12 +0000 Message-Id: <20210317091230.2912389-19-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/fnic/fnic_fcs.c:308: warning: expecting prototype for Check if the Received FIP FLOGI frame is rejected(). Prototype was for is_fnic_fip_flogi_reject() instead Cc: Satish Kharat Cc: Sesidhar Baddela Cc: Karan Tilak Kumar Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/fnic/fnic_fcs.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/fnic/fnic_fcs.c b/drivers/scsi/fnic/fnic_fcs.c index e0cee4dcb4391..881c4823d7e24 100644 --- a/drivers/scsi/fnic/fnic_fcs.c +++ b/drivers/scsi/fnic/fnic_fcs.c @@ -296,7 +296,7 @@ void fnic_handle_event(struct work_struct *work) } /** - * Check if the Received FIP FLOGI frame is rejected + * is_fnic_fip_flogi_reject() - Check if the Received FIP FLOGI frame is rejected * @fip: The FCoE controller that received the frame * @skb: The received FIP frame * From patchwork Wed Mar 17 09:12:13 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403087 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294600jai; Wed, 17 Mar 2021 02:14:04 -0700 (PDT) X-Google-Smtp-Source: ABdhPJysgisVaa4QoxstY70e12zIp2mZdwUzAQHr0+Bxr4saKlLkarmtDD65ORs/lk1DZ1aNMFGL X-Received: by 2002:a17:906:3b47:: with SMTP id h7mr33812588ejf.377.1615972444396; Wed, 17 Mar 2021 02:14:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972444; cv=none; d=google.com; s=arc-20160816; b=hQqttsdvOuVzSWt9Qec9mVLJLIfTBcJDMAZ+7c3+q9gXBbt2P3Hdbd3ZGtkSX96o+V PUYkMQck52luqOxT3FO4+gwoJmBtUfxoehc6dbDY/IMbqRX7sRcmsWOEd2r7UdGDVB0h 5jn4ME891DvE6iG5D5kRqRxtHRcAmUsZO0DMDUCUDGe1ownq0+4QEGgzO0ZUVmh0Oosq MultbB6+2jrNnmXahZlS23xLXsJ8DSjHcTf/QJQ+7xB7y8clYapsoRnd95Q1L2X68JP5 aKrpRTiO5+K0t0ABl6q3rxuG6eR34kjBzgxLuzkNKKtnn7mQhtvoU4l+hnG0221HmhoX glQw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=X2jzyWxb6hZ16y5SB+2tveo3Hvk9XXLg4i7IoitMdEQ=; b=XjuEafQ86FOMY/DmTos4FEwZdYbgY6AcKy0CW/WYEDhf1+maYiPP82IALeWmZNy+Ku y6CQ1B0SLkWyOQhUTltaHXWaoA6SaZNERZoByrAZ9jenRxvh9aUwubC2aqRsf0qF6McN wKDWPk2GYNq8bCvEdOd53B/r+Fcl+gdE920c4YJK399XQp9vvCk/aAlXbdWNDn2O5jan pokzbMxcWH9GIyFnv6SqidIJx4L68DC5/Stn0T9KVT8cONbnikzm9/glO2JV41cgOBgC GPO+MVUyApdrlErUj2tNLf0bD3iRqvNYL4tyHKJrh9udg+K7Tdknvm5W2oKgV5NrhZ1H K7Hg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Sz9BPNST; 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 t15si15461864edq.164.2021.03.17.02.14.04 for ; Wed, 17 Mar 2021 02:14:04 -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=Sz9BPNST; 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 S230489AbhCQJNj (ORCPT ); Wed, 17 Mar 2021 05:13:39 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42730 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230125AbhCQJNB (ORCPT ); Wed, 17 Mar 2021 05:13:01 -0400 Received: from mail-wr1-x42c.google.com (mail-wr1-x42c.google.com [IPv6:2a00:1450:4864:20::42c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 15697C0613E0 for ; Wed, 17 Mar 2021 02:13:01 -0700 (PDT) Received: by mail-wr1-x42c.google.com with SMTP id 61so991673wrm.12 for ; Wed, 17 Mar 2021 02:13: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=X2jzyWxb6hZ16y5SB+2tveo3Hvk9XXLg4i7IoitMdEQ=; b=Sz9BPNST98yr2QElSdpJAAY98v7AGIVUMHdqfE6cjKNe9TWa0JzeSbG0yXFBZPShMH m/9tK7TMTeul+K8w8OuGH8yBx85GmpognI5LZrubw7BgMLhdqnb2U2q0pg67TKV7+oI7 w3Xy+d/EhvwYX4EAKgUVr8wyabh9cHsAMXQdUiY7YihMP2XInKa6hS6le6bP2ek5arCj 7lEmjvi3kVmFHoEgZl3t+qkbgV+QZRLPeXM6lCEI31xVu7ilVDt/ep1SB/xsDYuRU2jQ rO+yf1zRtLBnWz9oqKSLeS7R0pvHQzBQIk8rho0zbZw2Y1ST/nbRdAOStpC2/LyYFFGb jJvA== 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=X2jzyWxb6hZ16y5SB+2tveo3Hvk9XXLg4i7IoitMdEQ=; b=oPeaNLOPwOpg9W3S0jpkhNL0SNqN5QqbcFON/FQKVNLjqvgu5zOmUuoukZyowO+eLz 4QMl6UwVJRhIFi7YR1tH7cU72eaof5Attv/BVo3saG17FJSlUpnn1idKZkPHmA9905Vg gULGFM4RS/V6UOhe1sxQ7OSIOlf9ADIdEElnkd7k+461weHU3hHk+Z6AYfaekm/4QQQX oEMUmVJrAVBar8cjaQfM+5Rkm6xAbown3jHfconWgNX310/lY/FghP69s4rX6GgCRViL Wa4I7iovt2SSxSdtVnihqjiJmvi4XNesGjFgJs3kixLsB6exkuVCoJSaDfWdwsb2P5qo BeyA== X-Gm-Message-State: AOAM5326CJpdyyPEp5bncmUo8/B+vWlXaE6ZFhyfsJl9/yEh9T8AC2K7 SK/l7o2fGuzjftfbW00YcuF9Fx9WDmmv5A== X-Received: by 2002:adf:8341:: with SMTP id 59mr3205254wrd.130.1615972379865; Wed, 17 Mar 2021 02:12:59 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:12:59 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 19/36] scsi: isci: phy: Provide function name and demote non-conforming header Date: Wed, 17 Mar 2021 09:12:13 +0000 Message-Id: <20210317091230.2912389-20-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/phy.c:354: warning: Function parameter or member 'iphy' not described in 'phy_get_non_dummy_port' drivers/scsi/isci/phy.c:354: warning: expecting prototype for If the phy is(). Prototype was for phy_get_non_dummy_port() instead drivers/scsi/isci/phy.c:371: warning: Function parameter or member 'iphy' not described in 'sci_phy_set_port' drivers/scsi/isci/phy.c:371: warning: Function parameter or member 'iport' not described in 'sci_phy_set_port' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/phy.c | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/phy.c b/drivers/scsi/isci/phy.c index 7ca7621f77479..aa8787343e831 100644 --- a/drivers/scsi/isci/phy.c +++ b/drivers/scsi/isci/phy.c @@ -339,10 +339,11 @@ static void phy_sata_timeout(struct timer_list *t) } /** - * This method returns the port currently containing this phy. If the phy is - * currently contained by the dummy port, then the phy is considered to not - * be part of a port. - * @sci_phy: This parameter specifies the phy for which to retrieve the + * phy_get_non_dummy_port() - This method returns the port currently containing + * this phy. If the phy is currently contained by the dummy port, then the phy + * is considered to not be part of a port. + * + * @iphy: This parameter specifies the phy for which to retrieve the * containing port. * * This method returns a handle to a port that contains the supplied phy. @@ -360,10 +361,8 @@ struct isci_port *phy_get_non_dummy_port(struct isci_phy *iphy) return iphy->owning_port; } -/** +/* * sci_phy_set_port() - This method will assign a port to the phy object. - * @out]: iphy This parameter specifies the phy for which to assign a port - * object. */ void sci_phy_set_port( struct isci_phy *iphy, From patchwork Wed Mar 17 09:12:14 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403084 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294577jai; Wed, 17 Mar 2021 02:14:02 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzXb3wMpWyosPE1OyRD8oIYjz65OCluIZbar0JXPoYws+SMtk2zKRFZEgQvcc8oHC404R9O X-Received: by 2002:a05:6402:b48:: with SMTP id bx8mr42279127edb.162.1615972442643; Wed, 17 Mar 2021 02:14:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972442; cv=none; d=google.com; s=arc-20160816; b=g48/ETcIMmI4npPthYd0PWPbXcQkSDk2mYwRH+SU2KC1+b8wc73nosI9TMXlCkaQw2 eqY8/hxOwORUUTN5hG0jZm64uPq1NCXAREwBDV3ASEgP66kr7vD+r000wnSn4sE/zha8 ZqZ/gXqo5Yb9g3PJWbGARHvL4JKs7wVMiGx6000GIRELtuVmGVHgkKRaj1Lj37bKbQFB KlRoXgMqEf+cdcFIq6kwKR4clFv41kPW0ceU6FAS4dVQZOB/dOsgqVYootHgJsnaNepr qaPF/UF++hW3AXO6gypa6l1qJcEEyFrtDl6AwC2wb/rOT+jtgv867G2L2u5d/k8PkFyG cBAg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=DMv+vXcSwpokLRSaKZQvY2+l2E4jS8n/6HqcIh5ruyI=; b=geTI0tRcsuSHjpTjGt/cRO+xoY/sgJKSXzI0SQtb9QRVGSr+RnlZ+RNyRNZN7iSc3h 0AhyUcRDQvZzCeyrhnfVEIr2Uo+j/E2wnhU5xi5gpCPGbqEAM+b+mlZE5xPfoE0Tbq9P /dsEmKEzR6HM5hNEiF73+PNjHCbRRv9fBvBbshl1hgEDcscDNob88N7WumU4SCEEtH4q 4LGddp2Tc4cwxVbp+15IEDGaoZhE2MFHkuzaSCgqsxyO5KBWZ9YiVFgYpri46cAEn9zv PHj4R+rFfdZMFA2o4/o1HYL7wPabsiJoxcnbhumarlvuh1icpS6688ZAZ5fJryBqAocZ gSig== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="wo/qe93w"; 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 t15si15461864edq.164.2021.03.17.02.14.02 for ; Wed, 17 Mar 2021 02:14: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="wo/qe93w"; 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 S229472AbhCQJNc (ORCPT ); Wed, 17 Mar 2021 05:13:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42706 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230146AbhCQJNC (ORCPT ); Wed, 17 Mar 2021 05:13:02 -0400 Received: from mail-wm1-x330.google.com (mail-wm1-x330.google.com [IPv6:2a00:1450:4864:20::330]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 12465C061764 for ; Wed, 17 Mar 2021 02:13:02 -0700 (PDT) Received: by mail-wm1-x330.google.com with SMTP id f22-20020a7bc8d60000b029010c024a1407so2955035wml.2 for ; Wed, 17 Mar 2021 02:13:02 -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=DMv+vXcSwpokLRSaKZQvY2+l2E4jS8n/6HqcIh5ruyI=; b=wo/qe93wBkC8iHvSIg0ts3AjRIPH2+ru2o7fmIn2C8rMRuCJkQJ6aNDsuC7VLig04M C3/W365haDaXefPY2bnghnTyfDDBQt8fqwdrGAdJBzdxo7I36IeO/PS1OstnxYuW0rvX qHF3Wl9tKqGJFt4QpovgqaUtpK0C3Lfsr7lgSKeSPzs71nx5EiHz8EeNYVSSU4zs0iMt WSBpGo5rwU3M3LL/rwG1OqqGZMSi/qfkJUxAwfK8/56nh/jfnrn+spORrb7YUPeEWLjL ek3zFEB0SnTF3CjNmjlcO4cB7MZ3v9IJfz6x1+vD0nvY5OnayOxiNlAxcPvxga9hyoj5 fuwQ== 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=DMv+vXcSwpokLRSaKZQvY2+l2E4jS8n/6HqcIh5ruyI=; b=a4BRUVyTT0dCNY05N0umPSuoIX75isHpR/Tq7MHUosyH+HazJKQ8OMfI2ghpbIk+Aq RqWLAcxKRNm3EdTDg6bsLyvcf2CI+AL0kkT0yIblmPU1lbgkyAWxNH3705Wg7OiKwfWQ YindcPdE4WAmq4xi6WIN2X9YDbaJWfhJCRoWfKfkRjM25nWbjtb/XZKBV83M2TxWxziR BIMkIMenir9KaIIpGgUGRt7GrHyvMtU9Yw0Efyh1s/3Sqo+hdAq7jYD/Gp2bsKHN4/JY QBus0HMsVQ8Yu8x17OK6tCAob7inpS0Xhp6d+H283mnNbv7hFp+UwJTm/o/zRWLQ/q7S wX8A== X-Gm-Message-State: AOAM530YyzffCnQ2GMjLTl2/8boGk0IJcODui48GAq6vTT1LtGi0Tooy GZR2jfEzxdQ2o/bZDloLJI4agw== X-Received: by 2002:a1c:bc56:: with SMTP id m83mr2728457wmf.174.1615972380728; Wed, 17 Mar 2021 02:13:00 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.12.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:00 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 20/36] scsi: isci: request: Fix a myriad of kernel-doc issues Date: Wed, 17 Mar 2021 09:12:14 +0000 Message-Id: <20210317091230.2912389-21-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/request.c:211: warning: wrong kernel-doc identifier on line: drivers/scsi/isci/request.c:414: warning: wrong kernel-doc identifier on line: drivers/scsi/isci/request.c:472: warning: Function parameter or member 'ireq' not described in 'scu_ssp_task_request_construct_task_context' drivers/scsi/isci/request.c:472: warning: expecting prototype for The(). Prototype was for scu_ssp_task_request_construct_task_context() instead drivers/scsi/isci/request.c:501: warning: Function parameter or member 'ireq' not described in 'scu_sata_request_construct_task_context' drivers/scsi/isci/request.c:501: warning: expecting prototype for This method is will fill in the SCU Task Context for any type of SATA(). Prototype was for scu_sata_request_construct_task_context() instead drivers/scsi/isci/request.c:597: warning: Cannot understand * drivers/scsi/isci/request.c:785: warning: expecting prototype for sci_req_tx_bytes(). Prototype was for SCU_TASK_CONTEXT_SRAM() instead drivers/scsi/isci/request.c:1399: warning: Cannot understand * drivers/scsi/isci/request.c:1446: warning: Cannot understand * drivers/scsi/isci/request.c:2465: warning: Function parameter or member 'task' not described in 'isci_request_process_response_iu' drivers/scsi/isci/request.c:2465: warning: Excess function parameter 'sas_task' description in 'isci_request_process_response_iu' drivers/scsi/isci/request.c:2501: warning: Function parameter or member 'task' not described in 'isci_request_set_open_reject_status' drivers/scsi/isci/request.c:2524: warning: Function parameter or member 'idev' not described in 'isci_request_handle_controller_specific_errors' drivers/scsi/isci/request.c:2524: warning: Function parameter or member 'task' not described in 'isci_request_handle_controller_specific_errors' drivers/scsi/isci/request.c:3337: warning: Function parameter or member 'idev' not described in 'isci_io_request_build' drivers/scsi/isci/request.c:3337: warning: Excess function parameter 'sci_device' description in 'isci_io_request_build' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/request.c | 58 ++++++++++++++++++------------------- 1 file changed, 28 insertions(+), 30 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/request.c b/drivers/scsi/isci/request.c index 58e62162882f2..49ab2555c0cdf 100644 --- a/drivers/scsi/isci/request.c +++ b/drivers/scsi/isci/request.c @@ -207,11 +207,8 @@ static void sci_task_request_build_ssp_task_iu(struct isci_request *ireq) SCI_CONTROLLER_INVALID_IO_TAG; } -/** +/* * This method is will fill in the SCU Task Context for any type of SSP request. - * @sci_req: - * @task_context: - * */ static void scu_ssp_request_construct_task_context( struct isci_request *ireq, @@ -410,10 +407,8 @@ static void scu_ssp_ireq_dif_strip(struct isci_request *ireq, u8 type, u8 op) tc->ref_tag_seed_gen = 0; } -/** +/* * This method is will fill in the SCU Task Context for a SSP IO request. - * @sci_req: - * */ static void scu_ssp_io_request_construct_task_context(struct isci_request *ireq, enum dma_data_direction dir, @@ -456,17 +451,16 @@ static void scu_ssp_io_request_construct_task_context(struct isci_request *ireq, } /** - * This method will fill in the SCU Task Context for a SSP Task request. The - * following important settings are utilized: -# priority == - * SCU_TASK_PRIORITY_HIGH. This ensures that the task request is issued - * ahead of other task destined for the same Remote Node. -# task_type == - * SCU_TASK_TYPE_IOREAD. This simply indicates that a normal request type - * (i.e. non-raw frame) is being utilized to perform task management. -# - * control_frame == 1. This ensures that the proper endianess is set so - * that the bytes are transmitted in the right order for a task frame. - * @sci_req: This parameter specifies the task request object being - * constructed. - * + * scu_ssp_task_request_construct_task_context() - This method will fill in + * the SCU Task Context for a SSP Task request. The following important + * settings are utilized: -# priority == SCU_TASK_PRIORITY_HIGH. This + * ensures that the task request is issued ahead of other task destined + * for the same Remote Node. -# task_type == SCU_TASK_TYPE_IOREAD. This + * simply indicates that a normal request type (i.e. non-raw frame) is + * being utilized to perform task management. -#control_frame == 1. This + * ensures that the proper endianess is set so that the bytes are + * transmitted in the right order for a task frame. + * @ireq: This parameter specifies the task request object being constructed. */ static void scu_ssp_task_request_construct_task_context(struct isci_request *ireq) { @@ -484,6 +478,7 @@ static void scu_ssp_task_request_construct_task_context(struct isci_request *ire } /** + * scu_sata_request_construct_task_context() * This method is will fill in the SCU Task Context for any type of SATA * request. This is called from the various SATA constructors. * @sci_req: The general IO request object which is to be used in @@ -593,9 +588,9 @@ static enum sci_status sci_stp_pio_request_construct(struct isci_request *ireq, return SCI_SUCCESS; } -/** - * - * @sci_req: This parameter specifies the request to be constructed as an +/* + * sci_stp_optimized_request_construct() + * @ireq: This parameter specifies the request to be constructed as an * optimized request. * @optimized_task_type: This parameter specifies whether the request is to be * an UDMA request or a NCQ request. - A value of 0 indicates UDMA. - A @@ -778,11 +773,11 @@ static enum sci_status sci_io_request_construct_basic_sata(struct isci_request * return status; } +#define SCU_TASK_CONTEXT_SRAM 0x200000 /** * sci_req_tx_bytes - bytes transferred when reply underruns request * @ireq: request that was terminated early */ -#define SCU_TASK_CONTEXT_SRAM 0x200000 static u32 sci_req_tx_bytes(struct isci_request *ireq) { struct isci_host *ihost = ireq->owning_controller; @@ -1396,10 +1391,10 @@ static enum sci_status sci_stp_request_pio_data_out_transmit_data(struct isci_re } /** - * - * @stp_request: The request that is used for the SGL processing. - * @data_buffer: The buffer of data to be copied. - * @length: The length of the data transfer. + * sci_stp_request_pio_data_in_copy_data_buffer() + * @stp_req: The request that is used for the SGL processing. + * @data_buf: The buffer of data to be copied. + * @len: The length of the data transfer. * * Copy the data from the buffer for the length specified to the IO request SGL * specified data region. enum sci_status @@ -1443,8 +1438,8 @@ sci_stp_request_pio_data_in_copy_data_buffer(struct isci_stp_request *stp_req, } /** - * - * @sci_req: The PIO DATA IN request that is to receive the data. + * sci_stp_request_pio_data_in_copy_data() + * @stp_req: The PIO DATA IN request that is to receive the data. * @data_buffer: The buffer to copy from. * * Copy the data buffer to the io request data region. enum sci_status @@ -2452,7 +2447,7 @@ sci_io_request_tc_completion(struct isci_request *ireq, * isci_request_process_response_iu() - This function sets the status and * response iu, in the task struct, from the request object for the upper * layer driver. - * @sas_task: This parameter is the task struct from the upper layer driver. + * @task: This parameter is the task struct from the upper layer driver. * @resp_iu: This parameter points to the response iu of the completed request. * @dev: This parameter specifies the linux device struct. * @@ -2485,6 +2480,7 @@ static void isci_request_process_response_iu( * isci_request_set_open_reject_status() - This function prepares the I/O * completion for OPEN_REJECT conditions. * @request: This parameter is the completed isci_request object. + * @task: This parameter is the task struct from the upper layer driver. * @response_ptr: This parameter specifies the service response for the I/O. * @status_ptr: This parameter specifies the exec status for the I/O. * @open_rej_reason: This parameter specifies the encoded reason for the @@ -2509,7 +2505,9 @@ static void isci_request_set_open_reject_status( /** * isci_request_handle_controller_specific_errors() - This function decodes * controller-specific I/O completion error conditions. + * @idev: Remote device * @request: This parameter is the completed isci_request object. + * @task: This parameter is the task struct from the upper layer driver. * @response_ptr: This parameter specifies the service response for the I/O. * @status_ptr: This parameter specifies the exec status for the I/O. * @@ -3326,7 +3324,7 @@ static enum sci_status isci_smp_request_build(struct isci_request *ireq) * @ihost: This parameter specifies the ISCI host object * @request: This parameter points to the isci_request object allocated in the * request construct function. - * @sci_device: This parameter is the handle for the sci core's remote device + * @idev: This parameter is the handle for the sci core's remote device * object that is the destination for this request. * * SCI_SUCCESS on successfull completion, or specific failure code. From patchwork Wed Mar 17 09:12:15 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403103 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294776jai; Wed, 17 Mar 2021 02:14:17 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwjfkCy/80E4HFrjUDFKtHeKlQ9smuLENhc7nOru6dU2DU2DfAzOGHoBOm92SVeIFIV48OH X-Received: by 2002:aa7:d3ca:: with SMTP id o10mr19763314edr.374.1615972456987; Wed, 17 Mar 2021 02:14:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972456; cv=none; d=google.com; s=arc-20160816; b=W6qL16lqv51QxYJ1E1uzdDUhsfXoGuDcnFT1DlMc2jPfoxQFgDRiIvA/o8B7QIaABC 46pusUeGFylQ66rqx1Yvarv/XC7jfnKC/e613zH49sIkoJqU1YfspJMya7kowEcpo9pI 87ynQSu5oxWTxflQmm11go57W58RF00wfXXmBqANdMn5SMmcmsFzs5VLVTF+xPTPIYCH YT75YN5I/rSEoHbhzhTBD1u/zRRQWS20a/b3hTPXVO4PXMUt/LGO65zloSgMCw8R2HZF diAYOAaaDHKR1qUm5fcOI8lSS1EcNx1ogCFmWNZ0Vc5Gx605e5Yb/ITxC9s514JmG5Jh AtDw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=uTNqNlz+Ecexn349OCj8UvAD3yFKfX6K/X1rJlsgwE4=; b=h3GJo42kBwo1NdfV9U7r8OamuZO5ShyNAT8+hFXfmqhT8U8AnY3b2jrWL155DEVP8P EUyVwqYW8+TcyOeQywAFJSdX7519XmkvTvyBV7RLZwiwgKH720h0w18sQtLnbuWp0kxm QI+M/JloCQxthIwq53m77GtDAQMcZAUrO7XX21w/Hp/4meXMTUutGufKXaLPMj3ZCYM1 E08jn5P8/54x4/QspLgScShWQB1LnXhkW1gpSBI8S10II/WokiNXog4rF42NjJQDB2k7 mjdb+K9xfql0HrqigCKiCzOI64Au9c/5sOONWdtUg0Ug/W4a2MYd4YgpzFwLMTDqVuD+ aGig== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=NjwKS70J; 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 t15si15461864edq.164.2021.03.17.02.14.16 for ; Wed, 17 Mar 2021 02:14:16 -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=NjwKS70J; 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 S231208AbhCQJNu (ORCPT ); Wed, 17 Mar 2021 05:13:50 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42740 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230363AbhCQJNO (ORCPT ); Wed, 17 Mar 2021 05:13:14 -0400 Received: from mail-wm1-x335.google.com (mail-wm1-x335.google.com [IPv6:2a00:1450:4864:20::335]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 52DBFC06174A for ; Wed, 17 Mar 2021 02:13:03 -0700 (PDT) Received: by mail-wm1-x335.google.com with SMTP id w203-20020a1c49d40000b029010c706d0642so4988363wma.0 for ; Wed, 17 Mar 2021 02:13: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=uTNqNlz+Ecexn349OCj8UvAD3yFKfX6K/X1rJlsgwE4=; b=NjwKS70JSdJTqCLRsydCZ8MnzYAyMKrf5yd3/VvJhFZmnFTzlcjDhxkgNNsxXqj20k tX134FeDTDfhZURYy427MNHsZWbrKuNHekfjZLjm6LBShO9C8x5oMSVOTYO8Mao1rmk7 jHSrhQZkQZCDYhLHLNRIjS/62yd7Fl6zVzXfscxSw/HMx5aNuIp6yE7RgXy9e+dpl8Sa FdU5xqYBfqOxsigfQ3vOB2Y9vi+WT7Dnay3M4F6laBnsEoilKwbRGd4esn6na5nrjOZp R1v7AGWvcPdurC56X98C/jU2PlrFF+dMAhVkSorh2TTiL3W82Lfpu7CkVayXS4JbZYN8 NwaQ== 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=uTNqNlz+Ecexn349OCj8UvAD3yFKfX6K/X1rJlsgwE4=; b=EOF2GgwoS3r8+uN6nwlWrb555qMlUsaFFoPMgafSEkZKTbFoBjeEuFzJdd9fSRviPa aH5wU3b4Hy+IzR/no49UWMIVAaTiOTr4jSq1vFAUPLe1RsfjEQha//gCI9AamE7Paaqx km67FRC508vq+fM2bfEHDXmqVsG74tAjo9tLHoalHB02eWMYv3+h877Qg1jCH2EfJSPi d5KqqpgWfvoypzIf56dHymXvDmrUJhP4QZYGRFsMPxBIRk2ISuKZOjxZgxd6hAZLVmht 7YxKQhxntDVeA9PBYG5NQqLPWwPwZr5vN6NQvWHxRnl7/mP9rs4vYJMJImVOGmBMwnog ubOA== X-Gm-Message-State: AOAM533T8VtfyZgS8mXl6e5kjLaQRdeEUf59v2H0dWTAWtLvhGtGHdDO aDt3eWEsR0bptgOYbp/xO5G3e4NGFqFdYg== X-Received: by 2002:a1c:e383:: with SMTP id a125mr2705173wmh.125.1615972382028; Wed, 17 Mar 2021 02:13:02 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:01 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 21/36] scsi: isci: host: Fix bunch of kernel-doc related issues Date: Wed, 17 Mar 2021 09:12:15 +0000 Message-Id: <20210317091230.2912389-22-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/host.c:93: warning: Cannot understand * drivers/scsi/isci/host.c:108: warning: Function parameter or member 'x' not described in 'NORMALIZE_PUT_POINTER' drivers/scsi/isci/host.c:121: warning: Function parameter or member 'x' not described in 'NORMALIZE_EVENT_POINTER' drivers/scsi/isci/host.c:130: warning: Function parameter or member 'x' not described in 'NORMALIZE_GET_POINTER' drivers/scsi/isci/host.c:139: warning: Function parameter or member 'x' not described in 'NORMALIZE_GET_POINTER_CYCLE_BIT' drivers/scsi/isci/host.c:146: warning: Function parameter or member 'x' not described in 'COMPLETION_QUEUE_CYCLE_BIT' drivers/scsi/isci/host.c:646: warning: Function parameter or member 'ihost' not described in 'isci_host_start_complete' drivers/scsi/isci/host.c:646: warning: Excess function parameter 'isci_host' description in 'isci_host_start_complete' drivers/scsi/isci/host.c:680: warning: Function parameter or member 'ihost' not described in 'sci_controller_get_suggested_start_timeout' drivers/scsi/isci/host.c:680: warning: Excess function parameter 'controller' description in 'sci_controller_get_suggested_start_timeout' drivers/scsi/isci/host.c:903: warning: Function parameter or member 'ihost' not described in 'sci_controller_start_next_phy' drivers/scsi/isci/host.c:903: warning: Excess function parameter 'scic' description in 'sci_controller_start_next_phy' drivers/scsi/isci/host.c:1159: warning: Function parameter or member 'ihost' not described in 'sci_controller_stop' drivers/scsi/isci/host.c:1159: warning: Excess function parameter 'controller' description in 'sci_controller_stop' drivers/scsi/isci/host.c:1184: warning: Function parameter or member 'ihost' not described in 'sci_controller_reset' drivers/scsi/isci/host.c:1184: warning: Excess function parameter 'controller' description in 'sci_controller_reset' drivers/scsi/isci/host.c:1352: warning: Function parameter or member 'ihost' not described in 'sci_controller_set_interrupt_coalescence' drivers/scsi/isci/host.c:1352: warning: Excess function parameter 'controller' description in 'sci_controller_set_interrupt_coalescence' drivers/scsi/isci/host.c:2498: warning: Function parameter or member 'ihost' not described in 'sci_controller_allocate_remote_node_context' drivers/scsi/isci/host.c:2498: warning: Function parameter or member 'idev' not described in 'sci_controller_allocate_remote_node_context' drivers/scsi/isci/host.c:2498: warning: expecting prototype for This method allocates remote node index and the reserves the remote node(). Prototype was for sci_controller_allocate_remote_node_context() instead drivers/scsi/isci/host.c:2721: warning: Function parameter or member 'ihost' not described in 'sci_controller_start_task' drivers/scsi/isci/host.c:2721: warning: Function parameter or member 'idev' not described in 'sci_controller_start_task' drivers/scsi/isci/host.c:2721: warning: Function parameter or member 'ireq' not described in 'sci_controller_start_task' drivers/scsi/isci/host.c:2721: warning: Excess function parameter 'controller' description in 'sci_controller_start_task' drivers/scsi/isci/host.c:2721: warning: Excess function parameter 'remote_device' description in 'sci_controller_start_task' drivers/scsi/isci/host.c:2721: warning: Excess function parameter 'task_request' description in 'sci_controller_start_task' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/host.c | 37 ++++++++++++++++++------------------- 1 file changed, 18 insertions(+), 19 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/host.c b/drivers/scsi/isci/host.c index 7ebfa3c8cdc78..d690d9cf7eb15 100644 --- a/drivers/scsi/isci/host.c +++ b/drivers/scsi/isci/host.c @@ -89,16 +89,14 @@ #define SCIC_SDS_CONTROLLER_PHY_START_TIMEOUT 100 -/** - * - * +/* * The number of milliseconds to wait while a given phy is consuming power * before allowing another set of phys to consume power. Ultimately, this will * be specified by OEM parameter. */ #define SCIC_SDS_CONTROLLER_POWER_CONTROL_INTERVAL 500 -/** +/* * NORMALIZE_PUT_POINTER() - * * This macro will normalize the completion queue put pointer so its value can @@ -108,7 +106,7 @@ ((x) & SMU_COMPLETION_QUEUE_PUT_POINTER_MASK) -/** +/* * NORMALIZE_EVENT_POINTER() - * * This macro will normalize the completion queue event entry so its value can @@ -120,7 +118,7 @@ >> SMU_COMPLETION_QUEUE_GET_EVENT_POINTER_SHIFT \ ) -/** +/* * NORMALIZE_GET_POINTER() - * * This macro will normalize the completion queue get pointer so its value can @@ -129,7 +127,7 @@ #define NORMALIZE_GET_POINTER(x) \ ((x) & SMU_COMPLETION_QUEUE_GET_POINTER_MASK) -/** +/* * NORMALIZE_GET_POINTER_CYCLE_BIT() - * * This macro will normalize the completion queue cycle pointer so it matches @@ -138,7 +136,7 @@ #define NORMALIZE_GET_POINTER_CYCLE_BIT(x) \ ((SMU_CQGR_CYCLE_BIT & (x)) << (31 - SMU_COMPLETION_QUEUE_GET_CYCLE_BIT_SHIFT)) -/** +/* * COMPLETION_QUEUE_CYCLE_BIT() - * * This macro will return the cycle bit of the completion queue entry @@ -637,7 +635,7 @@ irqreturn_t isci_error_isr(int vec, void *data) /** * isci_host_start_complete() - This function is called by the core library, * through the ISCI Module, to indicate controller start status. - * @isci_host: This parameter specifies the ISCI host object + * @ihost: This parameter specifies the ISCI host object * @completion_status: This parameter specifies the completion status from the * core library. * @@ -670,7 +668,7 @@ int isci_host_scan_finished(struct Scsi_Host *shost, unsigned long time) * use any timeout value, but this method provides the suggested minimum * start timeout value. The returned value is based upon empirical * information determined as a result of interoperability testing. - * @controller: the handle to the controller object for which to return the + * @ihost: the handle to the controller object for which to return the * suggested start timeout. * * This method returns the number of milliseconds for the suggested start @@ -893,7 +891,7 @@ bool is_controller_start_complete(struct isci_host *ihost) /** * sci_controller_start_next_phy - start phy - * @scic: controller + * @ihost: controller * * If all the phys have been started, then attempt to transition the * controller to the READY state and inform the user @@ -1145,7 +1143,7 @@ void isci_host_completion_routine(unsigned long data) * controller has been quiesced. This method will ensure that all IO * requests are quiesced, phys are stopped, and all additional operation by * the hardware is halted. - * @controller: the handle to the controller object to stop. + * @ihost: the handle to the controller object to stop. * @timeout: This parameter specifies the number of milliseconds in which the * stop operation should complete. * @@ -1174,7 +1172,7 @@ static enum sci_status sci_controller_stop(struct isci_host *ihost, u32 timeout) * considered destructive. In other words, all current operations are wiped * out. No IO completions for outstanding devices occur. Outstanding IO * requests are not aborted or completed at the actual remote device. - * @controller: the handle to the controller object to reset. + * @ihost: the handle to the controller object to reset. * * Indicate if the controller reset method succeeded or failed in some way. * SCI_SUCCESS if the reset operation successfully started. SCI_FATAL_ERROR if @@ -1331,7 +1329,7 @@ static inline void sci_controller_starting_state_exit(struct sci_base_state_mach /** * sci_controller_set_interrupt_coalescence() - This method allows the user to * configure the interrupt coalescence. - * @controller: This parameter represents the handle to the controller object + * @ihost: This parameter represents the handle to the controller object * for which its interrupt coalesce register is overridden. * @coalesce_number: Used to control the number of entries in the Completion * Queue before an interrupt is generated. If the number of entries exceed @@ -2479,12 +2477,13 @@ struct isci_request *sci_request_by_tag(struct isci_host *ihost, u16 io_tag) } /** + * sci_controller_allocate_remote_node_context() * This method allocates remote node index and the reserves the remote node * context space for use. This method can fail if there are no more remote * node index available. - * @scic: This is the controller object which contains the set of + * @ihost: This is the controller object which contains the set of * free remote node ids - * @sci_dev: This is the device object which is requesting the a remote node + * @idev: This is the device object which is requesting the a remote node * id * @node_id: This is the remote node id that is assinged to the device if one * is available @@ -2709,11 +2708,11 @@ enum sci_status sci_controller_continue_io(struct isci_request *ireq) /** * sci_controller_start_task() - This method is called by the SCIC user to * send/start a framework task management request. - * @controller: the handle to the controller object for which to start the task + * @ihost: the handle to the controller object for which to start the task * management request. - * @remote_device: the handle to the remote device object for which to start + * @idev: the handle to the remote device object for which to start * the task management request. - * @task_request: the handle to the task request object to start. + * @ireq: the handle to the task request object to start. */ enum sci_status sci_controller_start_task(struct isci_host *ihost, struct isci_remote_device *idev, From patchwork Wed Mar 17 09:12:16 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403089 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294630jai; Wed, 17 Mar 2021 02:14:06 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwnWwtH2O/KR3POFINPfWWrcbTsFkrd6pkeOAf12rFxV5MmoDKK0WwavZMB35oWUNbrHmrS X-Received: by 2002:a17:906:5902:: with SMTP id h2mr34111994ejq.416.1615972446825; Wed, 17 Mar 2021 02:14:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972446; cv=none; d=google.com; s=arc-20160816; b=0J6xGXonWxqqCsR0mgYcgo7hbhckXLvDJdj2Jerr0pStBVMCPkzVT4vHfYE4Is4w4o v5HToFS5anfgdI7O7dKFFnuRpLZkZI6PA9iFuiA6M5gmQ8Q4cExJW/+UqfPsUjqGLImr Umdn9TDDfXGUme8KLHzbXqDh2lpf9csW9rCiKEAAewH/o8SQ4CZs75VyejyZ+MqbY0r+ EAtZUtEWtdvSHe9XOM6JdSql+4LnvuO8oZJu0ii0NQk7hA4++bo1ggryVd19DGetrvDy eQdY6tWkQj+HSAS3vsRWH7qhSEqc+Bjo+f4Fh3qyndviQpR+qFrYQXbiZIedIJBC45W8 P9Pg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=17QMvq2Q/M7Orri85J9dD3hcU2vgqE2nGmmSGPSN8N4=; b=Aal1K+h6Y1L0bAGBVl05xqM6f6C8NT3Prkk3tHe6bdgLjYsEknlHG9K4kUI7icwiV1 j8J+MCXtf4TraXHrK9lqTuYo6n+F4T4cchg/HHht2cfVWEteRnr2g/WQTJI0Y/lL6q/T OLfZNh1YcXvCcDhkZICq6JbZxlB+1wOurr8pzvKpp/kivUD3tArAzWjSRqdURq6QA8vT 5Fj+63MtKj7XOXM+6OmKqwOCyRB8cR0jQLXLG3+hm65XRLAHuwaNebDjeJcWQwq+H0WR V+KjN3uuY5YvNOAUrlK5OOq5ojDEvfTQsdZWytoIT2R0yHAYyicEfggrWKJZQYf6n0LW RtHg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=xSui72cH; 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 t15si15461864edq.164.2021.03.17.02.14.06 for ; Wed, 17 Mar 2021 02:14:06 -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=xSui72cH; 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 S230506AbhCQJNk (ORCPT ); Wed, 17 Mar 2021 05:13:40 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230219AbhCQJNE (ORCPT ); Wed, 17 Mar 2021 05:13:04 -0400 Received: from mail-wr1-x430.google.com (mail-wr1-x430.google.com [IPv6:2a00:1450:4864:20::430]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 22ACEC061762 for ; Wed, 17 Mar 2021 02:13:04 -0700 (PDT) Received: by mail-wr1-x430.google.com with SMTP id b9so999766wrt.8 for ; Wed, 17 Mar 2021 02:13: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=17QMvq2Q/M7Orri85J9dD3hcU2vgqE2nGmmSGPSN8N4=; b=xSui72cH7mynYUdWePzFI99ZQeLZVleHwCOGmVd/+zEzOtTrUJRIvq57rNSXdvtkFD AuTsw5cXDndwCIwGCovMJCcwWXX7vWOmrbro5MTnHR3M+nBZq4rvHW9wlbyD8ues64tq W0YVxGRYhaLiqE6iw/EOX4jN89g3+mzKO757fML5iJh6mfUEdB8Zwanp+oGDRV45hvCo JKbNmBqoLpYVWtkzG9OTEaQPPFPFCl1+ynQYr2zX1AEXvEanYpHlyvofdCFdydvXaKF7 ZJT/RZDz3IgE7F0U1RAzWKtbyut9QwgIQD6RwWTACnPS1DBXMU5I5rJpQGFdhv0b9JFF xySA== 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=17QMvq2Q/M7Orri85J9dD3hcU2vgqE2nGmmSGPSN8N4=; b=cuAQ3Wc6JU2RLUClu58thXM++KsY8R5/OSd5ulke9c/RWM79PeKTl3FGlxP+y/PTNa LVG4mtZCi3ZOa1z6H0tpAAzQRMNOLD/rySoe2xOFFs8DrDkRHQkgU7ZaAPoBLaqpeE3Z aF1JwiSsONYfvjt90GZdky3uhhD5QbEnhjsmkWBVso6wqFIICtJm611ndb5pmIOZ3s/t p/AvgxsAtJ1iyhgTSji6HWtKmeU+2Xk8scokUVpblO8MivSH4Uv6OMB2KTJ/8gKAcU+u B6NtVNSk0MkGK+WeGNq2Re7eZXyZJButleL8khe747Gpk9+O/9XW0HkeYDYcRQur/Ub1 G2ow== X-Gm-Message-State: AOAM532SJcBZkh29p4NRj/B0VJgDfZGuxSSjV6q5xR7UuVYYwO10Aa+J 5bWQhbDcjc7I9NJjSJvJ9fiaJQ== X-Received: by 2002:a5d:6c67:: with SMTP id r7mr1164616wrz.373.1615972382873; Wed, 17 Mar 2021 02:13:02 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:02 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 22/36] scsi: isci: task: Demote non-conformant header and remove superfluous param Date: Wed, 17 Mar 2021 09:12:16 +0000 Message-Id: <20210317091230.2912389-23-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/task.c:383: warning: Function parameter or member 'isci_host' not described in 'isci_task_send_lu_reset_sas' drivers/scsi/isci/task.c:383: warning: Function parameter or member 'isci_device' not described in 'isci_task_send_lu_reset_sas' drivers/scsi/isci/task.c:677: warning: Excess function parameter 'lun' description in 'isci_task_query_task' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/task.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/task.c b/drivers/scsi/isci/task.c index 26fa1a4d1e6bf..62062ed6cd9ad 100644 --- a/drivers/scsi/isci/task.c +++ b/drivers/scsi/isci/task.c @@ -369,7 +369,7 @@ static void isci_task_build_abort_task_tmf(struct isci_tmf *tmf, tmf->io_tag = old_request->io_tag; } -/** +/* * isci_task_send_lu_reset_sas() - This function is called by of the SAS Domain * Template functions. * @lun: This parameter specifies the lun to be reset. @@ -668,7 +668,6 @@ int isci_task_clear_task_set( * returned, libsas turns this into a LUN reset; when FUNC_FAILED is * returned, libsas will turn this into a target reset * @task: This parameter specifies the sas task being queried. - * @lun: This parameter specifies the lun associated with this request. * * status, zero indicates success. */ From patchwork Wed Mar 17 09:12:17 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403093 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294668jai; Wed, 17 Mar 2021 02:14:09 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzhuCGP/aokmU2QUiSs5x9g//1Sop8DjxQpXDlKDpSlZppxhr5ReEEh6a4QQetYMddZ10iI X-Received: by 2002:a17:907:2112:: with SMTP id qn18mr33644255ejb.220.1615972449545; Wed, 17 Mar 2021 02:14:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972449; cv=none; d=google.com; s=arc-20160816; b=MmiNJoSyW2HMgkFS6Lb48sBaFl98NTii16qXObJCSmNQnot4mnrOg6bpsXCjjvuvBq mSIhxkGLPnQDyZGMgbbjRQyGG2MZRtpqAtQsLOHFGQnxtccEN2qXOzbIoCbHroMJ6BlT PskrWzewLRQIBXmyTZAMn5KNY8yiFNejlo+yV/jPWV8Bpjxb2eYySIxeZXKp5wMfnxT+ Ag+50rHOfeI9Jj+H3xP6nwIZowfAvEtnHUDY1U43uP8qP9MAPlNFG+CUuy+F6fGGaAQO YGN2W3Y6ykyyYqM6dO43Dn7F0+ofkLoloNkODmAz1AojT8eK/U959wycGcDOijNNIu5J 7euA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=MQ2nUtCGw1bWUZ6dO/5J8SDUuDM4eCtKGGa2VlanAmM=; b=ImF+OwozBt5qy9Q2Wnn7c3ZMoXLywdw7XXdoH0OX/38Lk3vDT/DcmkIItmwksvyYQc QrkJmPc/1zzTA0fGgNlT994TYZVYvTkMQ29NivVXndHbwUBPXmBUVKGwqUQnHvs1j550 9U/Gx9C5PAQ1cuOQy/z66UhbbscfhewjAN4dyST8QUzgbaLpp0gbnEruzHhpM09cOi+9 qBTxdQtiqVq4mA6r8I7IvqzH5Cr8+oX5/shaBIpcRlBW05RxRDuD26LepircfpJUaLYD 16cngaRVdnZPY7kextew3SrCb2yrrlSsI0XZXxHroI2MocuoJzb+TUwFUtx5TsWXCIfQ WThQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=d2Ja2o6t; 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 t15si15461864edq.164.2021.03.17.02.14.09 for ; Wed, 17 Mar 2021 02:14: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=d2Ja2o6t; 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 S231142AbhCQJNn (ORCPT ); Wed, 17 Mar 2021 05:13:43 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230241AbhCQJNF (ORCPT ); Wed, 17 Mar 2021 05:13:05 -0400 Received: from mail-wr1-x436.google.com (mail-wr1-x436.google.com [IPv6:2a00:1450:4864:20::436]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2E261C061760 for ; Wed, 17 Mar 2021 02:13:05 -0700 (PDT) Received: by mail-wr1-x436.google.com with SMTP id x16so1010298wrn.4 for ; Wed, 17 Mar 2021 02:13: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=MQ2nUtCGw1bWUZ6dO/5J8SDUuDM4eCtKGGa2VlanAmM=; b=d2Ja2o6tgRGuZu/1gD3cCuRyuA6S6GgUOdhpFLU7iMpXFvkyR0pN3bcibvKm5/vjJT YZgukf4UNqYRhDxIpmHDYNPSp07nFKO58rgOk6dR2BMf8HESOZ+DSdkz866QBjDNtzKL gC7yavFODON/KcwZduZibWrosEZTVcu1tRBMngCMsXt+55z9TnN5Wp103xRnXcEF0fDf RoyiXMRtKLQ8K9sTSsp+qF/HpqpsnjRQ+1wFHZmUXBMKBpLPj2K0gb/rudm9/Ro6PdA1 yWw9jfy5qs/HQa5xNrMLNReG0nUDtCcRvke6d/OZYJZfhv2Mel8Kawnyeh1QBdkZAHs6 0vMA== 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=MQ2nUtCGw1bWUZ6dO/5J8SDUuDM4eCtKGGa2VlanAmM=; b=kPS7eTw1PnfWhxArlJTYvAhKy6y0PF38lkkTu3QA720JXJGmHgeUf2TXywb7wR2YP2 gmV70/eewcD1QNavvbLKAUu4YSQH1AnRNeEIuxsuMUCSl0h5mZJ9j3z2oIIq+Aj1MEzm OADrfcbXO75jI4H62qjLSdp73srwJXvJERgxNugFBXfw/hrS86tDYlP9hLkFkeRz/9Ar YeSwUxp2FtMH+q2bXaxSKKUVVjlUaCkzFB1XZ6c3rpt+S6wc7JHDKWP4Y1cJSC3hAHAF 0McIAXR8kaj3g3/XJUv3fQgmP/qRGi2Nz5M5sr2ybUu71DYA0QTeZ9iaxbzCzjnhNS3i xjUw== X-Gm-Message-State: AOAM530qE5BO/6clKijpd3j0D7djq88XguL8rzBFmmjrXzM091sdMy8Y aq5cc0KxPq5H/HtllXd98uujXA== X-Received: by 2002:adf:fac1:: with SMTP id a1mr3451873wrs.98.1615972383807; Wed, 17 Mar 2021 02:13:03 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:03 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 23/36] scsi: isci: remote_node_table: Fix a bunch of kernel-doc misdemeanours Date: Wed, 17 Mar 2021 09:12:17 +0000 Message-Id: <20210317091230.2912389-24-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/remote_node_table.c:66: warning: Incorrect use of kernel-doc format: * drivers/scsi/isci/remote_node_table.c:80: warning: Function parameter or member 'remote_node_table' not described in 'sci_remote_node_table_get_group_index' drivers/scsi/isci/remote_node_table.c:80: warning: Function parameter or member 'group_table_index' not described in 'sci_remote_node_table_get_group_index' drivers/scsi/isci/remote_node_table.c:80: warning: expecting prototype for This file contains the implementation of the SCIC_SDS_REMOTE_NODE_TABLE(). Prototype was for sci_remote_node_table_get_group_index() instead drivers/scsi/isci/remote_node_table.c:101: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:131: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:161: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:194: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:227: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:256: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:283: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:310: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:368: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:428: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:465: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:508: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:553: warning: Cannot understand * drivers/scsi/isci/remote_node_table.c:576: warning: Cannot understand * Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/remote_node_table.c | 51 +++++++++++++-------------- 1 file changed, 25 insertions(+), 26 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/remote_node_table.c b/drivers/scsi/isci/remote_node_table.c index 301b3141945ec..1036ab936626e 100644 --- a/drivers/scsi/isci/remote_node_table.c +++ b/drivers/scsi/isci/remote_node_table.c @@ -53,17 +53,15 @@ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ -/** +/* * This file contains the implementation of the SCIC_SDS_REMOTE_NODE_TABLE * public, protected, and private methods. - * - * */ #include "remote_node_table.h" #include "remote_node_context.h" /** - * + * sci_remote_node_table_get_group_index() * @remote_node_table: This is the remote node index table from which the * selection will be made. * @group_table_index: This is the index to the group table from which to @@ -98,8 +96,8 @@ static u32 sci_remote_node_table_get_group_index( } /** - * - * @out]: remote_node_table This the remote node table in which to clear the + * sci_remote_node_table_clear_group_index() + * @remote_node_table: This the remote node table in which to clear the * selector. * @set_index: This is the remote node selector in which the change will be * made. @@ -128,8 +126,8 @@ static void sci_remote_node_table_clear_group_index( } /** - * - * @out]: remote_node_table This the remote node table in which to set the + * sci_remote_node_table_set_group_index() + * @remote_node_table: This the remote node table in which to set the * selector. * @group_table_index: This is the remote node selector in which the change * will be made. @@ -158,8 +156,8 @@ static void sci_remote_node_table_set_group_index( } /** - * - * @out]: remote_node_table This is the remote node table in which to modify + * sci_remote_node_table_set_node_index() + * @remote_node_table: This is the remote node table in which to modify * the remote node availability. * @remote_node_index: This is the remote node index that is being returned to * the table. @@ -191,8 +189,8 @@ static void sci_remote_node_table_set_node_index( } /** - * - * @out]: remote_node_table This is the remote node table from which to clear + * sci_remote_node_table_clear_node_index() + * @remote_node_table: This is the remote node table from which to clear * the available remote node bit. * @remote_node_index: This is the remote node index which is to be cleared * from the table. @@ -224,8 +222,8 @@ static void sci_remote_node_table_clear_node_index( } /** - * - * @out]: remote_node_table The remote node table from which the slot will be + * sci_remote_node_table_clear_group() + * @remote_node_table: The remote node table from which the slot will be * cleared. * @group_index: The index for the slot that is to be cleared. * @@ -253,7 +251,7 @@ static void sci_remote_node_table_clear_group( } /** - * + * sci_remote_node_table_set_group() * @remote_node_table: * * THis method sets an entire remote node group in the remote node table. @@ -280,7 +278,7 @@ static void sci_remote_node_table_set_group( } /** - * + * sci_remote_node_table_get_group_value() * @remote_node_table: This is the remote node table that for which the group * value is to be returned. * @group_index: This is the group index to use to find the group value. @@ -307,8 +305,8 @@ static u8 sci_remote_node_table_get_group_value( } /** - * - * @out]: remote_node_table The remote that which is to be initialized. + * sci_remote_node_table_initialize() + * @remote_node_table: The remote that which is to be initialized. * @remote_node_entries: The number of entries to put in the table. * * This method will initialize the remote node table for use. none @@ -365,8 +363,8 @@ void sci_remote_node_table_initialize( } /** - * - * @out]: remote_node_table The remote node table from which to allocate a + * sci_remote_node_table_allocate_single_remote_node() + * @remote_node_table: The remote node table from which to allocate a * remote node. * @table_index: The group index that is to be used for the search. * @@ -425,7 +423,7 @@ static u16 sci_remote_node_table_allocate_single_remote_node( } /** - * + * sci_remote_node_table_allocate_triple_remote_node() * @remote_node_table: This is the remote node table from which to allocate the * remote node entries. * @group_table_index: THis is the group table index which must equal two (2) @@ -462,7 +460,7 @@ static u16 sci_remote_node_table_allocate_triple_remote_node( } /** - * + * sci_remote_node_table_allocate_remote_node() * @remote_node_table: This is the remote node table from which the remote node * allocation is to take place. * @remote_node_count: This is ther remote node count which is one of @@ -505,8 +503,9 @@ u16 sci_remote_node_table_allocate_remote_node( } /** - * - * @remote_node_table: + * sci_remote_node_table_release_single_remote_node() + * @remote_node_table: This is the remote node table from which the remote node + * release is to take place. * * This method will free a single remote node index back to the remote node * table. This routine will update the remote node groups @@ -550,7 +549,7 @@ static void sci_remote_node_table_release_single_remote_node( } /** - * + * sci_remote_node_table_release_triple_remote_node() * @remote_node_table: This is the remote node table to which the remote node * index is to be freed. * @@ -573,7 +572,7 @@ static void sci_remote_node_table_release_triple_remote_node( } /** - * + * sci_remote_node_table_release_remote_node_index() * @remote_node_table: The remote node table to which the remote node index is * to be freed. * @remote_node_count: This is the count of consecutive remote nodes that are From patchwork Wed Mar 17 09:12:18 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403102 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294762jai; Wed, 17 Mar 2021 02:14:15 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwT1bOfGFtYQyFDizQGAevKcWA030W+Zx4vUaP/eQUgyfkVD/brpH+2oNwuWKQHBn0ojZxa X-Received: by 2002:a17:906:7389:: with SMTP id f9mr33995535ejl.423.1615972455709; Wed, 17 Mar 2021 02:14:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972455; cv=none; d=google.com; s=arc-20160816; b=Zts8IKzboR9xrX2i+hbiEJAdsoybtwj+y6Xk+TquRDRbtwtg/hQQpg9+ooDLAyLj0p dJIz0bsDEOQag7nzWPL+EzbZPdEEtRbv2RFvRudGZYGFIxzCg4fE+GsUG1o0PSiKWsuJ RxlmecVLvaVnoSXDgC5pz/o8Q8fu4HF2PRVJYzDhVujykJ9KDDPfcU4j7pAW0qIE7Lkq g8go4AXU9hjWU0Su/n4nQQFhthPH09qPTJ24gE4jHyM/pXEPUq7wchUJJOxKBfI7SrSW KlsrJKhoLipQCeCSqBioTmvWIqtEn8VbA79+kEUa/txksh8ohAxQPu7PQc1tUTvxya70 7+gg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=RSRsbfCO9Cf0f9DEirpibbVNzbe0r6NW41Oc9P5QERM=; b=SaNnAewJQLWpQDWLcNzQpb5vD0XnfFjCMtgI22xcA/3XsdfnIKC6M4e5WIC/y5RD0A FqX7yvjTH0B4brQ6OPN27G6yPoO6JY5RTqBw4iZ3iC3SIX1D71Jmk9CMHlV4/gGNKvWD RZ2wLJFK89PhGGJgbmrTxTza930/ojbbVws5UOJwn0+2zlEpzH2B+GNrDJWZZewnjwoI x7m4P3wClGdCkK9E84omu/CkQcoom2r+t2lTHyPwRLtsKa/IDW+KIQekp+LA+1uX9McX CuEG6NlMEShMb1gZKNw1OxU8OfRaPCRIzZnsKuBMVpo9W2d8IPZX3ZtIed/kmjNkbzNA m+Hw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=B9UmQZCX; 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 t15si15461864edq.164.2021.03.17.02.14.15 for ; Wed, 17 Mar 2021 02:14:15 -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=B9UmQZCX; 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 S231213AbhCQJNv (ORCPT ); Wed, 17 Mar 2021 05:13:51 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42748 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230405AbhCQJNR (ORCPT ); Wed, 17 Mar 2021 05:13:17 -0400 Received: from mail-wr1-x432.google.com (mail-wr1-x432.google.com [IPv6:2a00:1450:4864:20::432]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D3CA3C061763 for ; Wed, 17 Mar 2021 02:13:05 -0700 (PDT) Received: by mail-wr1-x432.google.com with SMTP id j18so1009567wra.2 for ; Wed, 17 Mar 2021 02:13: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=RSRsbfCO9Cf0f9DEirpibbVNzbe0r6NW41Oc9P5QERM=; b=B9UmQZCXrChcjGnSseaXL/8B1GG67+Q9AM8YIEqdFozJfacR5/RTobK2kKvkfGFHod hfIAA2wTHuRrDgtV/M5J9qW57zinJv8rJ3qs7UlyQNU9EPUfJgZY706MFchEu4S4mDiB AvMsONfEBC1dwpcsbWdZL+Y/glgFSdSzHC8Ay+WhytKLT36gsLEt06VpIG95alhwFOxG wqfwT63wqdxEyBbUbKke2z3El2mju344wkGs7d+2NHAHmTdYnx/WWVwvkgwT7PDUzJN6 J3sp/miM772E5mQiLUEmn88fqpiCIyOC98oya+mrC6gKd2sIqf4Dgt82bbWHDTlarFGY sIpA== 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=RSRsbfCO9Cf0f9DEirpibbVNzbe0r6NW41Oc9P5QERM=; b=DqwqugVegR7koW5QFoBKxMgZncnZOImOFvAXfsKWps/H79W9b13x64DsbAOH7qbR77 ZHwVo2TIIGNVkrvkNas0dozlgbmW6I3viYzpgARb1OBsm2Kw+bO7SAGavXS0/Ar1wkrT OcQPle8mxnphtdAscm1DizPvaQiqhf5N85V2O1eNsp/owEyvZycav5YKJ9Nh5vmomCS1 V15p9NHhuZ7ElMexmXCTsoUBXr/IsBWSDCJVr8iaqJ8sHcSTmtUuEUADjwAMje9Or0H2 ZoYHGxOJhqxDOtOHoCtLS9p86wd6TgyP2nQ1hDcOH9Fn0fL9MSGGsUFXBHx4xE1eQE+b treg== X-Gm-Message-State: AOAM530/SEWSVBAUnkQ+3LtcwQwXiCX7A+3wYz2mkFCaMB5fHTrHOpvH I/pz0TC3gaGXbijsJ29muIkh/Q== X-Received: by 2002:a5d:684d:: with SMTP id o13mr3435876wrw.235.1615972384631; Wed, 17 Mar 2021 02:13:04 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:04 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 24/36] scsi: isci: remote_node_context: Fix one function header and demote a couple more Date: Wed, 17 Mar 2021 09:12:18 +0000 Message-Id: <20210317091230.2912389-25-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/remote_node_context.c:77: warning: Cannot understand * drivers/scsi/isci/remote_node_context.c:167: warning: Cannot understand * drivers/scsi/isci/remote_node_context.c:206: warning: Cannot understand * Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/remote_node_context.c | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/remote_node_context.c b/drivers/scsi/isci/remote_node_context.c index 68333f523b351..7a576b995afae 100644 --- a/drivers/scsi/isci/remote_node_context.c +++ b/drivers/scsi/isci/remote_node_context.c @@ -74,7 +74,7 @@ const char *rnc_state_name(enum scis_sds_remote_node_context_states state) #undef C /** - * + * sci_remote_node_context_is_ready() * @sci_rnc: The state of the remote node context object to check. * * This method will return true if the remote node context is in a READY state @@ -163,12 +163,7 @@ static void sci_remote_node_context_construct_buffer(struct sci_remote_node_cont rnc->ssp.oaf_source_zone_group = 0; rnc->ssp.oaf_more_compatibility_features = 0; } -/** - * - * @sci_rnc: - * @callback: - * @callback_parameter: - * +/* * This method will setup the remote node context object so it will transition * to its ready state. If the remote node context is already setup to * transition to its final state then this function does nothing. none @@ -203,8 +198,6 @@ static void sci_remote_node_context_setup_to_destroy( } /** - * - * * This method just calls the user callback function and then resets the * callback. */ From patchwork Wed Mar 17 09:12:19 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403094 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294687jai; Wed, 17 Mar 2021 02:14:11 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyAVue6jXlsKZKt/Xwnm0pRedYcOyS1AY4naIMlc4aDcw+Yrtjo7yEk+ZPBxQtZnmVAVg1I X-Received: by 2002:a17:906:3e89:: with SMTP id a9mr17393526ejj.405.1615972451402; Wed, 17 Mar 2021 02:14:11 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972451; cv=none; d=google.com; s=arc-20160816; b=ocIFz7fpExsMZDGufxkOl24irMRhqLMOnaTMEQM43Ijr1gbiJx4Fnb1Ne3wBxFHR8B iiKrdfSq1M+PU5K8pmurwM44zPegJWsJdfRMKINSD2B6+DLrdG6xFF6RnaigxvppDVv0 X4X024yuazFyJgBnfg9C81EoiMm7Ng/d5fY/w9sg3dmOZ6nWAmW8CT2NGeyNlWoyDN/8 v7j0J7y5hvZnzOyelbImaqVPjW8MvbEux7gG02C1yLJ5tyK6coUllxTXJlCHIXJKEIVT FDoqYUR6lz6BpINyJ0COS/ev4JCwBMvkNctgy+mEjWfvNG9rG+DaJ/V6yD668Zu6YUZ6 RACw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=kZBkTcxO8EifQ0gwNY5E+sYyudmJwbLtlJKo3G5cZ8o=; b=sc7KwHgHBoqJmiPCByTRr47qmrvUvbygHy9bFS4L3Ojo/DU5VusQexYnj1m82CuWNv CY4GpZUSVo+UcT/gwmtOn0qE1QEfhIrImkblE49eLbQZP/W3XY1GW6ICnPUiocork3zK rcStvNNjqU/uClEz/PDepNSfGmZHSZRbS+Ap13NypQNlpBV0g6QtTXax8mm38aRBihxs YsroX+gsURqjAGyzMRKli8iDsxOQEsekyv3JyYQ7+smasZsPC4H71PJ6UWO+xnHaT4Bk wma4m/vPvDNlJxL/6VlDpLlS9NnIFGSfgpZmLvZ14VAXEX5pRvPXjjWDM6+AXpZpVc9x hbAg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=luP4yaV+; 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 t15si15461864edq.164.2021.03.17.02.14.11 for ; Wed, 17 Mar 2021 02:14:11 -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=luP4yaV+; 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 S231149AbhCQJNo (ORCPT ); Wed, 17 Mar 2021 05:13:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42760 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230254AbhCQJNH (ORCPT ); Wed, 17 Mar 2021 05:13:07 -0400 Received: from mail-wr1-x430.google.com (mail-wr1-x430.google.com [IPv6:2a00:1450:4864:20::430]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B2881C061760 for ; Wed, 17 Mar 2021 02:13:06 -0700 (PDT) Received: by mail-wr1-x430.google.com with SMTP id k8so1005792wrc.3 for ; Wed, 17 Mar 2021 02:13:06 -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=kZBkTcxO8EifQ0gwNY5E+sYyudmJwbLtlJKo3G5cZ8o=; b=luP4yaV+fwkHYQpmk1DQfKhl+/VEMhoQSAs7sCanrHcYLSoAgQnK2dwi1rZfKwJAx+ hN9QcsMOs6A2/ziGckyvTsgAaFmJA8yUW0+6XBkwnBY8tFsW5Agv1daO8X9N8262Gnys J5FAzcFnc49KjptwKOBsBXQk+n/iont0qcvPawzi+U4C1l+Awlln/jDvTN+33pnGDhMg Vj0laBJ5WzLaKSbS6Y46Hv3sIn9YS4/zSVQmOo+EwCvuOGLEtS/KNLUqLBEpjIvSFT90 HhEsUZ1pU/Icj341RTzYgrQXqEyM+yr3Cix0OwHoEZW6+5gZKavUU1S2zd14Kejb1CBV LtyA== 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=kZBkTcxO8EifQ0gwNY5E+sYyudmJwbLtlJKo3G5cZ8o=; b=Jjl+1X7o+9J/tLVy936Z6Zd6bovM15b26rmk40I89ZSt4THou8FYq8s1Xt582IDax4 x0dG5wycUU6l83TsiMPKbq91G0E4i1XNmY9Xz8Rq7BwHqQsknihjqK0p5ci9F6E9pste 5Fbez0093IVRd9pev49pQY4BNoR43QoeAAv32LOFwRLCJXCS+mYsfVH0lbJmKDK+ObeI IzuAF38PHnwxFGr0boNRiUbrpJ99M3CR5qzWNJ+B19sxj914Sx5i4Hh2zj98TlDZwPV0 5/8EiGkj5SqbS/jzAJycsxqt1FUUd04ot8g3A1IEW6ZBeVUJeVG3FqaFmWFZqxesV/MP k2YQ== X-Gm-Message-State: AOAM532aFjnaUMZ/Dtbp2dRDtERpThQF+a6FnPIeLd3Ju2GzzIwgPXWl hXNQ/pea7DDHOM55J092luIA8Q== X-Received: by 2002:a5d:4e52:: with SMTP id r18mr3534533wrt.28.1615972385442; Wed, 17 Mar 2021 02:13:05 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:05 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 25/36] scsi: isci: port_config: Fix a bunch of doc-rot and demote abuses Date: Wed, 17 Mar 2021 09:12:19 +0000 Message-Id: <20210317091230.2912389-26-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/port_config.c:76: warning: Cannot understand * drivers/scsi/isci/port_config.c:105: warning: Cannot understand * drivers/scsi/isci/port_config.c:148: warning: Cannot understand * drivers/scsi/isci/port_config.c:376: warning: Cannot understand * drivers/scsi/isci/port_config.c:607: warning: Function parameter or member 'ihost' not described in 'sci_apc_agent_link_up' drivers/scsi/isci/port_config.c:607: warning: Function parameter or member 'port_agent' not described in 'sci_apc_agent_link_up' drivers/scsi/isci/port_config.c:607: warning: Function parameter or member 'iport' not described in 'sci_apc_agent_link_up' drivers/scsi/isci/port_config.c:607: warning: Function parameter or member 'iphy' not described in 'sci_apc_agent_link_up' drivers/scsi/isci/port_config.c:607: warning: Excess function parameter 'scic' description in 'sci_apc_agent_link_up' drivers/scsi/isci/port_config.c:607: warning: Excess function parameter 'sci_port' description in 'sci_apc_agent_link_up' drivers/scsi/isci/port_config.c:607: warning: Excess function parameter 'sci_phy' description in 'sci_apc_agent_link_up' drivers/scsi/isci/port_config.c:623: warning: Cannot understand * drivers/scsi/isci/port_config.c:701: warning: Cannot understand * Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/port_config.c | 37 +++++++++++++++++---------------- 1 file changed, 19 insertions(+), 18 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/port_config.c b/drivers/scsi/isci/port_config.c index b1c1975055792..c382a257b51b9 100644 --- a/drivers/scsi/isci/port_config.c +++ b/drivers/scsi/isci/port_config.c @@ -73,7 +73,7 @@ enum SCIC_SDS_APC_ACTIVITY { * ****************************************************************************** */ /** - * + * sci_sas_address_compare() * @address_one: A SAS Address to be compared. * @address_two: A SAS Address to be compared. * @@ -102,9 +102,9 @@ static s32 sci_sas_address_compare( } /** - * - * @controller: The controller object used for the port search. - * @phy: The phy object to match. + * sci_port_configuration_agent_find_port() + * @ihost: The controller object used for the port search. + * @iphy: The phy object to match. * * This routine will find a matching port for the phy. This means that the * port and phy both have the same broadcast sas address and same received sas @@ -145,8 +145,8 @@ static struct isci_port *sci_port_configuration_agent_find_port( } /** - * - * @controller: This is the controller object that contains the port agent + * sci_port_configuration_agent_validate_ports() + * @ihost: This is the controller object that contains the port agent * @port_agent: This is the port configuration agent for the controller. * * This routine will validate the port configuration is correct for the SCU @@ -373,15 +373,16 @@ static void sci_mpc_agent_link_up(struct isci_host *ihost, } /** - * - * @controller: This is the controller object that receives the link down + * sci_mpc_agent_link_down() + * @ihost: This is the controller object that receives the link down * notification. - * @port: This is the port object associated with the phy. If the is no + * @port_agent: This is the port configuration agent for the controller. + * @iport: This is the port object associated with the phy. If the is no * associated port this is an NULL. The port is an invalid * handle only if the phy was never port of this port. This happens when * the phy is not broadcasting the same SAS address as the other phys in the * assigned port. - * @phy: This is the phy object which has gone link down. + * @iphy: This is the phy object which has gone link down. * * This function handles the manual port configuration link down notifications. * Since all ports and phys are associated at initialization time we just turn @@ -590,11 +591,12 @@ static void sci_apc_agent_configure_ports(struct isci_host *ihost, /** * sci_apc_agent_link_up - handle apc link up events - * @scic: This is the controller object that receives the link up + * @ihost: This is the controller object that receives the link up * notification. - * @sci_port: This is the port object associated with the phy. If the is no + * @port_agent: This is the port configuration agent for the controller. + * @iport: This is the port object associated with the phy. If the is no * associated port this is an NULL. - * @sci_phy: This is the phy object which has gone link up. + * @iphy: This is the phy object which has gone link up. * * This method handles the automatic port configuration for link up * notifications. Is it possible to get a link down notification from a phy @@ -620,9 +622,10 @@ static void sci_apc_agent_link_up(struct isci_host *ihost, } /** - * - * @controller: This is the controller object that receives the link down + * sci_apc_agent_link_down() + * @ihost: This is the controller object that receives the link down * notification. + * @port_agent: This is the port configuration agent for the controller. * @iport: This is the port object associated with the phy. If the is no * associated port this is an NULL. * @iphy: This is the phy object which has gone link down. @@ -697,9 +700,7 @@ static void apc_agent_timeout(struct timer_list *t) * Public port configuration agent routines * ****************************************************************************** */ -/** - * - * +/* * This method will construct the port configuration agent for operation. This * call is universal for both manual port configuration and automatic port * configuration modes. From patchwork Wed Mar 17 09:12:20 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403097 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294721jai; Wed, 17 Mar 2021 02:14:13 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwZWHjWOkOUMECHafQRHVlmS8lNxqeizGGnza5hfDwpye5O6u+d/4ikxR0wENdfeDzGtScK X-Received: by 2002:a17:906:398a:: with SMTP id h10mr34762318eje.155.1615972453226; Wed, 17 Mar 2021 02:14:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972453; cv=none; d=google.com; s=arc-20160816; b=dImhxYJkQmYMaxwBn2bwikDBVAmYueocvXnELNyH6nawrOWByqwruuI3C/BxN8P7Gw fWNEN/TonOHKcM01zwuUlcGgWVc/h+RVVTqFMbLXlKW/FSth7/7Eg3hggnYJcgyQFlRt nrxlgRCuCF55cg6kgTFVjnh6PGw58uD6vRS0dUcLty+ZTqtyJ3tYrYH3N9IihqNmFcPt ViuVS2Ceot3485fOpnSmvWm+ZoI1PJbfXW43dTwIhOorp0kHvEeu2IdFpwaCbpdFHe3P s7N5IvuTX5kg4PQ4KaDE/PKOK4IyoGkBV68I99LDySzYFJ5xgQfLLvSgVA2V9gX4zO45 X1Aw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=OhnfyqYrE6nzlDYMaUSwKVkj3wHq5/inwlljmfMJr4g=; b=Ec8i85l+Vs1OMK2bcP6swITfqK2KnFmmF3yuJ7tz0pbRw/vvD7D+35jST0/TYMP4B4 /XSTt9nOWmmbIVcAChq6lxTPZiC1SczwfqOTV6ORiBjkcqlPfw2U+y9eLjGxHRfFqIf+ 6LXnxcoQMjAOQ69kWdS3BAnBSH5wqilm8YI2zgYK/sA9vsmHOxEKXXTYHeORERLwbAv+ KnKSiV4SUmoMJRieB7DmhB6D6bFVwDNI73bpgZHCGvrbwAnIyivoUfLgE4iUi409WoZ9 TWyvqOFXpBSphH7iCo/pAdkztdQPQFTXrdorqu4bpgBs3Egf5WHlPun9dZ9VckRVpFno 5DBw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=oq6gMGCp; 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 t15si15461864edq.164.2021.03.17.02.14.13 for ; Wed, 17 Mar 2021 02:14: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=oq6gMGCp; 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 S231168AbhCQJNq (ORCPT ); Wed, 17 Mar 2021 05:13:46 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230270AbhCQJNI (ORCPT ); Wed, 17 Mar 2021 05:13:08 -0400 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 00855C06175F for ; Wed, 17 Mar 2021 02:13:07 -0700 (PDT) Received: by mail-wr1-x433.google.com with SMTP id e9so997036wrw.10 for ; Wed, 17 Mar 2021 02:13: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=OhnfyqYrE6nzlDYMaUSwKVkj3wHq5/inwlljmfMJr4g=; b=oq6gMGCp+1IVUkver2pNGwBGb3YllnTbfUJkhd4e/S22gLbOJfKgwWopVR7taYr4rY speAS2+XKik7crtgBRXoHF0u+v2DwNnbtwgE861pRWY0VYGyjasQymLvYB9XdXEK7BKy HFzh4j7v+6zEsMyFSaZXpGUORnP0BuOF848awJj8D0HXqFyPkrYAwVOHhtIvH4WsFbYE 2VKsw2+x+jGeOY3uPStF3ytb5FhKwNGK62JOhzozqwsZf9Z56lxNXVmamNVpWPkTFRge xh2Wq4UpZR8kP15BB7JsvuSULmWakv7A71/D9FvGhfJVHULDYo5XEF7MFm9sMIsYwGX5 fxTA== 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=OhnfyqYrE6nzlDYMaUSwKVkj3wHq5/inwlljmfMJr4g=; b=efH+z1poCi0VJbR8yVYTDcfQEpv+7NH7KMwNjKtQFpdGjqIsGROQWNJdegAXKs8jsT 92KA15nDVwIVpBwnMKvncGrQHjWnQDwTi3iPvxSs6KyiBYF2KwnmEvrTKYSVXKmFg0j8 xfRVWpkra/eLFkxd8ysOi1ikaduWjeVhoOFvnRTScJJxSIwsHoDmzkx41XzSrMaxq9sY cFz2/kTT4BnIS4CaHcz2IGqpsGsUWtsTYIsmw6Dn7GjPf+Hdv6U08Y877eRmJOCEr+1J aqeQ/PkEq0HxJTdlGbrPdkTbbL13xoA/Ey4BqoSlT7jQ1ASsH5ntWv1tGRmZoec3vFRV Nnyg== X-Gm-Message-State: AOAM533nmgCcOBiDkCuVkp75McivR7Cd6p1njmjD8ZPqw57He4aKuTCa sneLuAUiCmzXPPig/x+wFCKpTA== X-Received: by 2002:adf:8341:: with SMTP id 59mr3205749wrd.130.1615972386718; Wed, 17 Mar 2021 02:13:06 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:06 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 26/36] scsi: isci: remote_device: Fix a bunch of doc-rot issues Date: Wed, 17 Mar 2021 09:12:20 +0000 Message-Id: <20210317091230.2912389-27-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/remote_device.c:299: warning: Function parameter or member 'ihost' not described in 'isci_remote_device_not_ready' drivers/scsi/isci/remote_device.c:299: warning: Function parameter or member 'idev' not described in 'isci_remote_device_not_ready' drivers/scsi/isci/remote_device.c:299: warning: Function parameter or member 'reason' not described in 'isci_remote_device_not_ready' drivers/scsi/isci/remote_device.c:299: warning: Excess function parameter 'isci_host' description in 'isci_remote_device_not_ready' drivers/scsi/isci/remote_device.c:299: warning: Excess function parameter 'isci_device' description in 'isci_remote_device_not_ready' drivers/scsi/isci/remote_device.c:1015: warning: Function parameter or member 'idev' not described in 'sci_remote_device_destruct' drivers/scsi/isci/remote_device.c:1015: warning: Excess function parameter 'remote_device' description in 'sci_remote_device_destruct' drivers/scsi/isci/remote_device.c:1249: warning: Function parameter or member 'iport' not described in 'sci_remote_device_construct' drivers/scsi/isci/remote_device.c:1249: warning: Function parameter or member 'idev' not described in 'sci_remote_device_construct' drivers/scsi/isci/remote_device.c:1249: warning: Excess function parameter 'sci_port' description in 'sci_remote_device_construct' drivers/scsi/isci/remote_device.c:1249: warning: Excess function parameter 'sci_dev' description in 'sci_remote_device_construct' drivers/scsi/isci/remote_device.c:1275: warning: Function parameter or member 'iport' not described in 'sci_remote_device_da_construct' drivers/scsi/isci/remote_device.c:1275: warning: Function parameter or member 'idev' not described in 'sci_remote_device_da_construct' drivers/scsi/isci/remote_device.c:1311: warning: Function parameter or member 'iport' not described in 'sci_remote_device_ea_construct' drivers/scsi/isci/remote_device.c:1311: warning: Function parameter or member 'idev' not described in 'sci_remote_device_ea_construct' drivers/scsi/isci/remote_device.c:1453: warning: Function parameter or member 'idev' not described in 'sci_remote_device_start' drivers/scsi/isci/remote_device.c:1453: warning: Excess function parameter 'remote_device' description in 'sci_remote_device_start' drivers/scsi/isci/remote_device.c:1513: warning: Function parameter or member 'ihost' not described in 'isci_remote_device_alloc' drivers/scsi/isci/remote_device.c:1513: warning: Function parameter or member 'iport' not described in 'isci_remote_device_alloc' drivers/scsi/isci/remote_device.c:1513: warning: expecting prototype for This function builds the isci_remote_device when a libsas dev_found message(). Prototype was for isci_remote_device_alloc() instead drivers/scsi/isci/remote_device.c:1558: warning: Function parameter or member 'ihost' not described in 'isci_remote_device_stop' drivers/scsi/isci/remote_device.c:1558: warning: Function parameter or member 'idev' not described in 'isci_remote_device_stop' drivers/scsi/isci/remote_device.c:1558: warning: Excess function parameter 'isci_host' description in 'isci_remote_device_stop' drivers/scsi/isci/remote_device.c:1558: warning: Excess function parameter 'isci_device' description in 'isci_remote_device_stop' drivers/scsi/isci/remote_device.c:1592: warning: Function parameter or member 'dev' not described in 'isci_remote_device_gone' drivers/scsi/isci/remote_device.c:1592: warning: Excess function parameter 'domain_device' description in 'isci_remote_device_gone' drivers/scsi/isci/remote_device.c:1614: warning: Function parameter or member 'dev' not described in 'isci_remote_device_found' drivers/scsi/isci/remote_device.c:1614: warning: Excess function parameter 'domain_device' description in 'isci_remote_device_found' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/remote_device.c | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/remote_device.c b/drivers/scsi/isci/remote_device.c index b1276f7e49c89..866950a02965d 100644 --- a/drivers/scsi/isci/remote_device.c +++ b/drivers/scsi/isci/remote_device.c @@ -288,8 +288,9 @@ enum sci_status isci_remote_device_terminate_requests( * isci_remote_device_not_ready() - This function is called by the ihost when * the remote device is not ready. We mark the isci device as ready (not * "ready_for_io") and signal the waiting proccess. -* @isci_host: This parameter specifies the isci host object. -* @isci_device: This parameter specifies the remote device +* @ihost: This parameter specifies the isci host object. +* @idev: This parameter specifies the remote device +* @reason: Reason to switch on * * sci_lock is held on entrance to this function. */ @@ -1000,7 +1001,7 @@ static void sci_remote_device_initial_state_enter(struct sci_base_state_machine /** * sci_remote_device_destruct() - free remote node context and destruct - * @remote_device: This parameter specifies the remote device to be destructed. + * @idev: This parameter specifies the remote device to be destructed. * * Remote device objects are a limited resource. As such, they must be * protected. Thus calls to construct and destruct are mutually exclusive and @@ -1236,8 +1237,8 @@ static const struct sci_base_state sci_remote_device_state_table[] = { /** * sci_remote_device_construct() - common construction - * @sci_port: SAS/SATA port through which this device is accessed. - * @sci_dev: remote device to construct + * @iport: SAS/SATA port through which this device is accessed. + * @idev: remote device to construct * * This routine just performs benign initialization and does not * allocate the remote_node_context which is left to @@ -1256,7 +1257,7 @@ static void sci_remote_device_construct(struct isci_port *iport, SCIC_SDS_REMOTE_NODE_CONTEXT_INVALID_INDEX); } -/** +/* * sci_remote_device_da_construct() - construct direct attached device. * * The information (e.g. IAF, Signature FIS, etc.) necessary to build @@ -1294,7 +1295,7 @@ static enum sci_status sci_remote_device_da_construct(struct isci_port *iport, return SCI_SUCCESS; } -/** +/* * sci_remote_device_ea_construct() - construct expander attached device * * Remote node context(s) is/are a global resource allocated by this @@ -1439,7 +1440,7 @@ enum sci_status isci_remote_device_resume_from_abort( * sci_remote_device_start() - This method will start the supplied remote * device. This method enables normal IO requests to flow through to the * remote device. - * @remote_device: This parameter specifies the device to be started. + * @idev: This parameter specifies the device to be started. * @timeout: This parameter specifies the number of milliseconds in which the * start operation should complete. * @@ -1501,10 +1502,11 @@ static enum sci_status isci_remote_device_construct(struct isci_port *iport, } /** + * isci_remote_device_alloc() * This function builds the isci_remote_device when a libsas dev_found message * is received. - * @isci_host: This parameter specifies the isci host object. - * @port: This parameter specifies the isci_port connected to this device. + * @ihost: This parameter specifies the isci host object. + * @iport: This parameter specifies the isci_port connected to this device. * * pointer to new isci_remote_device. */ @@ -1549,8 +1551,8 @@ void isci_remote_device_release(struct kref *kref) /** * isci_remote_device_stop() - This function is called internally to stop the * remote device. - * @isci_host: This parameter specifies the isci host object. - * @isci_device: This parameter specifies the remote device. + * @ihost: This parameter specifies the isci host object. + * @idev: This parameter specifies the remote device. * * The status of the ihost request to stop. */ @@ -1585,8 +1587,7 @@ enum sci_status isci_remote_device_stop(struct isci_host *ihost, struct isci_rem /** * isci_remote_device_gone() - This function is called by libsas when a domain * device is removed. - * @domain_device: This parameter specifies the libsas domain device. - * + * @dev: This parameter specifies the libsas domain device. */ void isci_remote_device_gone(struct domain_device *dev) { @@ -1606,7 +1607,7 @@ void isci_remote_device_gone(struct domain_device *dev) * device is discovered. A remote device object is created and started. the * function then sleeps until the sci core device started message is * received. - * @domain_device: This parameter specifies the libsas domain device. + * @dev: This parameter specifies the libsas domain device. * * status, zero indicates success. */ From patchwork Wed Mar 17 09:12:21 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403095 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294699jai; Wed, 17 Mar 2021 02:14:11 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzov8+lmqzBLTduGONXPOi+ersa3g76WFAoiAM6n3r+puo5UzuJv2uEP0O1A6CmTLq8q4Zd X-Received: by 2002:a17:906:a2d3:: with SMTP id by19mr33494631ejb.98.1615972451773; Wed, 17 Mar 2021 02:14:11 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972451; cv=none; d=google.com; s=arc-20160816; b=Dm67NnFM+gJPv9EPjcm5khmdLe4sQtll7yBQGYpoiC3VixiI4PqcEWpwID3tUEijPq M4akTbvl6x1rrgERyqvgw2vrGzkeY7FmNNqkGlQimvevk2D4ChXA2dtJtyzjM/05nh2d mnYSdiHk2Ren3hN8Iu0U610DDgP8droVVrD+JY5HLlp9QDd8MgWbBa0qOWw4Nc6VumC/ UB5cT7jSDQNdEXEDwW5NcD31lFogqNpi0mHoGKHoetAVOjzf1vtgmZeF2+glNTKDpQDr UMOUqugQzbLUPLLugNdm/sODNDkvQel+ic5uJQZLAxULmzRuNWEqH/vvpqvmIqknPMmi g0XQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=IluqkSQMn8CKgpw5oiypEg9tUin6IKhqy/tdt7BWHLc=; b=HNTW+OGaU3WkTDRvBcqVcs6VG5ZDH5zzDZylDk/TUK5un47/jQsMdVQIvL8tcDoz8t EWzaxshyDKNwVWWo0GDhjDIATTBJqQNbDlpixpUhMg2iU4/CbYfcYqvVXHaC0cQe2t25 TLC2SoZRfNXUWQ+sTEFHZlqG9tpqz7aekP2BW9WksJKa7wQ2LHJytwdA1fvQ4qZAQ6Hp PFH1GubgrP1nuPkb8Ees/fE8MIzQ61ZaGmtuJaEcFQ1I7jGmrHUZJcN1uGJUmtoCNDjW npcDnHCcLSOVKBT6gxfkbAb7QkvPoWj1XG/yCTjp+DGzD9F4Qbgn8HhsT870UXcQ9+MF RqAQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=yaC9Ui5M; 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 t15si15461864edq.164.2021.03.17.02.14.11 for ; Wed, 17 Mar 2021 02:14:11 -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=yaC9Ui5M; 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 S229972AbhCQJNp (ORCPT ); Wed, 17 Mar 2021 05:13:45 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230287AbhCQJNJ (ORCPT ); Wed, 17 Mar 2021 05:13:09 -0400 Received: from mail-wr1-x42a.google.com (mail-wr1-x42a.google.com [IPv6:2a00:1450:4864:20::42a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E1CB5C061762 for ; Wed, 17 Mar 2021 02:13:08 -0700 (PDT) Received: by mail-wr1-x42a.google.com with SMTP id z2so1003625wrl.5 for ; Wed, 17 Mar 2021 02:13: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=IluqkSQMn8CKgpw5oiypEg9tUin6IKhqy/tdt7BWHLc=; b=yaC9Ui5M/Mnh0wAEIKT1N7sYEAlln2B+SYJlfs6ss6dUKqe/dbySB9lNTg+CFrc8Td i/opdyB7xjZOnZ6dC2ZffiCp/rEdUCS0jzpSdWpmPo9zVnRYXHSPz6emweQnGM5yt7Y+ NjNUTblzvlkdMDcGFH2gyl9e6/R90cgTT/j6yaj+mscqX5DF0O9TVgO/2N8Yle9rn4TN DFFMLGTbVnrR7d2n7iQKjqZEyS2bXVGXxPefGQ8w6IEUJ1E8Sj671Pp5YY0SliGfJ+AW qmnv4fK6kHOMHLyUDBButQM7IUqAe+RURxvuM9maUGwSB0yGeGgOlfwCISKmxtz/r+cS Uccw== 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=IluqkSQMn8CKgpw5oiypEg9tUin6IKhqy/tdt7BWHLc=; b=LgCYNz4beoCy/5wEkRgBKwOQ4EwBNnQUk+mixVYR9pxv+v33BiuzadlX1rE+eEoRPi s54/sOqA6uVFQj8if89mRVWMdDK0hnmLxpZl3PSd4yV2P1psBHAajzwczg+E2HUPtBIL +dBn3+pLWH0yqT8l3DYOOAaMLgYHM3kCVCq+VFWIOZUm469cL+aU1fS2gZtqpp/eqPOd 3cwNVESU6XwYGdUGaRwoMNUNar7EJK3uRY68iW5QpqF0wpEtQ/9/ot0kJ4g1B17eKDTK OCmaGRcRn65LhvZaWcopgKfXW4oZf2DQckP2WC1KvYCDx32kXYa7QpSZUOudj0CBT4TX JCsw== X-Gm-Message-State: AOAM532fSDVsA6HrRt0fSUsMbAcuGb29Gvuv3MlwT3d+gaJZfIp/ZbPp rcVRSYkSio4yUPVZ7A8B/YFaUg== X-Received: by 2002:adf:f948:: with SMTP id q8mr3333367wrr.296.1615972387660; Wed, 17 Mar 2021 02:13:07 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:07 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 27/36] scsi: isci: request: Fix doc-rot issue relating to 'ireq' param Date: Wed, 17 Mar 2021 09:12:21 +0000 Message-Id: <20210317091230.2912389-28-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/request.c:496: warning: Function parameter or member 'ireq' not described in 'scu_sata_request_construct_task_context' drivers/scsi/isci/request.c:496: warning: Excess function parameter 'sci_req' description in 'scu_sata_request_construct_task_context' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/request.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/isci/request.c b/drivers/scsi/isci/request.c index 49ab2555c0cdf..593b38c59924a 100644 --- a/drivers/scsi/isci/request.c +++ b/drivers/scsi/isci/request.c @@ -481,7 +481,7 @@ static void scu_ssp_task_request_construct_task_context(struct isci_request *ire * scu_sata_request_construct_task_context() * This method is will fill in the SCU Task Context for any type of SATA * request. This is called from the various SATA constructors. - * @sci_req: The general IO request object which is to be used in + * @ireq: The general IO request object which is to be used in * constructing the SCU task context. * @task_context: The buffer pointer for the SCU task context which is being * constructed. From patchwork Wed Mar 17 09:12:22 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403098 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294731jai; Wed, 17 Mar 2021 02:14:13 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyHUkzSwTEb2RKfvieFFJiFKZl2ZG4hbioGewslWk2EILuOIXe0QLhrE5TOJ3u2OpzIgCYp X-Received: by 2002:a17:906:f10c:: with SMTP id gv12mr34346988ejb.53.1615972453562; Wed, 17 Mar 2021 02:14:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972453; cv=none; d=google.com; s=arc-20160816; b=Jb1xdmjKH0qRW0//T/GSVSpi1PiRz5w3rxxJn7fJHh+THM5DCRlI9dESDSmpskfwzx rJspPX9qGqBYGpnZLYfwVnRJJPzpx3rzDpNi3fw542z/tjFMZ4k9mSxuawL4Qtb0OFFj VADsFaDmaqSDSYkTucwknsiyvWduCR6tG24n8F8O7HFbCja5m9cOQPmM5gVzGPQq3iqV NNa11d1ZMl2fzWqpyxNYKscoOVulvjKy4ELPHWAgN4PNYIrPkhEAoUGM6vrXFF2jBBwq YGupRmB+ptFjjRHB+p7QVQjfvD7T/06tu9MPzwRvaoX4sw6zP2s3z+speMTauV3e8c6M sz/w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=fNw4jZUecOl7ZFIahTA4vjB4JeA3UkCpE7Qa3MdiWdM=; b=w2LhiGRrKN7UDngpwhzKqn9voiyWPfOVzChboKwsi8IHRD2/JEd0NXUYhIKlrmZOL5 I22dsPWJDpO3vLbo5oqJ8tlsgNiWa6Ajav9W8Np99riHnfg8xuuyyvRT2PvpaIBnPaaL 7E01CGLatzmTCUklHmlgDHxHFCbFAPzTEeSw+3P4WPQbtmmjrKLG4y4H3RcDnBamhsoT GUVyyScRd4NpUMeMIxNwgz55kAvQUmhj0Vs9yZCwUR4Dc1XY19PIy669KxS/JVn9uLAU 9bcCWD6iTmTsT9jRz8gjGuiBkPdKsrkSwwL1GZXd8FcInkaDqc595vAGaZB297szweAV riLA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=bTxzXrxb; 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 t15si15461864edq.164.2021.03.17.02.14.13 for ; Wed, 17 Mar 2021 02:14: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=bTxzXrxb; 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 S231183AbhCQJNr (ORCPT ); Wed, 17 Mar 2021 05:13:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42760 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230290AbhCQJNK (ORCPT ); Wed, 17 Mar 2021 05:13:10 -0400 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D4FD6C061760 for ; Wed, 17 Mar 2021 02:13:09 -0700 (PDT) Received: by mail-wr1-x433.google.com with SMTP id v4so992073wrp.13 for ; Wed, 17 Mar 2021 02:13: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=fNw4jZUecOl7ZFIahTA4vjB4JeA3UkCpE7Qa3MdiWdM=; b=bTxzXrxbu/7ViHtc9cONzNsgRMR25BL7okAd45pBJEnHuMsQe6n25d/I3qWaO87eXx WHvZ+yPWGmMQOY/Lv4OLel3rljYrzcoI0jZIAKWBC1XaVP6q7cQn8DrPJ4okm4RKVl1n uz2wnEzlRGeDrUg7KLakMYWwJyLvp34BvsWX92PQmjPFeyrnFYfVGN+TSzFoHVYwg0jH QhEi58nPo16CWZV+g3WOliU4WOvuykrCryu1UzFTjmq5Iks9FwWLnKsQd2DSWDjRWA8G wEimbpstuyftoW3oxVLGXqPlseaPdaxB6IV+GtcwmzBIRBjhs1BCT5g6fY2ckjB2xiHY CKdg== 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=fNw4jZUecOl7ZFIahTA4vjB4JeA3UkCpE7Qa3MdiWdM=; b=Ar2b723GHwflTnj0O1Rutxo11PGIr6OuydMCl47NtGnRZ17/9iFq2TJg5xwf4HiMaw y2t4hIA+Uomv/1Hroff5pO5KFWpN7MSiVwS++xQb7N6DvE+QXem5p0sIC2rL2GnRm9jo khqDKQGcDxm4YrLlRcqFbSVnD0PrrTUljuY+5L95wJB6LDcVZx39fmj1cjGk+glh29BK WGPzwzdXCjluhlGNzvfLZs5lJXAN59XEADZbOSrFECBnY1UVPAywNuM5lU7M0B/oBbcH FtTbwzBjA0NIU+uFCE8nuhcArM7QpOLQ6L3MU5pM9DwL91mhqtcHhfWdtv4ehOir9AYP e4UA== X-Gm-Message-State: AOAM530OARt7vdCAqSMNzEKP74yRwpS2RIciqsMosHtghzJQFDz1hUz1 ciBu9ukrFv89jnN56XeHhFGdFw== X-Received: by 2002:adf:9544:: with SMTP id 62mr3295141wrs.128.1615972388614; Wed, 17 Mar 2021 02:13:08 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:08 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 28/36] scsi: isci: port: Fix a bunch of kernel-doc issues Date: Wed, 17 Mar 2021 09:12:22 +0000 Message-Id: <20210317091230.2912389-29-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/port.c:130: warning: Function parameter or member 'iport' not described in 'sci_port_get_properties' drivers/scsi/isci/port.c:130: warning: Function parameter or member 'prop' not described in 'sci_port_get_properties' drivers/scsi/isci/port.c:130: warning: Excess function parameter 'port' description in 'sci_port_get_properties' drivers/scsi/isci/port.c:130: warning: Excess function parameter 'properties' description in 'sci_port_get_properties' drivers/scsi/isci/port.c:243: warning: Function parameter or member 'isci_phy' not described in 'isci_port_link_down' drivers/scsi/isci/port.c:243: warning: Function parameter or member 'isci_port' not described in 'isci_port_link_down' drivers/scsi/isci/port.c:243: warning: Excess function parameter 'phy' description in 'isci_port_link_down' drivers/scsi/isci/port.c:243: warning: Excess function parameter 'port' description in 'isci_port_link_down' drivers/scsi/isci/port.c:318: warning: Function parameter or member 'isci_port' not described in 'isci_port_hard_reset_complete' drivers/scsi/isci/port.c:318: warning: Excess function parameter 'port' description in 'isci_port_hard_reset_complete' drivers/scsi/isci/port.c:398: warning: Cannot understand * drivers/scsi/isci/port.c:544: warning: Function parameter or member 'iport' not described in 'sci_port_construct_dummy_rnc' drivers/scsi/isci/port.c:544: warning: Excess function parameter 'sci_port' description in 'sci_port_construct_dummy_rnc' drivers/scsi/isci/port.c:692: warning: Function parameter or member 'iport' not described in 'sci_port_general_link_up_handler' drivers/scsi/isci/port.c:692: warning: Function parameter or member 'iphy' not described in 'sci_port_general_link_up_handler' drivers/scsi/isci/port.c:692: warning: Excess function parameter 'sci_port' description in 'sci_port_general_link_up_handler' drivers/scsi/isci/port.c:692: warning: Excess function parameter 'sci_phy' description in 'sci_port_general_link_up_handler' drivers/scsi/isci/port.c:719: warning: wrong kernel-doc identifier on line: drivers/scsi/isci/port.c:756: warning: Function parameter or member 'iport' not described in 'sci_port_link_detected' drivers/scsi/isci/port.c:756: warning: Function parameter or member 'iphy' not described in 'sci_port_link_detected' drivers/scsi/isci/port.c:756: warning: expecting prototype for if the(). Prototype was for sci_port_link_detected() instead drivers/scsi/isci/port.c:821: warning: wrong kernel-doc identifier on line: drivers/scsi/isci/port.c:885: warning: Function parameter or member 'iport' not described in 'sci_port_post_dummy_request' drivers/scsi/isci/port.c:885: warning: Excess function parameter 'sci_port' description in 'sci_port_post_dummy_request' drivers/scsi/isci/port.c:909: warning: Function parameter or member 'iport' not described in 'sci_port_abort_dummy_request' drivers/scsi/isci/port.c:909: warning: expecting prototype for This will alow the hardware to(). Prototype was for sci_port_abort_dummy_request() instead drivers/scsi/isci/port.c:926: warning: Cannot understand * drivers/scsi/isci/port.c:1017: warning: Cannot understand * drivers/scsi/isci/port.c:1199: warning: Function parameter or member 'iport' not described in 'sci_port_add_phy' drivers/scsi/isci/port.c:1199: warning: Function parameter or member 'iphy' not described in 'sci_port_add_phy' drivers/scsi/isci/port.c:1199: warning: Excess function parameter 'sci_port' description in 'sci_port_add_phy' drivers/scsi/isci/port.c:1199: warning: Excess function parameter 'sci_phy' description in 'sci_port_add_phy' drivers/scsi/isci/port.c:1270: warning: Function parameter or member 'iport' not described in 'sci_port_remove_phy' drivers/scsi/isci/port.c:1270: warning: Function parameter or member 'iphy' not described in 'sci_port_remove_phy' drivers/scsi/isci/port.c:1270: warning: Excess function parameter 'sci_port' description in 'sci_port_remove_phy' drivers/scsi/isci/port.c:1270: warning: Excess function parameter 'sci_phy' description in 'sci_port_remove_phy' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/port.c | 58 +++++++++++++++++++++------------------- 1 file changed, 30 insertions(+), 28 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/port.c b/drivers/scsi/isci/port.c index 5a362ba76d63f..d5f550d5a4824 100644 --- a/drivers/scsi/isci/port.c +++ b/drivers/scsi/isci/port.c @@ -115,9 +115,9 @@ static u32 sci_port_get_phys(struct isci_port *iport) /** * sci_port_get_properties() - This method simply returns the properties * regarding the port, such as: physical index, protocols, sas address, etc. - * @port: this parameter specifies the port for which to retrieve the physical + * @iport: this parameter specifies the port for which to retrieve the physical * index. - * @properties: This parameter specifies the properties structure into which to + * @prop: This parameter specifies the properties structure into which to * copy the requested information. * * Indicate if the user specified a valid port. SCI_SUCCESS This value is @@ -233,8 +233,8 @@ static void isci_port_link_up(struct isci_host *isci_host, * isci_port_link_down() - This function is called by the sci core when a link * becomes inactive. * @isci_host: This parameter specifies the isci host object. - * @phy: This parameter specifies the isci phy with the active link. - * @port: This parameter specifies the isci port with the active link. + * @isci_phy: This parameter specifies the isci phy with the active link. + * @isci_port: This parameter specifies the isci port with the active link. * */ static void isci_port_link_down(struct isci_host *isci_host, @@ -308,7 +308,7 @@ static void port_state_machine_change(struct isci_port *iport, /** * isci_port_hard_reset_complete() - This function is called by the sci core * when the hard reset complete notification has been received. - * @port: This parameter specifies the sci port with the active link. + * @isci_port: This parameter specifies the sci port with the active link. * @completion_status: This parameter specifies the core status for the reset * process. * @@ -395,9 +395,10 @@ bool sci_port_is_valid_phy_assignment(struct isci_port *iport, u32 phy_index) } /** - * - * @sci_port: This is the port object for which to determine if the phy mask + * sci_port_is_phy_mask_valid() + * @iport: This is the port object for which to determine if the phy mask * can be supported. + * @phy_mask: Phy mask belonging to this port * * This method will return a true value if the port's phy mask can be supported * by the SCU. The following is a list of valid PHY mask configurations for @@ -533,7 +534,7 @@ void sci_port_get_attached_sas_address(struct isci_port *iport, struct sci_sas_a /** * sci_port_construct_dummy_rnc() - create dummy rnc for si workaround * - * @sci_port: logical port on which we need to create the remote node context + * @iport: logical port on which we need to create the remote node context * @rni: remote node index for this remote node context. * * This routine will construct a dummy remote node context data structure @@ -677,8 +678,8 @@ static void sci_port_invalid_link_up(struct isci_port *iport, struct isci_phy *i /** * sci_port_general_link_up_handler - phy can be assigned to port? - * @sci_port: sci_port object for which has a phy that has gone link up. - * @sci_phy: This is the struct isci_phy object that has gone link up. + * @iport: sci_port object for which has a phy that has gone link up. + * @iphy: This is the struct isci_phy object that has gone link up. * @flags: PF_RESUME, PF_NOTIFY to sci_port_activate_phy * * Determine if this phy can be assigned to this port . If the phy is @@ -716,10 +717,11 @@ static void sci_port_general_link_up_handler(struct isci_port *iport, /** + * sci_port_is_wide() * This method returns false if the port only has a single phy object assigned. * If there are no phys or more than one phy then the method will return * true. - * @sci_port: The port for which the wide port condition is to be checked. + * @iport: The port for which the wide port condition is to be checked. * * bool true Is returned if this is a wide ported port. false Is returned if * this is a narrow port. @@ -739,12 +741,13 @@ static bool sci_port_is_wide(struct isci_port *iport) } /** + * sci_port_link_detected() * This method is called by the PHY object when the link is detected. if the * port wants the PHY to continue on to the link up state then the port * layer must return true. If the port object returns false the phy object * must halt its attempt to go link up. - * @sci_port: The port associated with the phy object. - * @sci_phy: The phy object that is trying to go link up. + * @iport: The port associated with the phy object. + * @iphy: The phy object that is trying to go link up. * * true if the phy object can continue to the link up condition. true Is * returned if this phy can continue to the ready state. false Is returned if @@ -817,10 +820,8 @@ static void port_timeout(struct timer_list *t) /* --------------------------------------------------------------------------- */ -/** +/* * This function updates the hardwares VIIT entry for this port. - * - * */ static void sci_port_update_viit_entry(struct isci_port *iport) { @@ -874,7 +875,7 @@ static void sci_port_suspend_port_task_scheduler(struct isci_port *iport) /** * sci_port_post_dummy_request() - post dummy/workaround request - * @sci_port: port to post task + * @iport: port to post task * * Prevent the hardware scheduler from posting new requests to the front * of the scheduler queue causing a starvation problem for currently @@ -899,10 +900,11 @@ static void sci_port_post_dummy_request(struct isci_port *iport) } /** + * sci_port_abort_dummy_request() * This routine will abort the dummy request. This will alow the hardware to * power down parts of the silicon to save power. * - * @sci_port: The port on which the task must be aborted. + * @iport: The port on which the task must be aborted. * */ static void sci_port_abort_dummy_request(struct isci_port *iport) @@ -923,8 +925,8 @@ static void sci_port_abort_dummy_request(struct isci_port *iport) } /** - * - * @sci_port: This is the struct isci_port object to resume. + * sci_port_resume_port_task_scheduler() + * @iport: This is the struct isci_port object to resume. * * This method will resume the port task scheduler for this port object. none */ @@ -1014,8 +1016,8 @@ static void sci_port_invalidate_dummy_remote_node(struct isci_port *iport) } /** - * - * @object: This is the object which is cast to a struct isci_port object. + * sci_port_ready_substate_operational_exit() + * @sm: This is the object which is cast to a struct isci_port object. * * This method will perform the actions required by the struct isci_port on * exiting the SCI_PORT_SUB_OPERATIONAL. This function reports @@ -1186,9 +1188,9 @@ static enum sci_status sci_port_hard_reset(struct isci_port *iport, u32 timeout) } /** - * sci_port_add_phy() - - * @sci_port: This parameter specifies the port in which the phy will be added. - * @sci_phy: This parameter is the phy which is to be added to the port. + * sci_port_add_phy() + * @iport: This parameter specifies the port in which the phy will be added. + * @iphy: This parameter is the phy which is to be added to the port. * * This method will add a PHY to the selected port. This method returns an * enum sci_status. SCI_SUCCESS the phy has been added to the port. Any other @@ -1257,9 +1259,9 @@ enum sci_status sci_port_add_phy(struct isci_port *iport, } /** - * sci_port_remove_phy() - - * @sci_port: This parameter specifies the port in which the phy will be added. - * @sci_phy: This parameter is the phy which is to be added to the port. + * sci_port_remove_phy() + * @iport: This parameter specifies the port in which the phy will be added. + * @iphy: This parameter is the phy which is to be added to the port. * * This method will remove the PHY from the selected PORT. This method returns * an enum sci_status. SCI_SUCCESS the phy has been removed from the port. Any From patchwork Wed Mar 17 09:12:23 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403096 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294706jai; Wed, 17 Mar 2021 02:14:12 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyxYkg3VbsmEogPZWq7DkCKnn6RACs8T6T9yfbh/3R6m0JtR375wV8nN22abK8glRXHekLg X-Received: by 2002:a17:906:398a:: with SMTP id h10mr34762258eje.155.1615972452133; Wed, 17 Mar 2021 02:14:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972452; cv=none; d=google.com; s=arc-20160816; b=DAzWtABEfuVQrs7La1FeSLmc1QiB2cGYHdQAzkYvafJZ8173TvspYC5IO/1bXVdXqc eAWkeRTqONUhlkpNEHaezyHYxumNSUOv9dRXk2w2jbf1SpNAdPhZC5LQhvNFExQ3+xbK 8dUoargRtVsaxjWkym6dj+n7zFYHg5UGCV0ZYRQsZvD/yvfdsxa23+YW/7b0WugC+YZ7 FgfF+Ry43avONBJTdBByASnQyjG07nxaSrqQ9HFGWzIvo9gu4N7FueXlNzWsRjaFmclC ceGklbPO2ZdD+QMeGN8U8sivh8ujcMnbSjqAhtdJL43LWFM126Gov3w0rbLV1+y8Dj31 n0DA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=hdrx4ZDIqWWXCMIUIHjqy5M6xHh5UviAprBwzcqZnso=; b=cKb8iRzfSNlI+3ZWfYQBJKbzD0Fgi1CjpsOPus3Jr2vTAfuPGefF7DGyslL/I6Y341 7x7zfJ7aYlmeyoXa7p0yo4fLomfj9L1DKRCcKGta0bg51hwhuCW3SiNgyyxbo5vhbzmx OK+PI3qeFZbJKmoM2oAXQeodOV3qgwsVhL7Q8ud73OhIqo99rQsFjejti3oz2+Tl0SUV hIO5ANRGt/ad3zl0psBGFaPCZDtbpnLJ/JfWtPkfZN5a5GKUck1BW4S9z6F8C/kDZyYI 9vL3BU9n8TKMmPX2rxVrDjQ4vRL4ir/3p01Hx351FSRGf0r9JLVduNHhnpVU9SoSyXiK gBfw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=ADMZ9cq3; 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 t15si15461864edq.164.2021.03.17.02.14.12 for ; Wed, 17 Mar 2021 02:14:12 -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=ADMZ9cq3; 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 S231173AbhCQJNr (ORCPT ); Wed, 17 Mar 2021 05:13:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230307AbhCQJNL (ORCPT ); Wed, 17 Mar 2021 05:13:11 -0400 Received: from mail-wr1-x436.google.com (mail-wr1-x436.google.com [IPv6:2a00:1450:4864:20::436]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C675EC06175F for ; Wed, 17 Mar 2021 02:13:10 -0700 (PDT) Received: by mail-wr1-x436.google.com with SMTP id 61so992215wrm.12 for ; Wed, 17 Mar 2021 02:13: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=hdrx4ZDIqWWXCMIUIHjqy5M6xHh5UviAprBwzcqZnso=; b=ADMZ9cq3UjXb3mFr70/P7f/svyjPjcoI6pNxsw1Z1In3b/CCiehItfmDGj8ShIivIK sqy6mFvwDowypd8BjJdYzyNHlfOODXxH4ib+zKFotJmkyDk1TtlCP9FxCXd1KkVXFkWq o3vGEzMNGbkrur5BODNFI8Y7taNO03DnMXv94iTr22aM4s6jshxXVQcaOswE+f7ujBqQ CshP9pNxx6hBEOd0Ax9ftbmnyyWwZ7gksmrOrcHBcF4ZJljDletomLYVyIe+I1Dqh6AV EUdgHWw/dUTY+Hi7+fz9ehbY4/3g1vElEs4m3fnHjEEl2JDohvhaxoDrje99Tx0eSPZ7 pRUQ== 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=hdrx4ZDIqWWXCMIUIHjqy5M6xHh5UviAprBwzcqZnso=; b=tNCqyh68sfDM4rhqEEWfGigIToGehSlyoEVjtGVpgBM7SNUe9+SiH4QTXqhCuVpHiU 1GtzQkmHpcEfXUBq4WKhzX4u1l3l2bsstlrtIcCQ+kBEwZmnHfEBQogLpUymysNLPxZy 4N7c2+mC6FAERTVOFeFzD7pl1ra4jatQKn8PoHvZCBAMuc2apbipCGj7KTgnoyUzaEG/ XSz6K9rVZVNYc1YGBFRRrzJiDaGnUh1KJnkKXpAAPAHpi72PbcCwDUjN9Lsp/aoLdB8f 2KepDiWx1K3IEOlnkYitBLwqQNats8Pb6n4MqozOQD/mymHRczWWuhNwzIa3THb3oVy9 ydKg== X-Gm-Message-State: AOAM532Cs7ghasADqmmSwnLo0TGoT7ZUdAUFu1epALrk2CGzC3A+Pnwz yyocipv6myZm3fWvqzoMIgyWWg== X-Received: by 2002:a5d:5088:: with SMTP id a8mr3404299wrt.294.1615972389604; Wed, 17 Mar 2021 02:13:09 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:09 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 29/36] scsi: isci: remote_node_context: Demote kernel-doc abuse Date: Wed, 17 Mar 2021 09:12:23 +0000 Message-Id: <20210317091230.2912389-30-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/remote_node_context.c:206: warning: Function parameter or member 'rnc' not described in 'sci_remote_node_context_notify_user' drivers/scsi/isci/remote_node_context.c:206: warning: expecting prototype for This method just calls the user callback function and then resets the(). Prototype was for sci_remote_node_context_notify_user() instead Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/remote_node_context.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) -- 2.27.0 diff --git a/drivers/scsi/isci/remote_node_context.c b/drivers/scsi/isci/remote_node_context.c index 7a576b995afae..77ba0291134e2 100644 --- a/drivers/scsi/isci/remote_node_context.c +++ b/drivers/scsi/isci/remote_node_context.c @@ -197,7 +197,7 @@ static void sci_remote_node_context_setup_to_destroy( wake_up(&ihost->eventq); } -/** +/* * This method just calls the user callback function and then resets the * callback. */ From patchwork Wed Mar 17 09:12:24 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403099 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294736jai; Wed, 17 Mar 2021 02:14:14 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwmOcgJn9UM6dm8GO1tco7A96ZcAiCdwTETbxxpnigxh+0PL2YfZG4w2B6lDdsbIiv5Pkd8 X-Received: by 2002:a05:6402:1115:: with SMTP id u21mr40862704edv.383.1615972453894; Wed, 17 Mar 2021 02:14:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972453; cv=none; d=google.com; s=arc-20160816; b=EaK9sauaYzv8oIElr0bBHLzRrBTPaOXV2O455iRH4gYW5+jDXoI0XATj8B3VgXsbBK 3KHgHvYv8YZ7gjGZHDqZFCbo8i3SoPtlG6W2SFC/HppfPz+JAfLwOt9mwXS5V5vckNeQ yuC+Y7LdoTQId6TC2LDPPR5XDvYru4qbjcu+H8whZ8cKRUT1sT5mx635W4Upq8zmOTto wygzzfVObeZRVm+XEkq8+/T9WNlmc6J3lR5bKPcselAJoLOc/FgRKZd3S8D71xmqaR+w cW8ckT9kq3bk4wX1WsAjE0rMeNxeP3WBrFXNoyQx2x7yA3fbadDqNbwZ1JBVHcP9VDZH Vu/A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=INYaEaBKekTmocE41+zT9bavsNeUW3SsypgM5hto0Go=; b=gsYZqM4ngYorEYB1sCrKlz8syCIQ2g+KgdiEQCuzF2AE8OcuXi6V4If1bW45C0bJs8 MVvS4ZpzYpGmyxkIwP8lX6c7PHAkWz7y+XgnY/nMEYAJuza0HAHk8kq/zUfXSjRctMm8 ZMCLqeC6DzYTjaRdaoc7kbuRlxxmnkPj6iuf9kW89UjPjZxjSWAxQUoZCNiNJ1rHDWoJ wa0Va9kjjGy0bDkS2TqOatbDxksg1Jh7zpx6UHA8DBjJn79oGmmXRv/AD9Wxqs2kBP9c HDnn5F90on5AkHo2LuuITPNRmlxyQ9QVwV21rDt7Zkt6bPLqz1ozySVi1VE084CAwKYR RABg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=LU0MfM5V; 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 t15si15461864edq.164.2021.03.17.02.14.13 for ; Wed, 17 Mar 2021 02:14: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=LU0MfM5V; 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 S230119AbhCQJNs (ORCPT ); Wed, 17 Mar 2021 05:13:48 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230317AbhCQJNM (ORCPT ); Wed, 17 Mar 2021 05:13:12 -0400 Received: from mail-wr1-x42f.google.com (mail-wr1-x42f.google.com [IPv6:2a00:1450:4864:20::42f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9B4D0C06175F for ; Wed, 17 Mar 2021 02:13:11 -0700 (PDT) Received: by mail-wr1-x42f.google.com with SMTP id e18so1004339wrt.6 for ; Wed, 17 Mar 2021 02:13: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=INYaEaBKekTmocE41+zT9bavsNeUW3SsypgM5hto0Go=; b=LU0MfM5VANlz8Slj6C6ags2MZIeEQa5EYWniMaJEraXg9Zygc+80pbha8ds8vB2gO5 Gr46OwwH2LPxxqqTWkZ0gwNP/GKglfNqGEJ2S62m4GFVwEVEucMri5byPMwyaSUC2v0Q i/2WUUqltY9W9s92n7HZv28+8vt+I/YTFDFLi5/jzNj9UeKKyzOxSqT1FSTkZdybwjKm N1X91jPLwH7sWFacydU7Dwcv0jn9bQiFJa/69stdk3crrCfVbavNOloWACIYctqiVhaf jloCALTCkZF5KuMNBgJRwFJtrSrTzgy/6HcNuX4feeovknp6fh3YEsXFm4zTQTsxc4dc nekQ== 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=INYaEaBKekTmocE41+zT9bavsNeUW3SsypgM5hto0Go=; b=XdOIqO1MNrhPeXqvzzTOwuxNHxtkRMnLFIEnFdLdxk5pJ87dAQAHAbHRU4R9Tsju0h s5cqoJe5+UnRLMfvnr1dHDKLL5WJReE7TlWEikf2+oEEqFkZtjNrQuDRKIA/0FuaXTor Mkp82BFJv1m/WphQdbtAzcS5b/igoEq7fWHIfuoPytCNASEUW1WOimdNmvpBmJ+yBeGI +Z7m/BNLullkhXtvKQA6powMEMywC9/FK47fSSNnUSsi7uscATsR+6wQufA4Ao3Ztkbl UGq6msl9AN4LW66TA5QTnX9uJTjcKc+uQhLfLyjeD1ttle6I/3RZH2kqdS6cx/bHgjvr DBwg== X-Gm-Message-State: AOAM530xSpJJsZGAe4czUqbHqwliVyVQW2wNOn0zIWqJEJeY69RqVdTd 7vd1VxjAMksfbsBRsx9vwUSWHg== X-Received: by 2002:adf:b30f:: with SMTP id j15mr3361475wrd.132.1615972390441; Wed, 17 Mar 2021 02:13:10 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:10 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Artur Paszkiewicz , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 30/36] scsi: isci: remote_node_table: Provide some missing params and remove others Date: Wed, 17 Mar 2021 09:12:24 +0000 Message-Id: <20210317091230.2912389-31-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/isci/remote_node_table.c:113: warning: Function parameter or member 'group_table_index' not described in 'sci_remote_node_table_clear_group_index' drivers/scsi/isci/remote_node_table.c:113: warning: Excess function parameter 'set_index' description in 'sci_remote_node_table_clear_group_index' drivers/scsi/isci/remote_node_table.c:262: warning: Function parameter or member 'group_index' not described in 'sci_remote_node_table_set_group' drivers/scsi/isci/remote_node_table.c:383: warning: Function parameter or member 'group_table_index' not described in 'sci_remote_node_table_allocate_single_remote_node' drivers/scsi/isci/remote_node_table.c:383: warning: Excess function parameter 'table_index' description in 'sci_remote_node_table_allocate_single_remote_node' drivers/scsi/isci/remote_node_table.c:516: warning: Function parameter or member 'remote_node_index' not described in 'sci_remote_node_table_release_single_remote_node' drivers/scsi/isci/remote_node_table.c:562: warning: Function parameter or member 'remote_node_index' not described in 'sci_remote_node_table_release_triple_remote_node' drivers/scsi/isci/remote_node_table.c:588: warning: Function parameter or member 'remote_node_index' not described in 'sci_remote_node_table_release_remote_node_index' Cc: Artur Paszkiewicz Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/isci/remote_node_table.c | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/isci/remote_node_table.c b/drivers/scsi/isci/remote_node_table.c index 1036ab936626e..1bcaf528c1c99 100644 --- a/drivers/scsi/isci/remote_node_table.c +++ b/drivers/scsi/isci/remote_node_table.c @@ -99,7 +99,7 @@ static u32 sci_remote_node_table_get_group_index( * sci_remote_node_table_clear_group_index() * @remote_node_table: This the remote node table in which to clear the * selector. - * @set_index: This is the remote node selector in which the change will be + * @group_table_index: This is the remote node selector in which the change will be * made. * @group_index: This is the bit index in the table to be modified. * @@ -250,9 +250,8 @@ static void sci_remote_node_table_clear_group( remote_node_table->available_remote_nodes[dword_location] = dword_value; } -/** +/* * sci_remote_node_table_set_group() - * @remote_node_table: * * THis method sets an entire remote node group in the remote node table. */ @@ -366,7 +365,7 @@ void sci_remote_node_table_initialize( * sci_remote_node_table_allocate_single_remote_node() * @remote_node_table: The remote node table from which to allocate a * remote node. - * @table_index: The group index that is to be used for the search. + * @group_table_index: The group index that is to be used for the search. * * This method will allocate a single RNi from the remote node table. The * table index will determine from which remote node group table to search. @@ -426,7 +425,7 @@ static u16 sci_remote_node_table_allocate_single_remote_node( * sci_remote_node_table_allocate_triple_remote_node() * @remote_node_table: This is the remote node table from which to allocate the * remote node entries. - * @group_table_index: THis is the group table index which must equal two (2) + * @group_table_index: This is the group table index which must equal two (2) * for this operation. * * This method will allocate three consecutive remote node context entries. If @@ -506,7 +505,7 @@ u16 sci_remote_node_table_allocate_remote_node( * sci_remote_node_table_release_single_remote_node() * @remote_node_table: This is the remote node table from which the remote node * release is to take place. - * + * @remote_node_index: This is the remote node index that is being released. * This method will free a single remote node index back to the remote node * table. This routine will update the remote node groups */ @@ -552,6 +551,7 @@ static void sci_remote_node_table_release_single_remote_node( * sci_remote_node_table_release_triple_remote_node() * @remote_node_table: This is the remote node table to which the remote node * index is to be freed. + * @remote_node_index: This is the remote node index that is being released. * * This method will release a group of three consecutive remote nodes back to * the free remote nodes. @@ -577,6 +577,7 @@ static void sci_remote_node_table_release_triple_remote_node( * to be freed. * @remote_node_count: This is the count of consecutive remote nodes that are * to be freed. + * @remote_node_index: This is the remote node index that is being released. * * This method will release the remote node index back into the remote node * table free pool. From patchwork Wed Mar 17 09:12:25 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403101 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294756jai; Wed, 17 Mar 2021 02:14:15 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy4nEkD6jLhgedV4fNANyrdX8ZQuFrQcVQbB4SPNDeb2ZkM18Gw+5jORTcfcnLN91eI7aDV X-Received: by 2002:a17:907:36e:: with SMTP id rs14mr33392954ejb.42.1615972455382; Wed, 17 Mar 2021 02:14:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972455; cv=none; d=google.com; s=arc-20160816; b=ASWcSB+UX7E3xH5oyNucYN93MiSuL3xQjcBBge4zVBnx/Gtdrch8IgulSwJnGHdsyd iSp4XXLzZHHa23cp6OgZwtTcEj1eA/386V/Ty+dAwD72VlbG10sxssTgQ54lv5/bfSqs KcmWh9b7M5KQshgIsTno71Zk5i/bbgQ4XPQJYPatle8Dn28pZmEulDTyHAyZce3EsPpg 9ZsOECHd9sIKxytCSOY0TPWe7c2UfRkOESamZTn4YlteGkDhehjeQ4nhfb8qrJM2/fGK r+y4e5Ve4KVznWZpuaJ14FHfAaI1SNQd78ST9brl7SOBO3hTahOlZXPBHZ8/l3sMvug4 ZPOg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=0pHIZHhKpBhGoLa2stZTqH6Rz5RjIRSokSD2h9KbvHc=; b=0AFRr8YraWZlspWc1tWfAZHmjrDk/p4wIipSmkNc0OKyUfCIr7ns8mrhy1MqZQMB1k GmssInTWUNu9UyQw6OwQwS4+YhOkJEtfcvRyaBpbxyx/lm6L9Oe4ZOsefwLY7JPx0Hvv HvWyTuRITy1Mu8S5SEhjA1X8nX2JSqnzy0aOfgobpdyIWYj0eyNsoRMDwxHdslDH4ZZb Lm3eLcdFTSFpwydX6GcONBrfnqlhW6spzEdkMl3IedLi8znzJZL+JXsDRihthFWfGd8g OLgj7a/CNhvuYrO8sehfmuACztye0FUchn6eWqU196AYgPENMbDCOBzf2cgzId0c67tQ LM+g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=zl+IsVUz; 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 t15si15461864edq.164.2021.03.17.02.14.15 for ; Wed, 17 Mar 2021 02:14:15 -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=zl+IsVUz; 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 S231191AbhCQJNt (ORCPT ); Wed, 17 Mar 2021 05:13:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230337AbhCQJNN (ORCPT ); Wed, 17 Mar 2021 05:13:13 -0400 Received: from mail-wm1-x330.google.com (mail-wm1-x330.google.com [IPv6:2a00:1450:4864:20::330]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9751BC061760 for ; Wed, 17 Mar 2021 02:13:12 -0700 (PDT) Received: by mail-wm1-x330.google.com with SMTP id f22-20020a7bc8d60000b029010c024a1407so2955304wml.2 for ; Wed, 17 Mar 2021 02:13: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=0pHIZHhKpBhGoLa2stZTqH6Rz5RjIRSokSD2h9KbvHc=; b=zl+IsVUzggf7c6oUTebPYwinoPM3gAUpTCrNQIXx7CEpVCer3iLd98t6cddrT37fmq jksJSH2d30WdxQs/vyqpxmUMgjkQfz7uSLj43mckJ8QUHs8teBBmZGItrc9KDL4y7pt3 tOFsIihDrg4v4a5Cr/i6mCH5XtisB1kjRlkUjcSGf5lCa7Y2FLETtMxKUUQSlxaMiqiv fFPQfsiDq3E3m4CEN9syAkcN2OBQoQSDu56fybhjF7eRyN7pwglpm4p8PE0QYuKX6TWV 4r+ilX3dA6qcVefi8gp4ToF8aOoYoSNUVqa4t9iNwmvoBhsSI7gVGcJnMh0lzY/pqoX3 qikw== 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=0pHIZHhKpBhGoLa2stZTqH6Rz5RjIRSokSD2h9KbvHc=; b=CWzdid0wSVXcNADv4HSs5UjGJtCk8z4En0W43Xm28fTZ8KHe8XSlqTagdKrECo31Ee cXkEWxJXsziJKGZc4SIxe5KVA+WQ3HX7Zhhz5aNLcvQYA6xLae/waFyi7rmuBD7GIFkQ pNdf9EUSGWrtX7GL/FQLhbWFQUQRd48gwMx+eQ5kVtpxSdm2aSBkLzMYJ1tTgkaSVY+B TqmtZjtuNQU+cLuurvmH5h8h/Tjux8P4PtIaOqOKeDPynsF+BEoxM29avMn+t4XIAske cQ8S3oVsrHjtQaqP6IhWl5kn2Efm+/IvvMV8I6Ac3AyGA4gAMui49UfEiplunftD6L6u 29HQ== X-Gm-Message-State: AOAM530aWZmWaxgi8XA3tvJHGa0S6q6NAQpMJ6fE/dXK2UXHuOnkMKMn IYUHGHEd/tIjOkWjwBrPDNr2bw== X-Received: by 2002:a1c:b48a:: with SMTP id d132mr2637817wmf.108.1615972391306; Wed, 17 Mar 2021 02:13:11 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:10 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "Manoj N. Kumar" , "Matthew R. Ochs" , Uma Krishnan , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 31/36] scsi: cxlflash: main: Fix a little do-rot Date: Wed, 17 Mar 2021 09:12:25 +0000 Message-Id: <20210317091230.2912389-32-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/cxlflash/main.c:1369: warning: Function parameter or member 'hwq' not described in 'process_hrrq' drivers/scsi/cxlflash/main.c:1369: warning: Excess function parameter 'afu' description in 'process_hrrq' drivers/scsi/cxlflash/main.c:2005: warning: Function parameter or member 'index' not described in 'init_mc' drivers/scsi/cxlflash/main.c:3303: warning: Function parameter or member 'lunprov' not described in 'cxlflash_lun_provision' drivers/scsi/cxlflash/main.c:3303: warning: Excess function parameter 'arg' description in 'cxlflash_lun_provision' drivers/scsi/cxlflash/main.c:3397: warning: Function parameter or member 'afu_dbg' not described in 'cxlflash_afu_debug' drivers/scsi/cxlflash/main.c:3397: warning: Excess function parameter 'arg' description in 'cxlflash_afu_debug' Cc: "Manoj N. Kumar" Cc: "Matthew R. Ochs" Cc: Uma Krishnan Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/cxlflash/main.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/cxlflash/main.c b/drivers/scsi/cxlflash/main.c index e72440d919d2a..dc36531d589e2 100644 --- a/drivers/scsi/cxlflash/main.c +++ b/drivers/scsi/cxlflash/main.c @@ -1357,7 +1357,7 @@ static irqreturn_t cxlflash_sync_err_irq(int irq, void *data) /** * process_hrrq() - process the read-response queue - * @afu: AFU associated with the host. + * @hwq: HWQ associated with the host. * @doneq: Queue of commands harvested from the RRQ. * @budget: Threshold of RRQ entries to process. * @@ -1997,7 +1997,7 @@ static enum undo_level init_intr(struct cxlflash_cfg *cfg, /** * init_mc() - create and register as the master context * @cfg: Internal structure associated with the host. - * index: HWQ Index of the master context. + * @index: HWQ Index of the master context. * * Return: 0 on success, -errno on failure */ @@ -3294,7 +3294,7 @@ static char *decode_hioctl(unsigned int cmd) /** * cxlflash_lun_provision() - host LUN provisioning handler * @cfg: Internal structure associated with the host. - * @arg: Kernel copy of userspace ioctl data structure. + * @lunprov: Kernel copy of userspace ioctl data structure. * * Return: 0 on success, -errno on failure */ @@ -3385,7 +3385,7 @@ static int cxlflash_lun_provision(struct cxlflash_cfg *cfg, /** * cxlflash_afu_debug() - host AFU debug handler * @cfg: Internal structure associated with the host. - * @arg: Kernel copy of userspace ioctl data structure. + * @afu_dbg: Kernel copy of userspace ioctl data structure. * * For debug requests requiring a data buffer, always provide an aligned * (cache line) buffer to the AFU to appease any alignment requirements. From patchwork Wed Mar 17 09:12:26 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403100 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294749jai; Wed, 17 Mar 2021 02:14:15 -0700 (PDT) X-Google-Smtp-Source: ABdhPJysFFmFLqbyS8SFhtXHyqa76nasho1OYs89G7pE3eQfMrzVofcCVnyjHmtk5MqsjU46Muia X-Received: by 2002:a17:906:1706:: with SMTP id c6mr13161880eje.223.1615972455060; Wed, 17 Mar 2021 02:14:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972455; cv=none; d=google.com; s=arc-20160816; b=mq7wPab6sJhDxDCaoXhlV65drzELJbYkcJrlgeHZme/KIaOYCQiRAFtbDWq6B8HJK1 IghWKKlP+xLGNKk9WKWzoXYuTGsyR0fk74/X5d6FC+L4dJMxuSuyJ7Z2+XezGrEX7m1Z 7pxjV+eRKJpWvaW0FAjsll1UopEh7rdSHFhrESzMy1h7hruFqEbGCDwl39PQdbSa4V/t lteOtlVn80ZlQfv3mOw8EewfjbUrkiDVjlDAtGw01qw7v31rcS8RxO4QCyLb3rXEh3nL ifKIQu8kB3ZRG7mA9jZYkWXxE1k8Rbp2bJYfGH8wyLKi+O7f68IKTPXKrDx5y0YW9vqS m6FQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=qZ7whSvid6Pc3xtKuqRZT/9oZ2iuDHT7pBFCqGUvkpY=; b=fJIpjkvCYszVhvkRcp4L0DMyzge1ZF6+r8leCy9S0S6q+hJTvuDcUcSVvU3Pvt1Dcw gQHPMKOiwBEUY0BrFLy2SUDakX8FVIKlNU4HPoCw79g66DI7vQhavqBbaqqOSno6y31U 4A2LsNTfpXF7VtZ/Cq5bXUFJ3ILwqwqIY/Ra98BAw0KBopx5SGZGTqwePI5uNUxEGgPf tLQDXSkJtaYwpEuAgBLCTrx0XqNtOeHW/b7nS/aqzdqpf5KzTUrIN8VPL2KLKMOMhlIN vSdoSl8bCyxzV6MFUACeM9yFMzBi0v7nia1IaJNHzG2tiBpFdCpu6nSnavg2GleezgSo kCyA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=r1SRHSkY; 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 t15si15461864edq.164.2021.03.17.02.14.14 for ; Wed, 17 Mar 2021 02:14:15 -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=r1SRHSkY; 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 S231196AbhCQJNu (ORCPT ); Wed, 17 Mar 2021 05:13:50 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230353AbhCQJNN (ORCPT ); Wed, 17 Mar 2021 05:13:13 -0400 Received: from mail-wr1-x435.google.com (mail-wr1-x435.google.com [IPv6:2a00:1450:4864:20::435]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6EEA1C061760 for ; Wed, 17 Mar 2021 02:13:13 -0700 (PDT) Received: by mail-wr1-x435.google.com with SMTP id k8so1006096wrc.3 for ; Wed, 17 Mar 2021 02:13: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=qZ7whSvid6Pc3xtKuqRZT/9oZ2iuDHT7pBFCqGUvkpY=; b=r1SRHSkYIwyEfqsq1wyBuRYYAgpRk5Sc8j6/XO7RQoR88xSQS+2pccnHAiXSUyUePC k+2ERUT63Dg5OVo3KcFE04zGcdoui5LVqz7jJ0iV3u0SwENiQWc4QvTXyPj1gubsv2f2 XK+94NY3vk0d68kIBp1iLX8YgS0JWlbTKxgnI/eZmznFw6g58oDeIR32aEgP1rLrApLt +khv26cStuAufRAjNlImMvBWXmOZEHLz3q4nFaShCJJDX0KTYC8dfCVpKLWJgUpNN4XC 4fqAnReU1aLl6jrN6Bfv1fynWtML/i2RJVjqv43lvl9ggNWDGCPA0x7SUKa+/lGQ/yO3 +mzA== 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=qZ7whSvid6Pc3xtKuqRZT/9oZ2iuDHT7pBFCqGUvkpY=; b=UIx+iLbt+EGd5rtqXAD9zuj5y21qKVUagX03Edh04V6VJODsJsECzWu9eNnlo2Casb JaXbXSr94TY81+2EMELyTtuqWzBKhl/YrRpJIrBw8BVMHD/LxGyOHH2CTKAslOOLQxti Kt70c2AQBKCMSoQ9j7T2cRdmXnCanJN0IA7PuBoKBUyTonlzEPD8nwkkM5d2VojZaPNY rnV/gT2fcWlu/qlI48CMl7IKk0TVZrPRK+cK9J+nd2j+837UOJV7cFKnNERcXWccfjYz TeqXp37GxE2KA8Kvg90jATOFDBmdwQRtoi+pAw+4NH2fyPkH9rGpgiJYpID0+ixHZlNV 7F+Q== X-Gm-Message-State: AOAM531cquPV9GWHs3qUdgWpLuBY/VtVPSiypoPFjWXkCbsxpJxhTwLc S4R44fQ380udezqK7NaoIlo01/pp8G/nWA== X-Received: by 2002:a05:6000:23c:: with SMTP id l28mr3408383wrz.251.1615972392244; Wed, 17 Mar 2021 02:13:12 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:11 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "Manoj N. Kumar" , "Matthew R. Ochs" , Uma Krishnan , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 32/36] scsi: cxlflash: superpipe: Fix a few misnaming issues Date: Wed, 17 Mar 2021 09:12:26 +0000 Message-Id: <20210317091230.2912389-33-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/cxlflash/superpipe.c:38: warning: Function parameter or member 'release' not described in 'marshal_rele_to_resize' drivers/scsi/cxlflash/superpipe.c:38: warning: Excess function parameter 'rele' description in 'marshal_rele_to_resize' drivers/scsi/cxlflash/superpipe.c:51: warning: Function parameter or member 'release' not described in 'marshal_det_to_rele' drivers/scsi/cxlflash/superpipe.c:51: warning: Excess function parameter 'rele' description in 'marshal_det_to_rele' drivers/scsi/cxlflash/superpipe.c:528: warning: expecting prototype for rhte_format1(). Prototype was for rht_format1() instead Cc: "Manoj N. Kumar" Cc: "Matthew R. Ochs" Cc: Uma Krishnan Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/cxlflash/superpipe.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/cxlflash/superpipe.c b/drivers/scsi/cxlflash/superpipe.c index 5dddf67dfa24a..ee11ec340654a 100644 --- a/drivers/scsi/cxlflash/superpipe.c +++ b/drivers/scsi/cxlflash/superpipe.c @@ -30,7 +30,7 @@ struct cxlflash_global global; /** * marshal_rele_to_resize() - translate release to resize structure - * @rele: Source structure from which to translate/copy. + * @release: Source structure from which to translate/copy. * @resize: Destination structure for the translate/copy. */ static void marshal_rele_to_resize(struct dk_cxlflash_release *release, @@ -44,7 +44,7 @@ static void marshal_rele_to_resize(struct dk_cxlflash_release *release, /** * marshal_det_to_rele() - translate detach to release structure * @detach: Destination structure for the translate/copy. - * @rele: Source structure from which to translate/copy. + * @release: Source structure from which to translate/copy. */ static void marshal_det_to_rele(struct dk_cxlflash_detach *detach, struct dk_cxlflash_release *release) @@ -517,7 +517,7 @@ void rhte_checkin(struct ctx_info *ctxi, } /** - * rhte_format1() - populates a RHTE for format 1 + * rht_format1() - populates a RHTE for format 1 * @rhte: RHTE to populate. * @lun_id: LUN ID of LUN associated with RHTE. * @perm: Desired permissions for RHTE. From patchwork Wed Mar 17 09:12:27 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403106 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294802jai; Wed, 17 Mar 2021 02:14:19 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwpo3BQTxXDCOqrm0SQnspd2xYf52SYhJdGGZI5paGIa6XWE7R6Rqxh21k9D+aDxNSGUQMj X-Received: by 2002:a17:907:2112:: with SMTP id qn18mr33644861ejb.220.1615972459450; Wed, 17 Mar 2021 02:14:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972459; cv=none; d=google.com; s=arc-20160816; b=ISSPhoF/rnXXMvbFNOvY/gisfnzEuW6wgF4it9vi1SVHcTLH0olB6lmhVM8tzu9VGc Z0mP+s5lUAuL6Alo2z9sJhx86MaPdYEWo0gafFOmNBqX+mtYELTFEjEubpkDMdgO4onn Gx8cb9nn7pCjKPUSHBj5AscbOG1ImcneUOrIs4msIxT3ERCTXUIZzhOnU2fwPWgeCMcH jkVYvaWj2xUfyawIHPFFLhhuB73ZlBuEhgn031RUprNNlighV+pJLXWgfBrzG/QrHLQu vnoEz7Mp+J/L1qeRGaiuJe0CF0d/QKXsthEc5YQ4xjQGuJnC+r7Bds3mTSNEljNGtZ91 LSHA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=RAN4ynbW/anRZapL8VFvkYH+oK0hgHEKhtHWyGXNsOA=; b=l2k4TvYUN20vUhJA301r73HFUd2A4yLpweOfeBaFAjTdAq3y0KESKlWtf4wIv1YXVn /UTPEw9GsVQz/7SizywvzWYOk6XG5waAoHD/EJTRE/8bGDNSCzvClGRiV3RWTjW6BWGJ znYCAOpviw/vXDj2Tg5IzggikIBLO9O7cOyly2tWQQNjr300YlY4qIcigh1BZH5BT6nr wZIcSodsQtM0/z0tFOgC64ZZGAoJXlIbySTNaDHQfl8dhtS8QjOzgWd6MM/e2WyZUejC LaYsSAnLV92TgkmHl9vxlOb9MgD0NRKJR1OKXz40/5DA+6kiSWzFFKlvg2f3ux+LGw74 NBvA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="FktGAXs/"; 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 t15si15461864edq.164.2021.03.17.02.14.19 for ; Wed, 17 Mar 2021 02:14:19 -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="FktGAXs/"; 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 S231225AbhCQJNx (ORCPT ); Wed, 17 Mar 2021 05:13:53 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42760 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229914AbhCQJNZ (ORCPT ); Wed, 17 Mar 2021 05:13:25 -0400 Received: from mail-wr1-x430.google.com (mail-wr1-x430.google.com [IPv6:2a00:1450:4864:20::430]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9C36BC061760 for ; Wed, 17 Mar 2021 02:13:14 -0700 (PDT) Received: by mail-wr1-x430.google.com with SMTP id e18so1004541wrt.6 for ; Wed, 17 Mar 2021 02:13: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=RAN4ynbW/anRZapL8VFvkYH+oK0hgHEKhtHWyGXNsOA=; b=FktGAXs/eoUNfYdWLU7tDWHTlujziL8THin6aXwC0mLXOx9l5PwsLY1kGyrloBn4Xr VRFG1jCW4G3OzR02bgNRaCJ/ZeW4MXwjWnGRhZSScDJcASdxBsJkTngAnq2YZxT3llQ6 2/VYrDuob3EKFqnTCzF9hdTfinHqE1b9yI/v6dtgiPKFBRiwze9IsCrKnPUdI778dkih R9alWxabkffHiAbQwu4Jy572SZ/5ckc3EhwkTaGL7YxRimuT3eatfB5ptGT42Lr7iaRz dtPjQWlh0Aa1V5UasZH/k3uPMTBujtWS4ahRJJ5Iig9wKavld0BZExhRm/rXz1x5LckV GIaQ== 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=RAN4ynbW/anRZapL8VFvkYH+oK0hgHEKhtHWyGXNsOA=; b=WTnu1Ybn9fD/pC3LZXojnXEbFjiC2/rPNE53cbJnjbnI0634pj2/hvSPoLx9Vykixm x1eeGsBHqrJ7buka9dDSt172KudFF0JmV1b+MUvBrpsizYwjRmp8HL0QoqD8sGmUCg24 Auoai7ItGc90VnIPJjRoSZnm9qtAce0aHy43IOV801w1ausdwbpeZMpdr6Vns9+ulTLO hgLaXqjbwmoQADut218Q6DSBw9SRZccI6neGwNaqRL/JlK5GQ4Itb9aCoU+9VxvlmMNB orSeR/yYto4eqC8LowRaly7sd9gDkP8YPZLANSs7wI/SkN8xz+Sk/sxzz7uRMxtRUhXT 42AQ== X-Gm-Message-State: AOAM532QqRdZPqgzicnn1klS5pn1EfZfB/FLdHSSUV6pqxjLg9Fa5MgF VzQSF9Z482lD5kyMAVFNJE1wKQ== X-Received: by 2002:adf:9c86:: with SMTP id d6mr3323500wre.306.1615972393301; Wed, 17 Mar 2021 02:13:13 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.12 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:12 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Tyrel Datwyler , Michael Ellerman , Benjamin Herrenschmidt , Paul Mackerras , "James E.J. Bottomley" , "Martin K. Petersen" , Colin DeVilbiss , Santiago Leon , Dave Boutcher , linux-scsi@vger.kernel.org, linuxppc-dev@lists.ozlabs.org Subject: [PATCH 33/36] scsi: ibmvscsi: Fix a bunch of kernel-doc related issues Date: Wed, 17 Mar 2021 09:12:27 +0000 Message-Id: <20210317091230.2912389-34-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/ibmvscsi/ibmvscsi.c:143: warning: Function parameter or member 'hostdata' not described in 'ibmvscsi_release_crq_queue' drivers/scsi/ibmvscsi/ibmvscsi.c:143: warning: Function parameter or member 'max_requests' not described in 'ibmvscsi_release_crq_queue' drivers/scsi/ibmvscsi/ibmvscsi.c:143: warning: expecting prototype for release_crq_queue(). Prototype was for ibmvscsi_release_crq_queue() instead drivers/scsi/ibmvscsi/ibmvscsi.c:286: warning: expecting prototype for reset_crq_queue(). Prototype was for ibmvscsi_reset_crq_queue() instead drivers/scsi/ibmvscsi/ibmvscsi.c:328: warning: Function parameter or member 'max_requests' not described in 'ibmvscsi_init_crq_queue' drivers/scsi/ibmvscsi/ibmvscsi.c:328: warning: expecting prototype for initialize_crq_queue(). Prototype was for ibmvscsi_init_crq_queue() instead drivers/scsi/ibmvscsi/ibmvscsi.c:414: warning: expecting prototype for reenable_crq_queue(). Prototype was for ibmvscsi_reenable_crq_queue() instead drivers/scsi/ibmvscsi/ibmvscsi.c:536: warning: expecting prototype for ibmvscsi_free(). Prototype was for free_event_struct() instead drivers/scsi/ibmvscsi/ibmvscsi.c:558: warning: expecting prototype for get_evt_struct(). Prototype was for get_event_struct() instead drivers/scsi/ibmvscsi/ibmvscsi.c:587: warning: Function parameter or member 'evt_struct' not described in 'init_event_struct' drivers/scsi/ibmvscsi/ibmvscsi.c:587: warning: Excess function parameter 'evt' description in 'init_event_struct' drivers/scsi/ibmvscsi/ibmvscsi.c:608: warning: Function parameter or member 'cmd' not described in 'set_srp_direction' drivers/scsi/ibmvscsi/ibmvscsi.c:608: warning: Function parameter or member 'srp_cmd' not described in 'set_srp_direction' drivers/scsi/ibmvscsi/ibmvscsi.c:608: warning: Function parameter or member 'numbuf' not described in 'set_srp_direction' drivers/scsi/ibmvscsi/ibmvscsi.c:641: warning: Function parameter or member 'evt_struct' not described in 'unmap_cmd_data' drivers/scsi/ibmvscsi/ibmvscsi.c:683: warning: Function parameter or member 'evt_struct' not described in 'map_sg_data' drivers/scsi/ibmvscsi/ibmvscsi.c:757: warning: Function parameter or member 'evt_struct' not described in 'map_data_for_srp_cmd' drivers/scsi/ibmvscsi/ibmvscsi.c:783: warning: Function parameter or member 'error_code' not described in 'purge_requests' drivers/scsi/ibmvscsi/ibmvscsi.c:846: warning: Function parameter or member 't' not described in 'ibmvscsi_timeout' drivers/scsi/ibmvscsi/ibmvscsi.c:846: warning: Excess function parameter 'evt_struct' description in 'ibmvscsi_timeout' drivers/scsi/ibmvscsi/ibmvscsi.c:1043: warning: Function parameter or member 'cmnd' not described in 'ibmvscsi_queuecommand_lck' drivers/scsi/ibmvscsi/ibmvscsi.c:1043: warning: expecting prototype for ibmvscsi_queue(). Prototype was for ibmvscsi_queuecommand_lck() instead drivers/scsi/ibmvscsi/ibmvscsi.c:1351: warning: expecting prototype for init_host(). Prototype was for enable_fast_fail() instead drivers/scsi/ibmvscsi/ibmvscsi.c:1464: warning: Function parameter or member 'hostdata' not described in 'init_adapter' drivers/scsi/ibmvscsi/ibmvscsi.c:1475: warning: Function parameter or member 'evt_struct' not described in 'sync_completion' drivers/scsi/ibmvscsi/ibmvscsi.c:1488: warning: Function parameter or member 'cmd' not described in 'ibmvscsi_eh_abort_handler' drivers/scsi/ibmvscsi/ibmvscsi.c:1488: warning: expecting prototype for ibmvscsi_abort(). Prototype was for ibmvscsi_eh_abort_handler() instead drivers/scsi/ibmvscsi/ibmvscsi.c:1627: warning: Function parameter or member 'cmd' not described in 'ibmvscsi_eh_device_reset_handler' drivers/scsi/ibmvscsi/ibmvscsi.c:1893: warning: Excess function parameter 'reason' description in 'ibmvscsi_change_queue_depth' drivers/scsi/ibmvscsi/ibmvscsi.c:2221: warning: Function parameter or member 'vdev' not described in 'ibmvscsi_probe' drivers/scsi/ibmvscsi/ibmvscsi.c:2221: warning: Function parameter or member 'id' not described in 'ibmvscsi_probe' drivers/scsi/ibmvscsi/ibmvscsi.c:2221: warning: expecting prototype for Called by bus code for each adapter(). Prototype was for ibmvscsi_probe() instead drivers/scsi/ibmvscsi/ibmvscsi.c:2381: warning: cannot understand function prototype: 'const struct vio_device_id ibmvscsi_device_table[] = ' Cc: Tyrel Datwyler Cc: Michael Ellerman Cc: Benjamin Herrenschmidt Cc: Paul Mackerras Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Colin DeVilbiss Cc: Santiago Leon Cc: Dave Boutcher Cc: linux-scsi@vger.kernel.org Cc: linuxppc-dev@lists.ozlabs.org Signed-off-by: Lee Jones --- drivers/scsi/ibmvscsi/ibmvscsi.c | 70 ++++++++++++++++---------------- 1 file changed, 35 insertions(+), 35 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/ibmvscsi/ibmvscsi.c b/drivers/scsi/ibmvscsi/ibmvscsi.c index 77fafb1bc173a..9ffd71e425f90 100644 --- a/drivers/scsi/ibmvscsi/ibmvscsi.c +++ b/drivers/scsi/ibmvscsi/ibmvscsi.c @@ -130,9 +130,10 @@ static irqreturn_t ibmvscsi_handle_event(int irq, void *dev_instance) } /** - * release_crq_queue: - Deallocates data and unregisters CRQ - * @queue: crq_queue to initialize and register - * @host_data: ibmvscsi_host_data of host + * ibmvscsi_release_crq_queue() - Deallocates data and unregisters CRQ + * @queue: crq_queue to initialize and register + * @hostdata: ibmvscsi_host_data of host + * @max_requests: maximum requests (unused) * * Frees irq, deallocates a page for messages, unmaps dma, and unregisters * the crq with the hypervisor. @@ -276,10 +277,9 @@ static void set_adapter_info(struct ibmvscsi_host_data *hostdata) } /** - * reset_crq_queue: - resets a crq after a failure + * ibmvscsi_reset_crq_queue() - resets a crq after a failure * @queue: crq_queue to initialize and register * @hostdata: ibmvscsi_host_data of host - * */ static int ibmvscsi_reset_crq_queue(struct crq_queue *queue, struct ibmvscsi_host_data *hostdata) @@ -314,9 +314,10 @@ static int ibmvscsi_reset_crq_queue(struct crq_queue *queue, } /** - * initialize_crq_queue: - Initializes and registers CRQ with hypervisor - * @queue: crq_queue to initialize and register - * @hostdata: ibmvscsi_host_data of host + * ibmvscsi_init_crq_queue() - Initializes and registers CRQ with hypervisor + * @queue: crq_queue to initialize and register + * @hostdata: ibmvscsi_host_data of host + * @max_requests: maximum requests (unused) * * Allocates a page for messages, maps it for dma, and registers * the crq with the hypervisor. @@ -404,10 +405,9 @@ static int ibmvscsi_init_crq_queue(struct crq_queue *queue, } /** - * reenable_crq_queue: - reenables a crq after + * ibmvscsi_reenable_crq_queue() - reenables a crq after * @queue: crq_queue to initialize and register * @hostdata: ibmvscsi_host_data of host - * */ static int ibmvscsi_reenable_crq_queue(struct crq_queue *queue, struct ibmvscsi_host_data *hostdata) @@ -439,7 +439,7 @@ static int ibmvscsi_reenable_crq_queue(struct crq_queue *queue, * @hostdata: ibmvscsi_host_data who owns the event pool * * Returns zero on success. -*/ + */ static int initialize_event_pool(struct event_pool *pool, int size, struct ibmvscsi_host_data *hostdata) { @@ -478,12 +478,12 @@ static int initialize_event_pool(struct event_pool *pool, } /** - * release_event_pool: - Frees memory of an event pool of a host + * release_event_pool() - Frees memory of an event pool of a host * @pool: event_pool to be released * @hostdata: ibmvscsi_host_data who owns the even pool * * Returns zero on success. -*/ + */ static void release_event_pool(struct event_pool *pool, struct ibmvscsi_host_data *hostdata) { @@ -526,11 +526,10 @@ static int valid_event_struct(struct event_pool *pool, } /** - * ibmvscsi_free-event_struct: - Changes status of event to "free" + * free_event_struct() - Changes status of event to "free" * @pool: event_pool that contains the event * @evt: srp_event_struct to be modified - * -*/ + */ static void free_event_struct(struct event_pool *pool, struct srp_event_struct *evt) { @@ -547,7 +546,7 @@ static void free_event_struct(struct event_pool *pool, } /** - * get_evt_struct: - Gets the next free event in pool + * get_event_struct() - Gets the next free event in pool * @pool: event_pool that contains the events to be searched * * Returns the next event in "free" state, and NULL if none are free. @@ -575,7 +574,7 @@ static struct srp_event_struct *get_event_struct(struct event_pool *pool) /** * init_event_struct: Initialize fields in an event struct that are always * required. - * @evt: The event + * @evt_struct: The event * @done: Routine to call when the event is responded to * @format: SRP or MAD format * @timeout: timeout value set in the CRQ @@ -597,7 +596,7 @@ static void init_event_struct(struct srp_event_struct *evt_struct, * Routines for receiving SCSI responses from the hosting partition */ -/** +/* * set_srp_direction: Set the fields in the srp related to data * direction and number of buffers based on the direction in * the scsi_cmnd and the number of buffers @@ -632,9 +631,9 @@ static void set_srp_direction(struct scsi_cmnd *cmd, /** * unmap_cmd_data: - Unmap data pointed in srp_cmd based on the format * @cmd: srp_cmd whose additional_data member will be unmapped + * @evt_struct: the event * @dev: device for which the memory is mapped - * -*/ + */ static void unmap_cmd_data(struct srp_cmd *cmd, struct srp_event_struct *evt_struct, struct device *dev) @@ -671,6 +670,7 @@ static int map_sg_list(struct scsi_cmnd *cmd, int nseg, /** * map_sg_data: - Maps dma for a scatterlist and initializes descriptor fields * @cmd: struct scsi_cmnd with the scatterlist + * @evt_struct: struct srp_event_struct to map * @srp_cmd: srp_cmd that contains the memory descriptor * @dev: device for which to map dma memory * @@ -745,6 +745,7 @@ static int map_sg_data(struct scsi_cmnd *cmd, /** * map_data_for_srp_cmd: - Calls functions to map data for srp cmds * @cmd: struct scsi_cmnd with the memory to be mapped + * @evt_struct: struct srp_event_struct to map * @srp_cmd: srp_cmd that contains the memory descriptor * @dev: dma device for which to map dma memory * @@ -778,6 +779,7 @@ static int map_data_for_srp_cmd(struct scsi_cmnd *cmd, /** * purge_requests: Our virtual adapter just shut down. purge any sent requests * @hostdata: the adapter + * @error_code: error code to return as the 'result' */ static void purge_requests(struct ibmvscsi_host_data *hostdata, int error_code) { @@ -838,7 +840,7 @@ static void ibmvscsi_reset_host(struct ibmvscsi_host_data *hostdata) /** * ibmvscsi_timeout - Internal command timeout handler - * @evt_struct: struct srp_event_struct that timed out + * @t: struct srp_event_struct that timed out * * Called when an internally generated command times out */ @@ -1034,8 +1036,8 @@ static inline u16 lun_from_dev(struct scsi_device *dev) } /** - * ibmvscsi_queue: - The queuecommand function of the scsi template - * @cmd: struct scsi_cmnd to be executed + * ibmvscsi_queuecommand_lck() - The queuecommand function of the scsi template + * @cmnd: struct scsi_cmnd to be executed * @done: Callback function to be called when cmd is completed */ static int ibmvscsi_queuecommand_lck(struct scsi_cmnd *cmnd, @@ -1342,7 +1344,7 @@ static void fast_fail_rsp(struct srp_event_struct *evt_struct) } /** - * init_host - Start host initialization + * enable_fast_fail() - Start host initialization * @hostdata: ibmvscsi_host_data of host * * Returns zero if successful. @@ -1456,16 +1458,15 @@ static void send_mad_adapter_info(struct ibmvscsi_host_data *hostdata) spin_unlock_irqrestore(hostdata->host->host_lock, flags); }; -/** - * init_adapter: Start virtual adapter initialization sequence - * +/* + * init_adapter() - Start virtual adapter initialization sequence */ static void init_adapter(struct ibmvscsi_host_data *hostdata) { send_mad_adapter_info(hostdata); } -/** +/* * sync_completion: Signal that a synchronous command has completed * Note that after returning from this call, the evt_struct is freed. * the caller waiting on this completion shouldn't touch the evt_struct @@ -1480,8 +1481,8 @@ static void sync_completion(struct srp_event_struct *evt_struct) complete(&evt_struct->comp); } -/** - * ibmvscsi_abort: Abort a command...from scsi host template +/* + * ibmvscsi_eh_abort_handler: Abort a command...from scsi host template * send this over to the server and wait synchronously for the response */ static int ibmvscsi_eh_abort_handler(struct scsi_cmnd *cmd) @@ -1618,7 +1619,7 @@ static int ibmvscsi_eh_abort_handler(struct scsi_cmnd *cmd) return SUCCESS; } -/** +/* * ibmvscsi_eh_device_reset_handler: Reset a single LUN...from scsi host * template send this over to the server and wait synchronously for the * response @@ -1884,7 +1885,6 @@ static int ibmvscsi_slave_configure(struct scsi_device *sdev) * ibmvscsi_change_queue_depth - Change the device's queue depth * @sdev: scsi device struct * @qdepth: depth to set - * @reason: calling context * * Return value: * actual depth set @@ -2214,7 +2214,7 @@ static int ibmvscsi_work(void *data) return 0; } -/** +/* * Called by bus code for each adapter */ static int ibmvscsi_probe(struct vio_dev *vdev, const struct vio_device_id *id) @@ -2374,7 +2374,7 @@ static int ibmvscsi_resume(struct device *dev) return 0; } -/** +/* * ibmvscsi_device_table: Used by vio.c to match devices in the device tree we * support. */ From patchwork Wed Mar 17 09:12:28 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403107 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294924jai; Wed, 17 Mar 2021 02:14:32 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxA/D8c9xj034WuXEk1Ta3tvaOqjjIpD40Aosli8zDz9BkfUp1IV/6upBCLt8NcyEzM36Mz X-Received: by 2002:a17:906:af91:: with SMTP id mj17mr33035076ejb.230.1615972472766; Wed, 17 Mar 2021 02:14:32 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972472; cv=none; d=google.com; s=arc-20160816; b=TulRsJQwhgLYsrH7zba9oLdEZRZg+xnd18/A27skUlRswvL99nLME0QtSrIZIVL/n/ yolCNIf77YW/kCrZMSp8mGoB1EKQmz1ce4oJd9l4yRPlzIfm321B2SioCid0+qVk8SIV Z7OpHouOlWzLYs0AYodIHpHLowi6isnbIhh3vc3XiMmzxJKlAfxRA3DiteEtaGSAeMna 5VhAQisziK5dXo5HQIUMu//Nu3efMxl9sSAM+Uh2JlI2gu37LcSyeloT5s5k49xhi7pb JX4UuOTS+FjzjgBRFKKef//oCnHgKV58aMW4jbET7nBHmzETYEWDaxPooqtffiwFoB8k z0AA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=zjBaHIzTXXyZcZh/hf2ALRdddAT/JJaP6MXXLDQdjD4=; b=F4jvhU+YFipDR47CFd7IlMSHRX664Sg4hRceBqdoEIv508Dxn6/KzpFNf4KjY830tW BFUfj/k663nUAmM4o63apHDGzMBh1Wvj/JKufhH0qv1vI0ODs0BcScyp1+T0EpHBk4JB YK90zl1VdM6H0uoJw17VWp98wS+3+TnL0LKAPin0T737k1BLD2vfw+g+APABLIIBFB4o 26F+NoXykHkD9TMONP1Pql4FXSa6jcU+xwlDlYfkQj7D9qIV2I+shqw0Ryx+7GOYeumq JFyyPc5sbnDOJ4Fdxc4ptcjQMm7UvmACbzTfPLJ8ae3V7n4jD35bsRYNi6c7xgRKMeyW mZRQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=frmeAnhM; 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 t15si15461864edq.164.2021.03.17.02.14.32 for ; Wed, 17 Mar 2021 02:14: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=frmeAnhM; 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 S231246AbhCQJN6 (ORCPT ); Wed, 17 Mar 2021 05:13:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42750 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230449AbhCQJN0 (ORCPT ); Wed, 17 Mar 2021 05:13:26 -0400 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9CDF3C06174A for ; Wed, 17 Mar 2021 02:13:15 -0700 (PDT) Received: by mail-wr1-x433.google.com with SMTP id e18so1004590wrt.6 for ; Wed, 17 Mar 2021 02:13: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=zjBaHIzTXXyZcZh/hf2ALRdddAT/JJaP6MXXLDQdjD4=; b=frmeAnhM5BxXjSAAx4w5jrrgvPMVg8We5PR8YNRtrjrjou/kpY0eN5VlPyUt1uMBwz 5pgCukGPGRBr3JtgaRtGLTn5Dm/eRNxjiWR+3fyrGaOmB+7c+d8hWn/QZQC3nD2YPcip zcawozUVl6RKLbffmVFc8rn3WvIY/pWmUKIALM/4j6BC3nc9IfFL96cPz5dzB/Q44aig Je7wqAWY+rkVoE0f38VC/07pxs8smswPJAvo/2Xob6wyxaeMM5fBDq7eeWpWpmwIdeVk ec/7dJzxwW5XhSiUD4ReJc1xd/DG9Ze8uisLDncjEZt+ZQbbQ8pUuS4TAHr3zLhA8nUg mQjw== 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=zjBaHIzTXXyZcZh/hf2ALRdddAT/JJaP6MXXLDQdjD4=; b=jUOzxxjzQlZHemmO0s2qoErvfSsstJU+lvLd4PZBh+i/rcQWH7XW/07mP2yHyFEAqX keQcK2QcqjDYLNhM5NChR0Rs0w9HZBGxSX3/1nGcp4AFJlp/x79WBfNPDmWCfuWOrViP ldQduZIGx15uIK8WUSqZmxj5ZXqmaE/XiXN+Hxi80cCRzpVGsq2jGkoyR+QXAM0mgBws mxKeb58xDsKa+WZQWzeZuNP756lXzd1BjhfVXohuCrUbNPGHznQm5zArWnbuh1hF7cnW uITsebiHpz5hmgRtlEv81dpGQ6gOvl7ha1HE/wRvrnx5zXECKusf931FXlQDG9rESFLR LY6A== X-Gm-Message-State: AOAM5317tJtpCWpr8a9EC3cVUvLpqHD67Xy20B05CdU/zcTWTzTb/NAC IZpzgmDIFzrKlKpYVuDcP8Dh9Q== X-Received: by 2002:a5d:6c67:: with SMTP id r7mr1165491wrz.373.1615972394340; Wed, 17 Mar 2021 02:13:14 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:13 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Tyrel Datwyler , Michael Ellerman , Benjamin Herrenschmidt , Paul Mackerras , "James E.J. Bottomley" , "Martin K. Petersen" , Brian King , linux-scsi@vger.kernel.org, linuxppc-dev@lists.ozlabs.org Subject: [PATCH 34/36] scsi: ibmvscsi: ibmvfc: Fix a bunch of misdocumentation Date: Wed, 17 Mar 2021 09:12:28 +0000 Message-Id: <20210317091230.2912389-35-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/ibmvscsi/ibmvfc.c:331: warning: Function parameter or member 'vhost' not described in 'ibmvfc_get_err_result' drivers/scsi/ibmvscsi/ibmvfc.c:653: warning: Excess function parameter 'job_step' description in 'ibmvfc_del_tgt' drivers/scsi/ibmvscsi/ibmvfc.c:773: warning: Function parameter or member 'queue' not described in 'ibmvfc_init_event_pool' drivers/scsi/ibmvscsi/ibmvfc.c:773: warning: Function parameter or member 'size' not described in 'ibmvfc_init_event_pool' drivers/scsi/ibmvscsi/ibmvfc.c:823: warning: Function parameter or member 'queue' not described in 'ibmvfc_free_event_pool' drivers/scsi/ibmvscsi/ibmvfc.c:1413: warning: Function parameter or member 'vhost' not described in 'ibmvfc_gather_partition_info' drivers/scsi/ibmvscsi/ibmvfc.c:1483: warning: Function parameter or member 'queue' not described in 'ibmvfc_get_event' drivers/scsi/ibmvscsi/ibmvfc.c:1483: warning: Excess function parameter 'vhost' description in 'ibmvfc_get_event' drivers/scsi/ibmvscsi/ibmvfc.c:1630: warning: Function parameter or member 't' not described in 'ibmvfc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:1630: warning: Excess function parameter 'evt' description in 'ibmvfc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:1893: warning: Function parameter or member 'shost' not described in 'ibmvfc_queuecommand' drivers/scsi/ibmvscsi/ibmvfc.c:1893: warning: Excess function parameter 'done' description in 'ibmvfc_queuecommand' drivers/scsi/ibmvscsi/ibmvfc.c:2324: warning: Function parameter or member 'rport' not described in 'ibmvfc_match_rport' drivers/scsi/ibmvscsi/ibmvfc.c:2324: warning: Excess function parameter 'device' description in 'ibmvfc_match_rport' drivers/scsi/ibmvscsi/ibmvfc.c:3133: warning: Function parameter or member 'evt_doneq' not described in 'ibmvfc_handle_crq' drivers/scsi/ibmvscsi/ibmvfc.c:3317: warning: Excess function parameter 'reason' description in 'ibmvfc_change_queue_depth' drivers/scsi/ibmvscsi/ibmvfc.c:3390: warning: Function parameter or member 'attr' not described in 'ibmvfc_show_log_level' drivers/scsi/ibmvscsi/ibmvfc.c:3413: warning: Function parameter or member 'attr' not described in 'ibmvfc_store_log_level' drivers/scsi/ibmvscsi/ibmvfc.c:3413: warning: Function parameter or member 'count' not described in 'ibmvfc_store_log_level' drivers/scsi/ibmvscsi/ibmvfc.c:4121: warning: Function parameter or member 'done' not described in '__ibmvfc_tgt_get_implicit_logout_evt' drivers/scsi/ibmvscsi/ibmvfc.c:4438: warning: Function parameter or member 't' not described in 'ibmvfc_adisc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:4438: warning: Excess function parameter 'tgt' description in 'ibmvfc_adisc_timeout' drivers/scsi/ibmvscsi/ibmvfc.c:4641: warning: Function parameter or member 'target' not described in 'ibmvfc_alloc_target' drivers/scsi/ibmvscsi/ibmvfc.c:4641: warning: Excess function parameter 'scsi_id' description in 'ibmvfc_alloc_target' drivers/scsi/ibmvscsi/ibmvfc.c:5068: warning: Function parameter or member 'evt' not described in 'ibmvfc_npiv_logout_done' drivers/scsi/ibmvscsi/ibmvfc.c:5068: warning: Excess function parameter 'vhost' description in 'ibmvfc_npiv_logout_done' Cc: Tyrel Datwyler Cc: Michael Ellerman Cc: Benjamin Herrenschmidt Cc: Paul Mackerras Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Brian King Cc: linux-scsi@vger.kernel.org Cc: linuxppc-dev@lists.ozlabs.org Signed-off-by: Lee Jones --- drivers/scsi/ibmvscsi/ibmvfc.c | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/ibmvscsi/ibmvfc.c b/drivers/scsi/ibmvscsi/ibmvfc.c index a38d9d5d90ba3..a7a9b647ea178 100644 --- a/drivers/scsi/ibmvscsi/ibmvfc.c +++ b/drivers/scsi/ibmvscsi/ibmvfc.c @@ -326,6 +326,7 @@ static const char *ibmvfc_get_cmd_error(u16 status, u16 error) /** * ibmvfc_get_err_result - Find the scsi status to return for the fcp response + * @vhost: ibmvfc host struct * @vfc_cmd: ibmvfc command struct * * Return value: @@ -650,8 +651,6 @@ static void ibmvfc_reinit_host(struct ibmvfc_host *vhost) /** * ibmvfc_del_tgt - Schedule cleanup and removal of the target * @tgt: ibmvfc target struct - * @job_step: job step to perform - * **/ static void ibmvfc_del_tgt(struct ibmvfc_target *tgt) { @@ -768,6 +767,8 @@ static int ibmvfc_send_crq_init_complete(struct ibmvfc_host *vhost) /** * ibmvfc_init_event_pool - Allocates and initializes the event pool for a host * @vhost: ibmvfc host who owns the event pool + * @queue: ibmvfc queue struct + * @size: pool size * * Returns zero on success. **/ @@ -820,6 +821,7 @@ static int ibmvfc_init_event_pool(struct ibmvfc_host *vhost, /** * ibmvfc_free_event_pool - Frees memory of the event pool of a host * @vhost: ibmvfc host who owns the event pool + * @queue: ibmvfc queue struct * **/ static void ibmvfc_free_event_pool(struct ibmvfc_host *vhost, @@ -1414,6 +1416,7 @@ static int ibmvfc_issue_fc_host_lip(struct Scsi_Host *shost) /** * ibmvfc_gather_partition_info - Gather info about the LPAR + * @vhost: ibmvfc host struct * * Return value: * none @@ -1484,7 +1487,7 @@ static void ibmvfc_set_login_info(struct ibmvfc_host *vhost) /** * ibmvfc_get_event - Gets the next free event in pool - * @vhost: ibmvfc host struct + * @queue: ibmvfc queue struct * * Returns a free event from the pool. **/ @@ -1631,7 +1634,7 @@ static int ibmvfc_map_sg_data(struct scsi_cmnd *scmd, /** * ibmvfc_timeout - Internal command timeout handler - * @evt: struct ibmvfc_event that timed out + * @t: struct ibmvfc_event that timed out * * Called when an internally generated command times out **/ @@ -1892,8 +1895,8 @@ static struct ibmvfc_cmd *ibmvfc_init_vfc_cmd(struct ibmvfc_event *evt, struct s /** * ibmvfc_queuecommand - The queuecommand function of the scsi template + * @shost: scsi host struct * @cmnd: struct scsi_cmnd to be executed - * @done: Callback function to be called when cmnd is completed * * Returns: * 0 on success / other on failure @@ -2324,7 +2327,7 @@ static int ibmvfc_reset_device(struct scsi_device *sdev, int type, char *desc) /** * ibmvfc_match_rport - Match function for specified remote port * @evt: ibmvfc event struct - * @device: device to match (rport) + * @rport: device to match * * Returns: * 1 if event matches rport / 0 if event does not match rport @@ -3135,8 +3138,9 @@ static void ibmvfc_handle_async(struct ibmvfc_async_crq *crq, * ibmvfc_handle_crq - Handles and frees received events in the CRQ * @crq: Command/Response queue * @vhost: ibmvfc host struct + * @evt_doneq: Event done queue * - **/ +**/ static void ibmvfc_handle_crq(struct ibmvfc_crq *crq, struct ibmvfc_host *vhost, struct list_head *evt_doneq) { @@ -3317,7 +3321,6 @@ static int ibmvfc_slave_configure(struct scsi_device *sdev) * ibmvfc_change_queue_depth - Change the device's queue depth * @sdev: scsi device struct * @qdepth: depth to set - * @reason: calling context * * Return value: * actual depth set @@ -3389,6 +3392,7 @@ static ssize_t ibmvfc_show_host_capabilities(struct device *dev, /** * ibmvfc_show_log_level - Show the adapter's error logging level * @dev: class device struct + * @attr: unused * @buf: buffer * * Return value: @@ -3411,7 +3415,9 @@ static ssize_t ibmvfc_show_log_level(struct device *dev, /** * ibmvfc_store_log_level - Change the adapter's error logging level * @dev: class device struct + * @attr: unused * @buf: buffer + * @count: buffer size * * Return value: * number of bytes printed to buffer @@ -4121,6 +4127,7 @@ static void ibmvfc_tgt_implicit_logout_done(struct ibmvfc_event *evt) /** * __ibmvfc_tgt_get_implicit_logout_evt - Allocate and init an event for implicit logout * @tgt: ibmvfc target struct + * @done: Routine to call when the event is responded to * * Returns: * Allocated and initialized ibmvfc_event struct @@ -4437,7 +4444,7 @@ static void ibmvfc_tgt_adisc_cancel_done(struct ibmvfc_event *evt) /** * ibmvfc_adisc_timeout - Handle an ADISC timeout - * @tgt: ibmvfc target struct + * @t: ibmvfc target struct * * If an ADISC times out, send a cancel. If the cancel times * out, reset the CRQ. When the ADISC comes back as cancelled, @@ -4640,7 +4647,7 @@ static void ibmvfc_tgt_query_target(struct ibmvfc_target *tgt) /** * ibmvfc_alloc_target - Allocate and initialize an ibmvfc target * @vhost: ibmvfc host struct - * @scsi_id: SCSI ID to allocate target for + * @target: Holds SCSI ID to allocate target forand the WWPN * * Returns: * 0 on success / other on failure @@ -5070,7 +5077,7 @@ static void ibmvfc_npiv_login(struct ibmvfc_host *vhost) /** * ibmvfc_npiv_logout_done - Completion handler for NPIV Logout - * @vhost: ibmvfc host struct + * @evt: ibmvfc event struct * **/ static void ibmvfc_npiv_logout_done(struct ibmvfc_event *evt) From patchwork Wed Mar 17 09:12:29 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403104 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294785jai; Wed, 17 Mar 2021 02:14:18 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyiqjvg2u538i8YD3uSdsqwT4ApaxRoYrAdtKgmGzlvnbcBqabXeXBmR+jdQw0wY+IO1cIm X-Received: by 2002:aa7:d792:: with SMTP id s18mr40263417edq.176.1615972457905; Wed, 17 Mar 2021 02:14:17 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972457; cv=none; d=google.com; s=arc-20160816; b=QW9yyK0LYq2GKI5eP7TaTR7nuoLv7OILxYjXhQk1BQvVspKkn9SDSsQASL/9yn1C/f AdN7HCU8CVTHd6pXJ1+VP46sPZgcktmZj9a5HRC7xh20P/eeCMeBs7hFOWeWMGgjphLq A215BpKLnaCb+KZS4cYgwHOpCTtRj7QvuXAqsmppyAbdV9WMZl/fHLJ/NASGoP84zuFP w0U/uapzZoc+P3WyTjW5Z2Fk7A6uWnSNmrLrr+t050GpWfsUfJcPo57HqmEptPpYNQh3 ZWd/zF5aYAiLcs7SPYDdClo7jeYYX9FZCS2RLgGIvLMSrJGZM/Kgaq0At5vG+i8MUad5 NK+w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=vbchzHiCvuybExCdVEvNdwmkJDXghXDN62HPrZ8RY5o=; b=0S0NBCa+KG66JYjO7f5wAA2Fvu5xIgwfp1pRncrrSnLJVSHsutg25++VepWnco04d+ KiWIUOLPW6i7og/gewdr3XqkSSuYvvC+K1RP8BgUC95Y+eR/EjFhH7QsehnElgerkenZ dCQCd3SFay2xt9obaUnaKDXXPl9w5yDH4+j7E8GRGeZttCNixH8LuAQv/S/Ob6Hg+EVE dEHurh4vE/itFsRItVa8sSlblGROgjLM9zHMyNzKKGmRz1ALM9uMYHB5yUxoycgv36qs 0YtoyfxxHkNUNlSWhh3MQ2n/d+cT73AU5dY+A80zY417rp2q2XZv/8yw6nM7y2vSLvAY lUnA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=c+MHb1JQ; 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 t15si15461864edq.164.2021.03.17.02.14.17 for ; Wed, 17 Mar 2021 02:14: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=c+MHb1JQ; 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 S231217AbhCQJNv (ORCPT ); Wed, 17 Mar 2021 05:13:51 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42798 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230401AbhCQJNR (ORCPT ); Wed, 17 Mar 2021 05:13:17 -0400 Received: from mail-wr1-x431.google.com (mail-wr1-x431.google.com [IPv6:2a00:1450:4864:20::431]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 960D9C061762 for ; Wed, 17 Mar 2021 02:13:16 -0700 (PDT) Received: by mail-wr1-x431.google.com with SMTP id e9so997507wrw.10 for ; Wed, 17 Mar 2021 02:13: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=vbchzHiCvuybExCdVEvNdwmkJDXghXDN62HPrZ8RY5o=; b=c+MHb1JQmfOXLDV+3WNH4O28BETw2lg0J/MTZ4AxVEqcxNEkyvb1/0GvTJoY9jbaHQ mGRlki8xCC2lbvr7VJK3gfJfAzG11KyjxUQS/d8wv5Y6k/hYiorMwF7zIEXdykm7Yiq9 IOLE/HHhZXw8zg/3K34Abk9Girs63O3H8tobZKe1jaj6aDfbXJQ7VIbdasc1wYgP/qEb bkqwZeFQMQ2Wl8xXFAWrZ1yymbORIzjB35OfgA3DBQkFtOQXT+3DyRFLPmUS4Bt99rzw LvMVAyNK2pdPCb5gIjmoTo+ytglgomWYrPt75ZgQiugft2u6eu5INCug6q0fP+ipTmyO KaqA== 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=vbchzHiCvuybExCdVEvNdwmkJDXghXDN62HPrZ8RY5o=; b=rDziCjAdvpF32XRvFJk5RJyDG/GZpEMZcwP0L3feQWFISmX3kTwGBtxbFSVUNCCdKk BmtLqsAIe5xZYI/Jwrwjnm/Y16QEyrjGsT/IQnL/mLXJMLGqDhIeUGoKB/SHF2zPrYzH 8r2ua+11JkaY7000jNkQPR+bmfSCyrafxgdZIXb7+iF7WBMNy3dJyZqKD6YHDLKdJxSZ PBVTLIF99wJHLpGMXwFirGJDuSGeIb2t0R+cyQSeqI794VnKHOdyIJI9UMezytnqoOs9 fFPhmkgz4Oa21oWQAEYWRnUii5oMqnuyCvTCifzq1QA1VVx7HoepKHtOzo4rAJwrXt4b 7cWQ== X-Gm-Message-State: AOAM533KBfVaRDm6Yw7HIX7t1imyWTAThWbkqk6SvZHQmYXvOiFCqkkV FsSpV5BvFhAiOw6gn0LSySvNDg== X-Received: by 2002:adf:fac1:: with SMTP id a1mr3452780wrs.98.1615972395408; Wed, 17 Mar 2021 02:13:15 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:14 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Michael Cyr , "James E.J. Bottomley" , "Martin K. Petersen" , Dave Boutcher , Santiago Leon , Linda Xie , FUJITA Tomonori , "Nicholas A. Bellinger" , "Bryant G. Ly" , linux-scsi@vger.kernel.org, target-devel@vger.kernel.org Subject: [PATCH 35/36] scsi: ibmvscsi_tgt: ibmvscsi_tgt: Remove duplicate section 'NOTE' Date: Wed, 17 Mar 2021 09:12:29 +0000 Message-Id: <20210317091230.2912389-36-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/ibmvscsi_tgt/ibmvscsi_tgt.c:136: warning: duplicate section name 'NOTE' Cc: Michael Cyr Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: Dave Boutcher Cc: Santiago Leon Cc: Linda Xie Cc: FUJITA Tomonori Cc: "Nicholas A. Bellinger" Cc: "Bryant G. Ly" Cc: linux-scsi@vger.kernel.org Cc: target-devel@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/ibmvscsi_tgt/ibmvscsi_tgt.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/ibmvscsi_tgt/ibmvscsi_tgt.c b/drivers/scsi/ibmvscsi_tgt/ibmvscsi_tgt.c index b65d50d03428a..41ac9477df7ad 100644 --- a/drivers/scsi/ibmvscsi_tgt/ibmvscsi_tgt.c +++ b/drivers/scsi/ibmvscsi_tgt/ibmvscsi_tgt.c @@ -128,10 +128,10 @@ static bool connection_broken(struct scsi_info *vscsi) * This function calls h_free_q then frees the interrupt bit etc. * It must release the lock before doing so because of the time it can take * for h_free_crq in PHYP - * NOTE: the caller must make sure that state and or flags will prevent - * interrupt handler from scheduling work. - * NOTE: anyone calling this function may need to set the CRQ_CLOSED flag - * we can't do it here, because we don't have the lock + * NOTE: * the caller must make sure that state and or flags will prevent + * interrupt handler from scheduling work. + * * anyone calling this function may need to set the CRQ_CLOSED flag + * we can't do it here, because we don't have the lock * * EXECUTION ENVIRONMENT: * Process level From patchwork Wed Mar 17 09:12:30 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 403105 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp294793jai; Wed, 17 Mar 2021 02:14:18 -0700 (PDT) X-Google-Smtp-Source: ABdhPJysmzf4KAw/VlO9QUSO0dXOiHj7pY+uS4pOyMp4s36/JCmmnmPNp1l/hT+B56O0lxN6eIIz X-Received: by 2002:a17:906:f10c:: with SMTP id gv12mr34347312ejb.53.1615972458600; Wed, 17 Mar 2021 02:14:18 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1615972458; cv=none; d=google.com; s=arc-20160816; b=QfdM1O06PA/MphrUp4elrqcgur5ePa5W3upWA4c9kkZnRux4wi+y5dzBHCPho3wMIf FKrE7H1v4cIc/rKe6kagqbmncIDFY5KrXiEElgi2ppQTFR76iFWISth1lOH8Qr5XxHMi VYhu2T0aRJDfCVlcr0IWjCaOsvCdcf990qVXzDbiT/L3huXTJbvB9bVLnQZCycQIUj6c ab68nt6AzKySzWFDlekUxj9IN8V73puNSr+5obTJryX7fSiC8BPmcLHpw+RgundJj8rf 7wANnoxrDbGzCE5ccl99GkinjBugmiTQ+Dpk2h5MycsdbU1YHFVZnhkZVu1B1SZiuN9Q bqlQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=nCn5H1/QIbfIGeplEbT1o6zOISUD7vSXkO5mBkf4PfU=; b=iuj9+2/T+E/7KeLSByAiRHWnDizV4b2gmBvses8IYLoIUAEUFkUBbd1QbJvPcaFhQ/ lzdAy46XkZbH6tykyh4rrNhZSRctHFJ0JsLL6YdtAOVFFTrMr/s9mwL8kVOMV/VQWL1v SA1chWwk9uPG2GT21ychkGLt2/umYX+329vWtflq4VSI8R+OupEVzZ3SE98xZy1rHjLT FebGhtazzJB0e11vsS2piRsc98pfN3jUZnRGOwwYErK/LDpU0yoWSjrJ/oxos1brGx0V QFGkHxTwvNDvNoCADowBi73NRITYgcHh5lQRX7G93jYN6D2ri2cVLS0D7GyjBS2BhpPY LyfA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=Z23F2lfn; 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 t15si15461864edq.164.2021.03.17.02.14.18 for ; Wed, 17 Mar 2021 02:14:18 -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=Z23F2lfn; 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 S230401AbhCQJNw (ORCPT ); Wed, 17 Mar 2021 05:13:52 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42792 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230416AbhCQJNR (ORCPT ); Wed, 17 Mar 2021 05:13:17 -0400 Received: from mail-wr1-x42c.google.com (mail-wr1-x42c.google.com [IPv6:2a00:1450:4864:20::42c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 88A52C06175F for ; Wed, 17 Mar 2021 02:13:17 -0700 (PDT) Received: by mail-wr1-x42c.google.com with SMTP id e18so1004702wrt.6 for ; Wed, 17 Mar 2021 02:13: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=nCn5H1/QIbfIGeplEbT1o6zOISUD7vSXkO5mBkf4PfU=; b=Z23F2lfnZHIs7s7AqP3HTgAl6LmZWclA5RVsNpn8IsUOzzgA/Y1G/xEywmR5rTZURj LDpoYlz/DT9LnOkK4VHUBY8u/JOiy1wseCY0kEvoUZFQzK8ZKAH+8s59Q594l0parmKx +v4E3ZWFOhNfyFKUy+nR7yoiiF/mfTN/WyzKrT6oQ73Q58UgHO/s4RfXPO+qvl25fLp1 F9S6AwqR/ziE3kPa/lVy8JPH/buY0YVMY/9NlGibqSWEe4r4h4dVaZi5RanB89O+LHvw tqPpZGm4wZm3TKj6qDr0inGpBV8zRZ/rpx3yHxRxAgfLdghkBFMzOzR4W55xvI1MrOFl pnYA== 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=nCn5H1/QIbfIGeplEbT1o6zOISUD7vSXkO5mBkf4PfU=; b=LS533IkxG8wMSiEq4t2LXzbN1eSuaXdfF9CU7GSD2B+0DCdcJSqhYqpEyuYhQk15wT zF/puDXgwh59mX0bzg9BDIG6Tu9EjbGVMxoBR7hfLQ+0Zpu3D6ZHjcgXT+l9+QhcKEus Mj6wyvVWCUrKzkp29/JzZte9nXOaixPuJS4wXrEnqMUT+mHKfLnQVVL9UL7COMl1cjTa RUmDzgtQoPi5UROZvXQ3iOzYiRWkSLRIZWgINL6/mR4NFwbL/waPIw3A2JZAtD+jszWX 3JzuYUpRPaF6W4+9YymcNhcVsi8hvGCAC9XfrdjqywbvF+zZpX26hS3agoKfJnrptsP4 q6lA== X-Gm-Message-State: AOAM531GTRxEhPDdPJ86Cal4VnPoU+mB5Ws8hc6tFM4lBiR0MOHiEyaE iHAiMuD6fsAU/BgEcr0bgCu5Pg== X-Received: by 2002:adf:ecca:: with SMTP id s10mr3196351wro.324.1615972396331; Wed, 17 Mar 2021 02:13:16 -0700 (PDT) Received: from dell.default ([91.110.221.194]) by smtp.gmail.com with ESMTPSA id e18sm12695886wru.73.2021.03.17.02.13.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Mar 2021 02:13:15 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, "Manoj N. Kumar" , "Matthew R. Ochs" , Uma Krishnan , "James E.J. Bottomley" , "Martin K. Petersen" , linux-scsi@vger.kernel.org Subject: [PATCH 36/36] scsi: cxlflash: vlun: Fix some misnaming related doc-rot Date: Wed, 17 Mar 2021 09:12:30 +0000 Message-Id: <20210317091230.2912389-37-lee.jones@linaro.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210317091230.2912389-1-lee.jones@linaro.org> References: <20210317091230.2912389-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/scsi/cxlflash/vlun.c:48: warning: Function parameter or member 'release' not described in 'marshal_clone_to_rele' drivers/scsi/cxlflash/vlun.c:48: warning: Excess function parameter 'rele' description in 'marshal_clone_to_rele' drivers/scsi/cxlflash/vlun.c:238: warning: Function parameter or member 'bali' not described in 'validate_alloc' drivers/scsi/cxlflash/vlun.c:238: warning: Excess function parameter 'ba_lun_info' description in 'validate_alloc' drivers/scsi/cxlflash/vlun.c:308: warning: Function parameter or member 'to_clone' not described in 'ba_clone' drivers/scsi/cxlflash/vlun.c:308: warning: Excess function parameter 'to_free' description in 'ba_clone' drivers/scsi/cxlflash/vlun.c:369: warning: Function parameter or member 'lli' not described in 'init_vlun' drivers/scsi/cxlflash/vlun.c:369: warning: Excess function parameter 'lun_info' description in 'init_vlun' Cc: "Manoj N. Kumar" Cc: "Matthew R. Ochs" Cc: Uma Krishnan Cc: "James E.J. Bottomley" Cc: "Martin K. Petersen" Cc: linux-scsi@vger.kernel.org Signed-off-by: Lee Jones --- drivers/scsi/cxlflash/vlun.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.27.0 diff --git a/drivers/scsi/cxlflash/vlun.c b/drivers/scsi/cxlflash/vlun.c index f1406ac77b0d5..01917b28cdb65 100644 --- a/drivers/scsi/cxlflash/vlun.c +++ b/drivers/scsi/cxlflash/vlun.c @@ -41,7 +41,7 @@ static void marshal_virt_to_resize(struct dk_cxlflash_uvirtual *virt, /** * marshal_clone_to_rele() - translate clone to release structure * @clone: Source structure from which to translate/copy. - * @rele: Destination structure for the translate/copy. + * @release: Destination structure for the translate/copy. */ static void marshal_clone_to_rele(struct dk_cxlflash_clone *clone, struct dk_cxlflash_release *release) @@ -229,7 +229,7 @@ static u64 ba_alloc(struct ba_lun *ba_lun) /** * validate_alloc() - validates the specified block has been allocated - * @ba_lun_info: LUN info owning the block allocator. + * @bali: LUN info owning the block allocator. * @aun: Block to validate. * * Return: 0 on success, -1 on failure @@ -300,7 +300,7 @@ static int ba_free(struct ba_lun *ba_lun, u64 to_free) /** * ba_clone() - Clone a chunk of the block allocation table * @ba_lun: Block allocator from which to allocate a block. - * @to_free: Block to free. + * @to_clone: Block to clone. * * Return: 0 on success, -1 on failure */ @@ -361,7 +361,7 @@ void cxlflash_ba_terminate(struct ba_lun *ba_lun) /** * init_vlun() - initializes a LUN for virtual use - * @lun_info: LUN information structure that owns the block allocator. + * @lli: LUN information structure that owns the block allocator. * * Return: 0 on success, -errno on failure */