crypto: inside-secure - comment the caching function

Cosmetic patch adding a few comments to the ahash caching function to
understand easily what calculations are made in the functions; and how
the function is working.

Signed-off-by: Antoine Tenart <antoine.tenart@free-electrons.com>
Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>

diff --git a/drivers/crypto/inside-secure/safexcel_hash.c b/drivers/crypto/inside-secure/safexcel_hash.c
index ac922b91b2d7567b22ac073e3d407553b3ad6e77..e53e6b2331db061a5ba6ac393d294feb6c3cf393 100644 (file)
--- a/drivers/crypto/inside-secure/safexcel_hash.c
+++ b/drivers/crypto/inside-secure/safexcel_hash.c
@@ -484,13 +484,23 @@ static int safexcel_ahash_exit_inv(struct crypto_tfm *tfm)
        return 0;
 }
 
+/* safexcel_ahash_cache: cache data until at least one request can be sent to
+ * the engine, aka. when there is at least 1 block size in the pipe.
+ */
 static int safexcel_ahash_cache(struct ahash_request *areq)
 {
        struct safexcel_ahash_req *req = ahash_request_ctx(areq);
        struct crypto_ahash *ahash = crypto_ahash_reqtfm(areq);
        int queued, cache_len;
 
+       /* cache_len: everyting accepted by the driver but not sent yet,
+        * tot sz handled by update() - last req sz - tot sz handled by send()
+        */
        cache_len = req->len - areq->nbytes - req->processed;
+       /* queued: everything accepted by the driver which will be handled by
+        * the next send() calls.
+        * tot sz handled by update() - tot sz handled by send()
+        */
        queued = req->len - req->processed;
 
        /*