From patchwork Tue Aug 1 10:37:45 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anup Patel X-Patchwork-Id: 9874215 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 0F6A06038F for ; Tue, 1 Aug 2017 10:51:42 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 23D452867D for ; Tue, 1 Aug 2017 10:51:42 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1849628689; Tue, 1 Aug 2017 10:51:42 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 9BD932867D for ; Tue, 1 Aug 2017 10:51:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:References: In-Reply-To:Message-Id:Date:Subject:To:From:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Owner; bh=gO2QfCxdostE309VDofKJHs2o0wwo3Nd96F+D7MLWQY=; b=uG6L/ms9XFy/BlL4XnFpv3zIAq khaFEwB7aIjsx+KdaYv6d2/5uxzaJZ0pwiiCZfMWosItuckXYWwkxutj9AWByUVNJXEcQRT9hhWhs iT3WwdF/ppfDsmSQNnLP4bt20cLZ/EWVoU7IYoIWYQtxrHtbsrRvhQ4CcRgTYL2pVtdymWaXwTQ2T lDom9m+beJYzpPSkXpb4FFKkvcMe0+ln0zf9cCSB70eKcALL/or92hgEuo+0/7MYKQhiFrUFgWqYR gnPNRGGHYHbsTQLJ0Vqu8LG23lQrSS2WQ0TluKTKt2+VaKgGnXiaurcSKVIf4H8J53nCXLqfPv6nJ QpZNtAQQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1dcUm1-0004SY-AK; Tue, 01 Aug 2017 10:51:37 +0000 Received: from casper.infradead.org ([85.118.1.10]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dcUlC-00023u-DS for linux-arm-kernel@bombadil.infradead.org; Tue, 01 Aug 2017 10:50:46 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Sender:Reply-To:MIME-Version:Content-Type: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=xobYI3HAwpqh3Y7EfAO8XFOEK7W2Jp6CQVshrk2Uo+k=; b=dDbowaNfDKL1BG/jTucoRLPH+ t8sHHRlycDp4tg6BYArC/1OjTiwAwnBQcCaIW8xAbfxmi22Z83BNKvBaJZnrYpK2DgQTNMMl3qVjB lXnQS5BygZuw0Hd5vl7b7kprwp0BnjkzplqyKrvwbS3hy3HWUk23kG5eJpbR4DEHJNtJdfokshGvk cYTAB3laFLP8Tp5UJnq1Qrlxf2hUbKU9Q8Lx901UpafcmLdvfSW9hpugbbUMHd9CYptMWHg6AxKx2 3WWJuro9lDYoNbNzeyjs40zZw2X3AqklrOr9kXuT/tqSr2N+pUDc0ExoTCx/XvuVpQZVJKbiRvp0o HI14p4bOQ==; Received: from mail-qk0-x231.google.com ([2607:f8b0:400d:c09::231]) by casper.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dcUZZ-0002Zw-Mv for linux-arm-kernel@lists.infradead.org; Tue, 01 Aug 2017 10:38:50 +0000 Received: by mail-qk0-x231.google.com with SMTP id x191so6402643qka.5 for ; Tue, 01 Aug 2017 03:38:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=broadcom.com; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=xobYI3HAwpqh3Y7EfAO8XFOEK7W2Jp6CQVshrk2Uo+k=; b=fx/HMZCElX/RqQp04p9WrnNsZnjBtda7qq0Abfesa9GlbjGk+uIaKj0yy42iKvlD9s Upz7Az+v8n+GVjRo0HJfW0UvH+EK8T0sHjohgN3hg9eoMj5KabwRlenY5bkzj3mqkS7h qv/seatnQWMJvW5Hhwxrs7SWJrBuo1graNp50= 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; bh=xobYI3HAwpqh3Y7EfAO8XFOEK7W2Jp6CQVshrk2Uo+k=; b=uOyGrumev4pla6SAA3mXbK5ZG6H/+aImjaJcldW8kKlMWlkqkoHSqlQ40sr3b762FI e8cwJl1eBD2c4nBLxbMMrKFkvKQfm1Y7fW6/n7qZXiJbPZXbdtd9cMgc4NhSNgxQ2CNk ObSGkX21yEp0hisG4NvXPvr5+2T9Dvo+FoT7DAboRsFzoFBchgMosA8RBVtWDJ3dm4Uc R34dyN6dU8qnOtohIrmIUc/Un8/Fno+mR4X9Nwvd4hdMH08VzBTCSDWa3zPXXyDrdVCQ Q3bG5MneLscjGxMagBK+jkvbtw5xPix/WnWK/l94m/7tdRpWxOlfJdtIMyY3yYmn6Nnr sAdA== X-Gm-Message-State: AIVw1128sZX9RI+7m/dDgRk4A2jX0XbnbMSKWinr9A41i5uAWsQWvLLL 9+aIG95uo8kiHsrS X-Received: by 10.55.79.209 with SMTP id d200mr26198519qkb.336.1501583904049; Tue, 01 Aug 2017 03:38:24 -0700 (PDT) Received: from anup-HP-Compaq-8100-Elite-CMT-PC.dhcp.avagotech.net ([192.19.237.250]) by smtp.gmail.com with ESMTPSA id e32sm21784162qtb.63.2017.08.01.03.38.19 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 01 Aug 2017 03:38:23 -0700 (PDT) From: Anup Patel To: Rob Herring , Mark Rutland , Vinod Koul , Dan Williams Subject: [PATCH v2 01/16] dmaengine: bcm-sba-raid: Minor improvments in comments Date: Tue, 1 Aug 2017 16:07:45 +0530 Message-Id: <1501583880-32072-2-git-send-email-anup.patel@broadcom.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1501583880-32072-1-git-send-email-anup.patel@broadcom.com> References: <1501583880-32072-1-git-send-email-anup.patel@broadcom.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170801_113845_901775_2BB38150 X-CRM114-Status: GOOD ( 13.91 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, Florian Fainelli , Anup Patel , Scott Branden , Ray Jui , linux-kernel@vger.kernel.org, bcm-kernel-feedback-list@broadcom.com, dmaengine@vger.kernel.org, linux-arm-kernel@lists.infradead.org MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP Make section comments consistent across the Broadcom SBA RAID driver by avoiding " SBA " in some of the comments. Signed-off-by: Anup Patel --- drivers/dma/bcm-sba-raid.c | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/drivers/dma/bcm-sba-raid.c b/drivers/dma/bcm-sba-raid.c index e41bbc7..76999b7 100644 --- a/drivers/dma/bcm-sba-raid.c +++ b/drivers/dma/bcm-sba-raid.c @@ -48,7 +48,8 @@ #include "dmaengine.h" -/* SBA command related defines */ +/* ====== Driver macros and defines ===== */ + #define SBA_TYPE_SHIFT 48 #define SBA_TYPE_MASK GENMASK(1, 0) #define SBA_TYPE_A 0x0 @@ -88,6 +89,8 @@ #define to_sba_device(dchan) \ container_of(dchan, struct sba_device, dma_chan) +/* ===== Driver data structures ===== */ + enum sba_request_state { SBA_REQUEST_STATE_FREE = 1, SBA_REQUEST_STATE_ALLOCED = 2, @@ -164,7 +167,7 @@ struct sba_device { int reqs_free_count; }; -/* ====== SBA command helper routines ===== */ +/* ====== Command helper routines ===== */ static inline u64 __pure sba_cmd_enc(u64 cmd, u32 val, u32 shift, u32 mask) { @@ -196,7 +199,7 @@ static inline u32 __pure sba_cmd_pq_c_mdata(u32 d, u32 b1, u32 b0) ((d & SBA_C_MDATA_DNUM_MASK) << SBA_C_MDATA_DNUM_SHIFT); } -/* ====== Channel resource management routines ===== */ +/* ====== General helper routines ===== */ static struct sba_request *sba_alloc_request(struct sba_device *sba) {