Commit 319936bf authored by Krzysztof Kozlowski's avatar Krzysztof Kozlowski Committed by Herbert Xu
Browse files

crypto: caam - Fix kerneldoc 



Fix kerneldoc warnings like:

  drivers/crypto/caam/caamalg_qi2.c:73: warning: cannot understand function prototype: 'struct caam_ctx'
  drivers/crypto/caam/caamalg_qi2.c:2962: warning: cannot understand function prototype: 'struct caam_hash_ctx'
  drivers/crypto/caam/ctrl.c:449: warning: Function parameter or member 'ctrl' not described in 'caam_get_era'

Signed-off-by: default avatarKrzysztof Kozlowski <krzk@kernel.org>
Reviewed-by: default avatarIuliana Prodan <iuliana.prodan@nxp.com>
Signed-off-by: default avatarHerbert Xu <herbert@gondor.apana.org.au>
parent 24efcec2

drivers/crypto/caam/caamalg_desc.c

+1 −0
Original line number Diff line number Diff line
@@ -373,6 +373,7 @@ EXPORT_SYMBOL(cnstr_shdsc_aead_encap); 
 *         with OP_ALG_AAI_HMAC_PRECOMP.

 * @ivsize: initialization vector size

 * @icvsize: integrity check value (ICV) size (truncated or full)

 * @geniv: whether to generate Encrypted Chain IV

 * @is_rfc3686: true when ctr(aes) is wrapped by rfc3686 template

 * @nonce: pointer to rfc3686 nonce

 * @ctx1_iv_off: IV offset in CONTEXT1 register

drivers/crypto/caam/caamalg_qi2.c

+2 −2
Original line number Diff line number Diff line
@@ -59,7 +59,7 @@ struct caam_skcipher_alg { 
};



/**

 * caam_ctx - per-session context

 * struct caam_ctx - per-session context

 * @flc: Flow Contexts array

 * @key:  [authentication key], encryption key

 * @flc_dma: I/O virtual addresses of the Flow Contexts
@@ -2951,7 +2951,7 @@ enum hash_optype { 
};



/**

 * caam_hash_ctx - ahash per-session context

 * struct caam_hash_ctx - ahash per-session context

 * @flc: Flow Contexts array

 * @key: authentication key

 * @flc_dma: I/O virtual addresses of the Flow Contexts

drivers/crypto/caam/ctrl.c

+3 −1
Original line number Diff line number Diff line
@@ -443,7 +443,9 @@ static int caam_get_era_from_hw(struct caam_ctrl __iomem *ctrl) 
 * by u-boot.

 * In case this property is not passed an attempt to retrieve the CAAM

 * era via register reads will be made.

 **/

 *

 * @ctrl:	controller region

 */

static int caam_get_era(struct caam_ctrl __iomem *ctrl)

{

	struct device_node *caam_node;

drivers/crypto/caam/jr.c

+5 −5
Original line number Diff line number Diff line
@@ -324,7 +324,7 @@ EXPORT_SYMBOL(caam_jr_alloc); 


/**

 * caam_jr_free() - Free the Job Ring

 * @rdev     - points to the dev that identifies the Job ring to

 * @rdev:      points to the dev that identifies the Job ring to

 *             be released.

 **/

void caam_jr_free(struct device *rdev)
@@ -349,15 +349,15 @@ EXPORT_SYMBOL(caam_jr_free); 
 *        of this request. This has the form:

 *        callback(struct device *dev, u32 *desc, u32 stat, void *arg)

 *        where:

 *        @dev:    contains the job ring device that processed this

 *        dev:     contains the job ring device that processed this

 *                 response.

 *        @desc:   descriptor that initiated the request, same as

 *        desc:    descriptor that initiated the request, same as

 *                 "desc" being argued to caam_jr_enqueue().

 *        @status: untranslated status received from CAAM. See the

 *        status:  untranslated status received from CAAM. See the

 *                 reference manual for a detailed description of

 *                 error meaning, or see the JRSTA definitions in the

 *                 register header file

 *        @areq:   optional pointer to an argument passed with the

 *        areq:    optional pointer to an argument passed with the

 *                 original request

 * @areq: optional pointer to a user argument for use at callback

 *        time.

CRA Git | Maintained and supported by SUSTech CRA and CCSE