Received-SPF: pass (google.com: domain of linux-crypto-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Subject: Re: [PATCH 2/3] crypto: s5p-sss - Add and fix kerneldoc
To:     Krzysztof Kozlowski <krzk@kernel.org>,
        Vladimir Zapolskiy <vz@mleia.com>,
        Herbert Xu <herbert@gondor.apana.org.au>,
        "David S. Miller" <davem@davemloft.net>,
        Rob Herring <robh+dt@kernel.org>, linux-crypto@vger.kernel.org,
        linux-samsung-soc@vger.kernel.org, devicetree@vger.kernel.org,
        linux-kernel@vger.kernel.org
From:   Kamil Konieczny <k.konieczny@samsung.com>
Message-ID: <ad460c31-aa10-21a8-2fd9-698d5a7ca823@samsung.com>
Date:   Fri, 4 Sep 2020 11:07:05 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
        Thunderbird/68.10.0
MIME-Version: 1.0
In-Reply-To: <20200903180400.2865-2-krzk@kernel.org>
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="utf-8"
CMS-TYPE: 201P
References: <20200903180400.2865-1-krzk@kernel.org>
        <CGME20200903180416eucas1p224f764a13664b5444cb3c00fca84c369@eucas1p2.samsung.com>
        <20200903180400.2865-2-krzk@kernel.org>
Sender: linux-crypto-owner@vger.kernel.org
Precedence: bulk


On 9/3/20 8:03 PM, Krzysztof Kozlowski wrote:
> Add missing and fix existing kerneldoc to silence W=1 warnings:
> 
>   drivers/crypto/s5p-sss.c:333: warning: Function parameter or member 'pclk' not described in 's5p_aes_dev'
>   drivers/crypto/s5p-sss.c:373: warning: Function parameter or member 'sgl' not described in 's5p_hash_reqctx'
>   drivers/crypto/s5p-sss.c:373: warning: Function parameter or member 'buffer' not described in 's5p_hash_reqctx'
>   drivers/crypto/s5p-sss.c:1143: warning: Function parameter or member 'new_len' not described in 's5p_hash_prepare_sgs'
>   drivers/crypto/s5p-sss.c:1143: warning: Excess function parameter 'nbytes' description in 's5p_hash_prepare_sgs'
> 
> Signed-off-by: Krzysztof Kozlowski <krzk@kernel.org>
> ---
>  drivers/crypto/s5p-sss.c | 7 ++++---
>  1 file changed, 4 insertions(+), 3 deletions(-)
> 
> diff --git a/drivers/crypto/s5p-sss.c b/drivers/crypto/s5p-sss.c
> index 341433fbcc4a..f67f1e22ecd1 100644
> --- a/drivers/crypto/s5p-sss.c
> +++ b/drivers/crypto/s5p-sss.c
> @@ -260,6 +260,7 @@ struct s5p_aes_ctx {
>   * struct s5p_aes_dev - Crypto device state container
>   * @dev:	Associated device
>   * @clk:	Clock for accessing hardware
> + * @pclk:	APB bus clock necessary to access the hardware
>   * @ioaddr:	Mapped IO memory region
>   * @aes_ioaddr:	Per-varian offset for AES block IO memory
>   * @irq_fc:	Feed control interrupt line
> @@ -342,13 +343,13 @@ struct s5p_aes_dev {
>   * @engine:	Bits for selecting type of HASH in SSS block
>   * @sg:		sg for DMA transfer
>   * @sg_len:	Length of sg for DMA transfer
> - * @sgl[]:	sg for joining buffer and req->src scatterlist
> + * @sgl:	sg for joining buffer and req->src scatterlist
>   * @skip:	Skip offset in req->src for current op
>   * @total:	Total number of bytes for current request
>   * @finup:	Keep state for finup or final.
>   * @error:	Keep track of error.
>   * @bufcnt:	Number of bytes holded in buffer[]
> - * @buffer[]:	For byte(s) from end of req->src in UPDATE op
> + * @buffer:	For byte(s) from end of req->src in UPDATE op
>   */
>  struct s5p_hash_reqctx {
>  	struct s5p_aes_dev	*dd;
> @@ -1125,7 +1126,7 @@ static int s5p_hash_copy_sg_lists(struct s5p_hash_reqctx *ctx,
>   * s5p_hash_prepare_sgs() - prepare sg for processing
>   * @ctx:	request context
>   * @sg:		source scatterlist request
> - * @nbytes:	number of bytes to process from sg
> + * @new_len:	number of bytes to process from sg
>   * @final:	final flag
>   *
>   * Check two conditions: (1) if buffers in sg have len aligned data, and (2)
> 

Reviewed-by: Kamil Konieczny <k.konieczny@samsung.com>
Acked-by: Kamil Konieczny <k.konieczny@samsung.com>