From patchwork Mon Oct 8 17:16:31 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Manivannan Sadhasivam X-Patchwork-Id: 148418 Delivered-To: patch@linaro.org Received: by 2002:a2e:8595:0:0:0:0:0 with SMTP id b21-v6csp3904775lji; Mon, 8 Oct 2018 10:17:00 -0700 (PDT) X-Google-Smtp-Source: ACcGV61QAODPKLJJYYa5sK73spcYecDioTGaOn64W8riR2oniLn6Gilli4J2lxzvP+DSF5AI96+D X-Received: by 2002:a63:d917:: with SMTP id r23-v6mr22449611pgg.0.1539019020176; Mon, 08 Oct 2018 10:17:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1539019020; cv=none; d=google.com; s=arc-20160816; b=mRMI6IB4oUNI+lElqgk4+Nfr71L5tNgIH8tNLy9zg8xqidKhA3/rPvZO3cpy6OxVkg 3hagIhZHDHKnkTmZ08hkBOUiPjtYoJ0Zao4u7zJTd0zUDZlq4yG8HW3kQfigTppAOIW+ IfRTydLFzoHC7a9EKRmNyZU5rlqkBtO/5jM+HAqvG5OSsP+G1m6GPjDT0UjT3QbslDkU 4sbYTnVIKqDTXZfHJtFyrUq5C9gxZE8y7fVfiz6fQDxRp8kMXFVcSPSCI9nKMYithDJE L58g2wQIHW27v2HjFO8Rz70AFny0emjUh4NeyXrsR7WHlcQ9fLHnOgtgywACRhGLpQuq bIJQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :dkim-signature; bh=CN5s4ecUj3pRaRBc5F3N9iKtufjq28Ma2Mtwvzmhwvk=; b=R88HoLrollfby0SIREMQahluBl30PgEPkf8OdKed3P2HS6CGx3xgLXKlwoeD+XSzCe dL9yvAOF7xt9JbmHbFvPBJjt+UdyuCHgBQWb2T/ASYhDs0dBhGjnaiEZK7IXSSrOH+dr hl0mXHBk+BHa+ow/I2JeWEOEc4MymVdbGI/jn0vM7OmeSlAVmRKID1qhmtcHhACib38O 5d9F/id9ryVmtityFPYu1lHTx1AXrLCseHnP+cuA1qHVbxqhuHoh8v8tO0D9sEZzoT8t X5pwTKntQWS6s93erflRYn5PsZv2hUiqVdh4/70ACr2DvQIomhHMSzr31K7L5Yy8P+1+ y45g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=dWns1hS3; spf=pass (google.com: best guess record for domain of dmaengine-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=dmaengine-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. [209.132.180.67]) by mx.google.com with ESMTP id h14-v6si20172072plk.130.2018.10.08.10.16.59; Mon, 08 Oct 2018 10:17:00 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of dmaengine-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=dWns1hS3; spf=pass (google.com: best guess record for domain of dmaengine-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=dmaengine-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 S1726383AbeJIA3l (ORCPT + 3 others); Mon, 8 Oct 2018 20:29:41 -0400 Received: from mail-pg1-f195.google.com ([209.85.215.195]:32784 "EHLO mail-pg1-f195.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726291AbeJIA3k (ORCPT ); Mon, 8 Oct 2018 20:29:40 -0400 Received: by mail-pg1-f195.google.com with SMTP id y18-v6so8133819pge.0 for ; Mon, 08 Oct 2018 10:16: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; bh=CN5s4ecUj3pRaRBc5F3N9iKtufjq28Ma2Mtwvzmhwvk=; b=dWns1hS3LQOD2KVT0K6ESnWaao0gmLhx41081rKNIPthLpS42aVeGylCgnSwvR+HrM 0kM5Elrfw/6J9bS79uzRnieYgckNSoNvaa9zt7Y04KERCGtbgVdgLv9dsfr/WfctPXNV RRHsACNno2glKZxuWoXtwl/PqSc02R6VYbouo= 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; bh=CN5s4ecUj3pRaRBc5F3N9iKtufjq28Ma2Mtwvzmhwvk=; b=p5pCDujQ3AY9he5GH2E4AV/dy9RO1QTcHD3+s7WmuNPza+YIUXBO2jmlye3SqULG2T 2T9Sg9JSnjz14G+inQ3lb6QFuwqjIdPrkVQPYth3hQvRsXMC49MQo5dImWlF4S8JobtQ ra1FoC1MvCPXXSMjSSR1BpULJi/+I7CqSi+ezp+FCwMKp6plC+3qPyw4EsZqxjBs5hyp JHUT7hBMXm1tmVbG3OurZLfGl6hUKw8b4W0/LvjnnUAdAdHnGp/f45QgDhFT43dkdOe3 Fn3DMM2n5FtWLaqaGiWhUSrLY1616WTc8oi3uLnaSGXXEMjCZgBxkSCDd5ErO80pbn1K IiPQ== X-Gm-Message-State: ABuFfojb8r/Pem3lvjD47GsNqiNWNCmPBv6+8BbpI5eSoUA5SgXcCEYm BQi1hCNe/Psqpl0IMmHuOVDv X-Received: by 2002:a62:71c4:: with SMTP id m187-v6mr25858021pfc.232.1539019017811; Mon, 08 Oct 2018 10:16:57 -0700 (PDT) Received: from localhost.localdomain ([2409:4072:996:3731:9fd:1785:d893:1e98]) by smtp.gmail.com with ESMTPSA id y24-v6sm8288974pfn.123.2018.10.08.10.16.49 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 08 Oct 2018 10:16:57 -0700 (PDT) From: Manivannan Sadhasivam To: vkoul@kernel.org Cc: afaerber@suse.de, dmaengine@vger.kernel.org, liuwei@actions-semi.com, 96boards@ucrobotics.com, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, hzhang@ucrobotics.com, bdong@ucrobotics.com, manivannanece23@gmail.com, thomas.liau@actions-semi.com, pn@denx.de, edgar.righi@lsitec.org.br, Manivannan Sadhasivam Subject: [PATCH] dmaengine: owl: Fix warnings generated during build Date: Mon, 8 Oct 2018 22:46:31 +0530 Message-Id: <20181008171631.5603-1-manivannan.sadhasivam@linaro.org> X-Mailer: git-send-email 2.17.1 Sender: dmaengine-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: dmaengine@vger.kernel.org Following warnings are generated when compiled with W=1, drivers/dma/owl-dma.c:170: warning: Function parameter or member 'cyclic' not described in 'owl_dma_txd' drivers/dma/owl-dma.c:198: warning: Function parameter or member 'cfg' not described in 'owl_dma_vchan' drivers/dma/owl-dma.c:198: warning: Function parameter or member 'drq' not described in 'owl_dma_vchan' drivers/dma/owl-dma.c:225: warning: Function parameter or member 'irq' not described in 'owl_dma' Fix this by adding comments for relevant struct members to appear in kernel-doc. Fixes: d64e1b3f5cce ("dmaengine: owl: Add Slave and Cyclic mode support for Actions Semi Owl S900 SoC") Reported-by: Vinod Koul Signed-off-by: Manivannan Sadhasivam --- drivers/dma/owl-dma.c | 4 ++++ 1 file changed, 4 insertions(+) -- 2.17.1 Reviewed-by: Andreas Färber diff --git a/drivers/dma/owl-dma.c b/drivers/dma/owl-dma.c index 1d26db4c9229..90bbcef99ef8 100644 --- a/drivers/dma/owl-dma.c +++ b/drivers/dma/owl-dma.c @@ -162,6 +162,7 @@ struct owl_dma_lli { * struct owl_dma_txd - Wrapper for struct dma_async_tx_descriptor * @vd: virtual DMA descriptor * @lli_list: link list of lli nodes + * @cyclic: flag to indicate cyclic transfers */ struct owl_dma_txd { struct virt_dma_desc vd; @@ -188,6 +189,8 @@ struct owl_dma_pchan { * @vc: wrappped virtual channel * @pchan: the physical channel utilized by this channel * @txd: active transaction on this channel + * @cfg: slave configuration for this channel + * @drq: physical DMA request ID for this channel */ struct owl_dma_vchan { struct virt_dma_chan vc; @@ -204,6 +207,7 @@ struct owl_dma_vchan { * @clk: clock for the DMA controller * @lock: a lock to use when change DMA controller global register * @lli_pool: a pool for the LLI descriptors + * @irq: interrupt ID for the DMA controller * @nr_pchans: the number of physical channels * @pchans: array of data for the physical channels * @nr_vchans: the number of physical channels