From patchwork Thu Dec 7 05:21:05 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Appana Durga Kedareswara rao X-Patchwork-Id: 10097663 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 211BD60325 for ; Thu, 7 Dec 2017 05:37:53 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 12D9228BE8 for ; Thu, 7 Dec 2017 05:37:53 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 079752A32A; Thu, 7 Dec 2017 05:37:53 +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=-4.2 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED, DKIM_VALID, RCVD_IN_DNSWL_MED autolearn=unavailable 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 925B228BE8 for ; Thu, 7 Dec 2017 05:37:52 +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:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version: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=zqhpL1RnS5uuwIYCC40ALbP9AZM9j/Wfy89XZhQ9kO0=; b=Gd66F2+l8PZJoe ivB+r824AZJIK0SQIKFUQo90FaR74avV19JlG0sDWpsQj2yIt9BCmiqoFpnWt5s1C4MBcRXa9+mwl Tl/NGvhZT9kFgXxNTHSLPB+TG9fNVCyYkPGHdsvLc048jwE+szNgB7TxiUBIUXwouTSy/VT+A61J7 p01YbOR0fWy44qilsjXO0m4HMQ/Mutjon8QKxUKfs+9EMHZyb7mTnmaT/T38I9gwG6draUUuPOnTp JgJ1VgY5T8wHR66TvVOQhRTzjnFqyhzYUp1C0fT1VOuKOyOXYsDslXgWGCEjKtMbzizEUPWAtceMr SHR1/MN+5yhRiY8oOJqQ==; 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 1eMosY-0006jf-Uh; Thu, 07 Dec 2017 05:37:50 +0000 Received: from mail-bn3nam01on0082.outbound.protection.outlook.com ([104.47.33.82] helo=NAM01-BN3-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1eMorN-0005QJ-Bp for linux-arm-kernel@lists.infradead.org; Thu, 07 Dec 2017 05:36:44 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xilinx.onmicrosoft.com; s=selector1-xilinx-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=ZVBlGIUUANSrb7S4Nkcvo2xdys9SKIijYWG5kbgpTz8=; b=LFfj3BodSssN+/EuWKmdHvApMxo8fKBCvbggiB1/z+eK2gS8UOGifDHnLiFM6eejIP9p5LjDy9kJIuJHP6VOM/kfwzDR/uKqBRJdk2Ki8Lf8DPjGRgmJLRprFVT8imSfsvgFwP8tegxzlGBfZQp/nTf6cs3VE7j6lG38wNhWuRA= Received: from SN4PR0201CA0051.namprd02.prod.outlook.com (10.171.31.141) by BN6PR02MB3379.namprd02.prod.outlook.com (10.161.153.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.282.5; Thu, 7 Dec 2017 05:36:13 +0000 Received: from CY1NAM02FT036.eop-nam02.prod.protection.outlook.com (2a01:111:f400:7e45::207) by SN4PR0201CA0051.outlook.office365.com (2603:10b6:803:20::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.302.9 via Frontend Transport; Thu, 7 Dec 2017 05:36:12 +0000 Authentication-Results: spf=pass (sender IP is 149.199.60.100) smtp.mailfrom=xilinx.com; vger.kernel.org; dkim=none (message not signed) header.d=none;vger.kernel.org; dmarc=bestguesspass action=none header.from=xilinx.com; Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.60.100 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.100; helo=xsj-pvapsmtpgw02; Received: from xsj-pvapsmtpgw02 (149.199.60.100) by CY1NAM02FT036.mail.protection.outlook.com (10.152.75.124) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.282.5 via Frontend Transport; Thu, 7 Dec 2017 05:36:08 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66]:57537 helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw02 with esmtp (Exim 4.63) (envelope-from ) id 1eMoqt-0000cw-4h; Wed, 06 Dec 2017 21:36:07 -0800 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1eMoqt-0003jy-0m; Wed, 06 Dec 2017 21:36:07 -0800 Received: from xsj-pvapsmtp01 (maildrop.xilinx.com [149.199.38.66]) by xsj-smtp-dlp2.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id vB75ZvTR031546; Wed, 6 Dec 2017 21:35:57 -0800 Received: from [172.23.37.82] (helo=xhdpunnaia40.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1eMoqi-0003aq-KS; Wed, 06 Dec 2017 21:35:57 -0800 From: Kedareswara rao Appana To: , , , , , , , , Subject: [PATCH v7 4/6] dmaengine: xilinx_dma: Fix kernel doc warnings Date: Thu, 7 Dec 2017 10:51:05 +0530 Message-ID: <1512624067-13554-5-git-send-email-appanad@xilinx.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1512624067-13554-1-git-send-email-appanad@xilinx.com> References: <1512624067-13554-1-git-send-email-appanad@xilinx.com> X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.1.0.1062-23512.006 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:149.199.60.100; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(376002)(346002)(39860400002)(2980300002)(438002)(189003)(199004)(575784001)(50466002)(478600001)(77096006)(305945005)(106466001)(356003)(47776003)(2950100002)(8676002)(63266004)(6666003)(5660300001)(551934003)(81166006)(48376002)(81156014)(33646002)(7416002)(2201001)(36386004)(36756003)(2906002)(50226002)(51416003)(8936002)(110136005)(54906003)(7696005)(16586007)(316002)(4326008)(9786002)(39060400002)(106002)(76176011)(107986001)(5001870100001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN6PR02MB3379; H:xsj-pvapsmtpgw02; FPR:; SPF:Pass; PTR:xapps1.xilinx.com,unknown-60-100.xilinx.com; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; CY1NAM02FT036; 1:jD6fKdpiBtPVotjJ3QshH//+wV2/NE6F7VGBSuKvSSE1pd8pbIGQrTrFhFarQLzcXi2nTpjUxX8E9I8iTpMyUl6Ij5joEdNt1sLTbAsMSIVXFQXIhHD7GV+VbGKwKVHB MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 935e5b32-3e43-4f46-e4f0-08d53d346d18 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(5600026)(4604075)(4608076)(2017052603286); SRVR:BN6PR02MB3379; X-Microsoft-Exchange-Diagnostics: 1; BN6PR02MB3379; 3:aYof93giv8uxMmf6rQlEYNwtNVz26ijry3zP4A71HlfwGbUsT59ccEiyJziXDsWZXD0gdzaQaLcC2d2to/X0RtAE9x78MyfWY7R/7k23YMLxoPMyM96zA5exkD3ZLUOftszWIknVN/wvyCGybUY243nt0lAIbiRDfWetDtTxxLTtndX80s/eBKuHS9vEy2iqUpo6uOVfg+hhhrdHfPuXDGJuVhFLMzG2M91V7AId6TES69H0eqRwc4g18tj9bpmmkL8NW9I7lSpjcw4iO6bKmG2Z+L4rQJSngaSoul2mpPJiGfAct2c2xcTwuEynoV5nPe51J5DgJsXdKRo/V70L7WmQAFRJig/GCPXdQsHbndM=; 25:WAzAN/D92yZXc7TmMTU5OIPBBKGAMsTISQO+KYWNxjXx1mak0nK+OXfgE/0jiDBHrl6p2kg2+VZVgkXkux/J0QzqpjOYFCh7Pqibal9WgGTFetGkX+IgQYisl3CE8m+LKUM/OflzDZKRCJHySzzZzKsQBbZltkVBfjkcRbRYBkvuj2LplsEEgxxyO9Z9mjuQ1BI1So5dNyrAsETRyV6d44FsyZi5Cyk3ViFFtJNjFCnpFabljev9YbFT3NygrB0a6l5NKJdcv8Y7PyzhMGd6dSalDiy4cYllaV28t6votb8TTwB/Rmfu54XcykxV535YJHQNTtREiN0WDDJ2z00T/Q== X-MS-TrafficTypeDiagnostic: BN6PR02MB3379: X-Microsoft-Exchange-Diagnostics: 1; BN6PR02MB3379; 31:G++eWG10cXmR2ZptGa8za+yyNzH3rakenK3BwR5wF0WlBwLAQVY+QfkJQ91N/h0BvK1m48Ny527f56JygPFuK8xOHEV7FCzqNBWKgLRtZindtMMC761MwyRUaf/EdIMN/ngr7JGzkXFUF+m2ReFy0yn9WAgusdstx58i5tQVS8m8y8rD0OVhJYuwxW0ubAbeVlq7yyRMtaTeJF1yjBbmc+s9Tb94X04c1pNVMHJGTl8=; 20:t4ovQFAK3XHTvoLbmUw1d7q5o8lPn4QAsnAbrDB03mdaOoE20lvKeiL4aGWFOaWDsRZoLiJOdEGDG0KkMFwIL30O7iFvX/BNwdJncK/bxYjuYDGTzEKgjPFzF6yxOOS4kdqxSjSbzHd1nl84jderQzccl5zlgbjTax3VSyD/GD5V5+K6QKpus1HrrA3FijHJxXdRrql+R9odjjnK0+ntvygVxufR5+pvv0EN5yYYDImSVNXPRrSsmj4OzVI6OiszSo3IuHb8v6ELSaT5LaISe1nAkdYj6cFK2YxxKDH71b8WEo8w1c7Fr5r6znwMtS+BztPvFMIhB9Fzc3FFQrRlzKbeZDfe2LLDrtaMVwPhbpsB8Wq/FMt8FSLiAOi1XF8+TBSxL4TKZqFRfWS7NLvkjXuFzGnXk+rU5VC9LyedirgRS3E/bwx+gww4vZDVupstiScrJzHlFMIaw9zZ4Wpqw5PZMkGi3tYZ2VtvIW39A0EbXUl3L7wgOyOy7NBnt4b0 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(2401047)(8121501046)(5005006)(10201501046)(3002001)(3231022)(93006095)(93004095)(6055026)(6041248)(20161123562025)(20161123560025)(20161123558100)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123555025)(20161123564025)(6072148)(201708071742011); SRVR:BN6PR02MB3379; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:BN6PR02MB3379; X-Microsoft-Exchange-Diagnostics: 1; BN6PR02MB3379; 4:6yuVKMQz7kZqY8JuLIgOk9YZl6jaXQggM0vHT4+bnO95yJjC6rbiHLGmRfd4Zx/au6Bx5o+ba+jQGB+U5TpoBKj+OARekdlo8kbivup6plGnlsg1SUZenu3xeSI9SEiMWE3j4Ka6NJ1E5WN0usfqZOFGO+5lCxXkP6TVhfdhoqWCQrUvi6/PpXdvf5QrGdMnzNcxn7/+GeP70lnfz/cUaG6MDf04bI24u/uczkGcEa6HTjH8H6GbKNokK87ugMRLJ+XzfWRegKP84Tcpabtc1YqZymVnYJQeBFTK9AS2FpCfD9Ayy73ZGEuXPAhnGoN8 X-Forefront-PRVS: 05143A8241 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN6PR02MB3379; 23:yKxaxCXLH9neHt/QX5/L07d+8A8WQQxwepy9QGE6V?= =?us-ascii?Q?jm/u5vU3GopQhLobHhwJQfy4RfLCad4WW1w5g0Z3wD3VuyqSjjBZkUZ3+fKd?= =?us-ascii?Q?Taxa9rDLlnILXqltcMj/zL8WkRF4Vo8VfZJiMp4TYi15W65XJfodVpMguXLY?= =?us-ascii?Q?oBizNknF6p26tfZZ/KgrpmqLiy1ELDIK3k9LVphO+YnwwZMcQ+A+Ty/QTVW8?= =?us-ascii?Q?p9D+J4avo2t2i+gT9DNI7JdLkD0DrIsss5rTkFQLn7C/yZLiffCJa+WiQBx+?= =?us-ascii?Q?R1potX3lh5dBgE5I4QKVCaJHI3NHjDNxp+nowHYfl35rWsrcql1PwL5eBJbt?= =?us-ascii?Q?1mp2vNETDNFTbLx7nsA5z+nGDNt18vei0GbRag6OrPwDWbMl1fs5TYl0t2Ve?= =?us-ascii?Q?bh+s6Y4eXaeM8ciqsGAnE5lgkOwMePG+npUPBKkJES3+opU4stCCBr//n7fr?= =?us-ascii?Q?YM1OtEDX47dMYtE6tin9HWl0fkq/YHGDyfLiREtNQ1d3D+R2ytANm8xspP9Q?= =?us-ascii?Q?KI7TUrDcI3QqnqzREBU/oIlKftNjclp3DRuGpvUbafJjB5KHqe2fLEywC61v?= =?us-ascii?Q?U4OVTHRzmjyOpuGlsz9yhCI4RCBrfevdacTj/j5KA4WUN7N7rVGP4KZepph5?= =?us-ascii?Q?uitDlJE+9bu46LpQtbP5LjRP1RzcprU9IDp9j2Rv/DANA5g8QzB5mlXbzrTp?= =?us-ascii?Q?hE/AKV/JIgcbaeSJCIdP49OQlmwyTl5UYbFYgoc4/1+yH1imw4mQJcA8cjWY?= =?us-ascii?Q?Va9aqoJ1RSbznYlRbFaMXuB1VX+BROpyEmpFKl+a4kPrcC1A00acplj8Nn7Z?= =?us-ascii?Q?g3Njui9IeHE1MVKNAxYfdWwMivq0HJ9QGd3+eSJLyxgwy0++2NJl8oEqD3U1?= =?us-ascii?Q?mi0hxhBTFQcnoYb8FlxiAzVzHFQm+qttDcA4pdRa/zHi9N1IbcqUPRfMR33/?= =?us-ascii?Q?Y5fd42zaX++tSSM2o2TJPncCmFFfFBnzKNBSJAcs3GqzuAcLK5yG3qkVqHF0?= =?us-ascii?Q?kOonX8slPLPI+twIxBr4Lo/E8Gqw2GuUUo+E4IUUuinBzkjYbpB3/xsLSjLj?= =?us-ascii?Q?IYIpP+5TQYLbjGMVUfvbfUOqZd/?= X-Microsoft-Exchange-Diagnostics: 1; BN6PR02MB3379; 6:vUaSJzZLlBfy0Ouamc3389PPpgDLRlJpvyZlO8Q1n5ejNBnaJ4uY2BjdHqNwsSoq1Gd4WsELffqllp++65tJuHvM7bAU1pHJYAJQqpBDnbIecdwTE6CORUe7W73ypmOgqwDmv7TVxI0uS49l9TfOrogtvLt6v6l4XAMAeRl365lYjbUPU6CzE1KLfDlV+CqOb6oemvfdzV/aN/5XfDRqEG+wHRsocI8ADqSvsUEsfuqCGvgVHap6U6TMQD4HfbDNXmyEXc/Hhkx7gXQ3Ivv/wIQEb+de+6DZtutVhwXy0710ftH9ArvXk5gD3Cxb0h16NX0bT8y3ZnOEx6VZT6KQg+7SRxrcYmHsNIydubDp8fM=; 5:Qwzc7jcVjG8ugwtJCYbw6NGzKJ5KNN+JKqo+F/x/l3QHxFt7/5zCU80CchRF/ios7uQD588yZmcB2PZ6LIDivZhADy1Gp2SgoAVyP+1UjVJ7ezpMHH5xG2FHE4sCjpHZJ6gLQeCbSVFjJPTdRcvssNVEVaMvrF7tzMHjgvNC9O4=; 24:FsEu6JI+dbzvelmw4JHz2r4T3jlXT3iRafl6eGX59BGgg4LDe5r7lvcto7/Ul2rD7TkyIYeg1CGZBvkUpGX3nJGz/jwS55elzokT3nUYgJI=; 7:Zhl7+PN97LFRY9uAzBgnQadu7RLSpRCXtEYQ4YgPqkVjtsx7DJhItdDMbk5r/heTaMUBPk2NwBlIm8/bRljAvuVtkXBWepgC5FjWztWQ3LDNh0xZQyZVRPkB0gNz/Hikg7LO/Tk5gEeR4gACnaJ290399hGfjFQ8Dpr1LDql29CrtjRpJIe0sECthFc4npi8QMPoWYvTBATTv+OoO842vgFj4wS+gHW/CwOHmQsjdI7E0OO6bBfWg3dF2cIslwaI SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Dec 2017 05:36:08.3390 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 935e5b32-3e43-4f46-e4f0-08d53d346d18 X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c; Ip=[149.199.60.100]; Helo=[xsj-pvapsmtpgw02] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR02MB3379 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20171206_213637_886886_AFDF1B99 X-CRM114-Status: GOOD ( 10.68 ) 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: dmaengine@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org 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 This patch fixes the kernel doc warnings in the driver. Signed-off-by: Kedareswara rao Appana --- Changes for v7: --> New patch. drivers/dma/xilinx/xilinx_dma.c | 37 ++++++++++++++++++++++++------------- 1 file changed, 24 insertions(+), 13 deletions(-) diff --git a/drivers/dma/xilinx/xilinx_dma.c b/drivers/dma/xilinx/xilinx_dma.c index ab01306..eaa93fe 100644 --- a/drivers/dma/xilinx/xilinx_dma.c +++ b/drivers/dma/xilinx/xilinx_dma.c @@ -214,8 +214,8 @@ struct xilinx_vdma_desc_hw { * @next_desc_msb: MSB of Next Descriptor Pointer @0x04 * @buf_addr: Buffer address @0x08 * @buf_addr_msb: MSB of Buffer address @0x0C - * @pad1: Reserved @0x10 - * @pad2: Reserved @0x14 + * @mcdma_control: Control field for mcdma @0x10 + * @vsize_stride: Vsize and Stride field for mcdma @0x14 * @control: Control field @0x18 * @status: Status field @0x1C * @app: APP Fields @0x20 - 0x30 @@ -235,11 +235,11 @@ struct xilinx_axidma_desc_hw { /** * struct xilinx_cdma_desc_hw - Hardware Descriptor * @next_desc: Next Descriptor Pointer @0x00 - * @next_descmsb: Next Descriptor Pointer MSB @0x04 + * @next_desc_msb: Next Descriptor Pointer MSB @0x04 * @src_addr: Source address @0x08 - * @src_addrmsb: Source address MSB @0x0C + * @src_addr_msb: Source address MSB @0x0C * @dest_addr: Destination address @0x10 - * @dest_addrmsb: Destination address MSB @0x14 + * @dest_addr_msb: Destination address MSB @0x14 * @control: Control field @0x18 * @status: Status field @0x1C */ @@ -339,6 +339,7 @@ struct xilinx_dma_tx_descriptor { * @cyclic_seg_p: Physical allocated segments base for cyclic dma * @start_transfer: Differentiate b/w DMA IP's transfer * @stop_transfer: Differentiate b/w DMA IP's quiesce + * @tdest: TDEST value for mcdma */ struct xilinx_dma_chan { struct xilinx_dma_device *xdev; @@ -378,11 +379,11 @@ struct xilinx_dma_chan { }; /** - * enum xdma_ip_type: DMA IP type. + * enum xdma_ip_type - DMA IP type. * - * XDMA_TYPE_AXIDMA: Axi dma ip. - * XDMA_TYPE_CDMA: Axi cdma ip. - * XDMA_TYPE_VDMA: Axi vdma ip. + * @XDMA_TYPE_AXIDMA: Axi dma ip. + * @XDMA_TYPE_CDMA: Axi cdma ip. + * @XDMA_TYPE_VDMA: Axi vdma ip. * */ enum xdma_ip_type { @@ -994,6 +995,8 @@ static enum dma_status xilinx_dma_tx_status(struct dma_chan *dchan, /** * xilinx_dma_stop_transfer - Halt DMA channel * @chan: Driver specific DMA channel + * + * Return: '0' on success and failure value on error */ static int xilinx_dma_stop_transfer(struct xilinx_dma_chan *chan) { @@ -1010,6 +1013,8 @@ static int xilinx_dma_stop_transfer(struct xilinx_dma_chan *chan) /** * xilinx_cdma_stop_transfer - Wait for the current transfer to complete * @chan: Driver specific DMA channel + * + * Return: '0' on success and failure value on error */ static int xilinx_cdma_stop_transfer(struct xilinx_dma_chan *chan) { @@ -1825,11 +1830,14 @@ static struct dma_async_tx_descriptor *xilinx_dma_prep_slave_sg( /** * xilinx_dma_prep_dma_cyclic - prepare descriptors for a DMA_SLAVE transaction - * @chan: DMA channel - * @sgl: scatterlist to transfer to/from - * @sg_len: number of entries in @scatterlist + * @dchan: DMA channel + * @buf_addr: Physical address of the buffer + * @buf_len: Total length of the cyclic buffers + * @period_len: length of individual cyclic buffer * @direction: DMA direction * @flags: transfer ack flags + * + * Return: Async transaction descriptor on success and NULL on failure */ static struct dma_async_tx_descriptor *xilinx_dma_prep_dma_cyclic( struct dma_chan *dchan, dma_addr_t buf_addr, size_t buf_len, @@ -2013,7 +2021,9 @@ xilinx_dma_prep_interleaved(struct dma_chan *dchan, /** * xilinx_dma_terminate_all - Halt the channel and free descriptors - * @chan: Driver specific DMA Channel pointer + * @dchan: Driver specific DMA Channel pointer + * + * Return: '0' always. */ static int xilinx_dma_terminate_all(struct dma_chan *dchan) { @@ -2328,6 +2338,7 @@ static void xdma_disable_allclks(struct xilinx_dma_device *xdev) * * @xdev: Driver specific device structure * @node: Device node + * @chan_id: DMA Channel id * * Return: '0' on success and failure value on error */