From patchwork Thu Jul 23 12:24:39 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 247048 Delivered-To: patch@linaro.org Received: by 2002:a54:2c11:0:0:0:0:0 with SMTP id g17csp1148370ecp; Thu, 23 Jul 2020 05:26:07 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzzYAbdlLCDi/gC++fc7Mow7sSIXIPslJRRTEzZj5OHtMrVTGG+0bhGG6evyW3vgEPdFUcG X-Received: by 2002:a17:907:2715:: with SMTP id w21mr3898550ejk.229.1595507167211; Thu, 23 Jul 2020 05:26:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1595507167; cv=none; d=google.com; s=arc-20160816; b=eziozK/lI/B3pSA7cE3N7hauVm/W1y4Bx0espSBr7nRuESKW3en96nBVqkxvcMOTpC iG/pJK6hQVm6ViEkQmef7dT9dHtNY0EgqoGQeoZi1yxq3GWB3hJQkqEq4HfRKNLWGGb8 DMRTO+2bJE29ui3UuiEcNoXLAB1BPd6iVaFHDGYIVecV93EUxxrWyAFMLB6vrfRCU7gR d5tVFlMd5LaBqQHOc9nCxDrM0vrN3Px1vsGzvPUJi/DzKMZb1vjAzZgYyTG6FBEK0ZYG aCs6qSB9hfuw3mqBggotX+AqLcQgX5OqTxCs9CZSKk71H5g2dmlnoSVeDUA6SKW4EUn/ APnw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=B2RqnTIG0uteLiyJB2KJla0FyHDSlH3XX5iZpJkogwU=; b=ZIw8FFO55r9al8XdTNafu4FQyj3pwP0RSzObnoi2KnFxEzPocq405TIDZMNGehFoXC 9IIyPEcL5ppclP/BcoKFTu+T+0R0K/IG78QK7f+LPrPgi25KBHiXnr5i1yiVctSA1Scf fBQA3u0INIvdpivHQf3Q0gYii/ewwbch0dBto03ezq6Ss+dzop+NvbCabeOByf37PYLX pJPQ/2Jlyf4g81JGhAPepiNfGwApSBoZtWeGohmyVfUbAP41bkmQlg9N02Mgcu0X7UnE mrj4C2+lfetRD4qJzzaJQokCKBu6CzLunLg5BChDSyey0oJHbkW7NqyS6QkNZJui/ve4 J8Wg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=kyiVKBqF; 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 bz8si1728085ejc.744.2020.07.23.05.26.07 for ; Thu, 23 Jul 2020 05:26: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=kyiVKBqF; 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 S1729195AbgGWM0E (ORCPT ); Thu, 23 Jul 2020 08:26:04 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58286 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729079AbgGWMZb (ORCPT ); Thu, 23 Jul 2020 08:25:31 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 59BCBC0619E5 for ; Thu, 23 Jul 2020 05:25:31 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id 9so4774272wmj.5 for ; Thu, 23 Jul 2020 05:25:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=B2RqnTIG0uteLiyJB2KJla0FyHDSlH3XX5iZpJkogwU=; b=kyiVKBqFHyRIZ1JMpgAVtFSaEM23aouz0l5QQ49XYc2VCwG+/kgIftAS8DqXDBL5AU qd6V5yeI3N5++kJJJmHDEXW5XzlDzOX1DHnPr7NLQAktoJDF3hM1dro0LkJNM9WeVNva +BcwpmB1t2NLLGafuFKHrCF2cHKxiyC6AncSTxHOQrASL25IkuYpPuQzAdRtZ6zpWvGt zCxZ9yOUH9ZUCLSt7qrc2IwPEYpxxUeg703CkVjjWjGEkw90tzfXLIM1lLsgmskzaGwL uEruf6nUfzvy42sacxgrTTJ0r7+6fu39ReYjNpmtC5OYJcgypdXM5lHeAYropnacPtvs VRWg== 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=B2RqnTIG0uteLiyJB2KJla0FyHDSlH3XX5iZpJkogwU=; b=JdpYAghPMSpn+dD8wqtfA0s5W6VOTzkBDnp+mv6+jbT9fJzBBh17KEUQ8azdlfQ3xK cA7S53BaqMqVMHTC00u+f9TB9KFrtyodLj1LWcVPBNxxKpTpQhLXOO1tpt8IfiQ2QIv1 wxNmPD6BXuLNiTq6ldpHfKSuhXIcrYIXKy+hI3SGE17QeLaXxsrH7//6Ih3SU9AuzuaO AShh6K6ZhqTqMD0oB04lLLkUQmDI+SxU0RTd+sHhbCtXhbU9ra9+j+jZO9lTRGDrP2C6 KhWeIHQ7yLev6RGB7T2gSEQyqQINCbnKxakf/WStfJ6ZDtJDjaPKzyQk0trCCeySAgE6 /pVQ== X-Gm-Message-State: AOAM5316QaukFGWhLNhGDChvGehsUJRShEHGwnUzZSfSF6NdkPof7bgs bEYB/GvfH+Zktl7RBs44Kc8jyA== X-Received: by 2002:a1c:7719:: with SMTP id t25mr4166425wmi.144.1595507130048; Thu, 23 Jul 2020 05:25:30 -0700 (PDT) Received: from localhost.localdomain ([2.27.167.73]) by smtp.gmail.com with ESMTPSA id j5sm3510651wma.45.2020.07.23.05.25.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 23 Jul 2020 05:25:29 -0700 (PDT) From: Lee Jones To: jejb@linux.ibm.com, martin.petersen@oracle.com Cc: linux-kernel@vger.kernel.org, linux-scsi@vger.kernel.org, Lee Jones , Anil Gurumurthy , Sudarsana Kalluru Subject: [PATCH 33/40] scsi: bfa: bfa_ioc: Demote non-kerneldoc headers down to standard comment blocks Date: Thu, 23 Jul 2020 13:24:39 +0100 Message-Id: <20200723122446.1329773-34-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200723122446.1329773-1-lee.jones@linaro.org> References: <20200723122446.1329773-1-lee.jones@linaro.org> MIME-Version: 1.0 Sender: linux-scsi-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-scsi@vger.kernel.org This is probably historical (Doxygen?). Fixes the following W=1 kernel build warning(s): drivers/scsi/bfa/bfa_ioc.c:6646: warning: Cannot understand * @brief hardware error definition drivers/scsi/bfa/bfa_ioc.c:6661: warning: Cannot understand * @brief flash command register data structure drivers/scsi/bfa/bfa_ioc.c:6685: warning: Cannot understand * @brief flash device status register data structure drivers/scsi/bfa/bfa_ioc.c:6711: warning: Cannot understand * @brief flash address register data structure drivers/scsi/bfa/bfa_ioc.c:6732: warning: Function parameter or member 'pci_bar' not described in 'bfa_flash_set_cmd' drivers/scsi/bfa/bfa_ioc.c:6732: warning: Function parameter or member 'wr_cnt' not described in 'bfa_flash_set_cmd' drivers/scsi/bfa/bfa_ioc.c:6732: warning: Function parameter or member 'rd_cnt' not described in 'bfa_flash_set_cmd' drivers/scsi/bfa/bfa_ioc.c:6732: warning: Function parameter or member 'ad_cnt' not described in 'bfa_flash_set_cmd' drivers/scsi/bfa/bfa_ioc.c:6732: warning: Function parameter or member 'op' not described in 'bfa_flash_set_cmd' drivers/scsi/bfa/bfa_ioc.c:6768: warning: Cannot understand * @brief drivers/scsi/bfa/bfa_ioc.c:6807: warning: Cannot understand * @brief drivers/scsi/bfa/bfa_ioc.c:6852: warning: Cannot understand * @brief drivers/scsi/bfa/bfa_ioc.c:6898: warning: Cannot understand * @brief drivers/scsi/bfa/bfa_ioc.c:6914: warning: Cannot understand * @brief drivers/scsi/bfa/bfa_ioc.c:6940: warning: Cannot understand * @brief Cc: Anil Gurumurthy Cc: Sudarsana Kalluru Signed-off-by: Lee Jones --- drivers/scsi/bfa/bfa_ioc.c | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) -- 2.25.1 diff --git a/drivers/scsi/bfa/bfa_ioc.c b/drivers/scsi/bfa/bfa_ioc.c index 10c12b5a36b84..be48a7e31e803 100644 --- a/drivers/scsi/bfa/bfa_ioc.c +++ b/drivers/scsi/bfa/bfa_ioc.c @@ -6642,8 +6642,8 @@ enum bfa_flash_cmd { BFA_FLASH_READ_STATUS = 0x05, /* read status */ }; -/** - * @brief hardware error definition +/* + * Hardware error definition */ enum bfa_flash_err { BFA_FLASH_NOT_PRESENT = -1, /*!< flash not present */ @@ -6657,8 +6657,8 @@ enum bfa_flash_err { BFA_FLASH_ERR_LEN = -9, /*!< invalid length */ }; -/** - * @brief flash command register data structure +/* + * Flash command register data structure */ union bfa_flash_cmd_reg_u { struct { @@ -6681,8 +6681,8 @@ union bfa_flash_cmd_reg_u { u32 i; }; -/** - * @brief flash device status register data structure +/* + * Flash device status register data structure */ union bfa_flash_dev_status_reg_u { struct { @@ -6707,8 +6707,8 @@ union bfa_flash_dev_status_reg_u { u32 i; }; -/** - * @brief flash address register data structure +/* + * Flash address register data structure */ union bfa_flash_addr_reg_u { struct { @@ -6723,7 +6723,7 @@ union bfa_flash_addr_reg_u { u32 i; }; -/** +/* * dg flash_raw_private Flash raw private functions */ static void @@ -6764,7 +6764,7 @@ bfa_flash_cmd_act_check(void __iomem *pci_bar) return 0; } -/** +/* * @brief * Flush FLI data fifo. * @@ -6803,7 +6803,7 @@ bfa_flash_fifo_flush(void __iomem *pci_bar) return 0; } -/** +/* * @brief * Read flash status. * @@ -6848,7 +6848,7 @@ bfa_flash_status_read(void __iomem *pci_bar) return ret_status; } -/** +/* * @brief * Start flash read operation. * @@ -6894,7 +6894,7 @@ bfa_flash_read_start(void __iomem *pci_bar, u32 offset, u32 len, return 0; } -/** +/* * @brief * Check flash read operation. * @@ -6910,7 +6910,7 @@ bfa_flash_read_check(void __iomem *pci_bar) return 0; } -/** +/* * @brief * End flash read operation. * @@ -6936,7 +6936,7 @@ bfa_flash_read_end(void __iomem *pci_bar, u32 len, char *buf) bfa_flash_fifo_flush(pci_bar); } -/** +/* * @brief * Perform flash raw read. *