1 /* SPDX-License-Identifier: GPL-2.0-or-later */
27  * struct hash_alg_common - define properties of message digest
40  *	  The hash_alg_common data structure now adds the hash-specific
65  * struct ahash_alg - asynchronous message digest definition
70  *	  implementation must not use req->result.
80  *	   req->result.
116  *	    multiple times later on for multiple re-use. No data processing
117  *	    happens at this point. Driver must not use req->result.
122  *	    req->result.
162  * Worst case is hmac(sha3-224-generic).  Its context is a nested 'shash_desc'
173  * struct shash_alg - synchronous message digest definition
254  * crypto_alloc_ahash() - allocate ahash cipher handle
274 	return &tfm->base;  in crypto_ahash_tfm()
278  * crypto_free_ahash() - zeroize and free the ahash handle
289  * crypto_has_ahash() - Search for the availability of an ahash.
311  * crypto_ahash_blocksize() - obtain block size for cipher
333 	return __crypto_hash_alg_common(crypto_ahash_tfm(tfm)->__crt_alg);  in crypto_hash_alg_common()
337  * crypto_ahash_digestsize() - obtain message digest size
348 	return crypto_hash_alg_common(tfm)->digestsize;  in crypto_ahash_digestsize()
352  * crypto_ahash_statesize() - obtain size of the ahash state
363 	return tfm->statesize;  in crypto_ahash_statesize()
382  * crypto_ahash_reqtfm() - obtain cipher handle from request
394 	return __crypto_ahash_cast(req->base.tfm);  in crypto_ahash_reqtfm()
398  * crypto_ahash_reqsize() - obtain size of the request data structure
405 	return tfm->reqsize;  in crypto_ahash_reqsize()
410 	return req->__ctx;  in ahash_request_ctx()
414  * crypto_ahash_setkey - set key for cipher handle
428  * crypto_ahash_finup() - update and finalize message digest
432  * This function is a "short-hand" for the function calls of
441  * crypto_ahash_final() - calculate message digest
451  * -EINPROGRESS	if data is fed into hardware (DMA) or queued for later;
452  * -EBUSY	if queue is full and request should be resubmitted later;
458  * crypto_ahash_digest() - calculate message digest for a buffer
462  * This function is a "short-hand" for the function calls of crypto_ahash_init,
471  * crypto_ahash_export() - extract current message digest state
476  * caller-allocated output buffer out which must have sufficient size (e.g. by
484  * crypto_ahash_import() - import message digest state
497  * crypto_ahash_init() - (re)initialize message digest handle
501  * The call (re-)initializes the message digest referenced by the ahash_request
510  * crypto_ahash_update() - add data to message digest for processing
534  * ahash_request_set_tfm() - update cipher handle reference in request
544 	req->base.tfm = crypto_ahash_tfm(tfm);  in ahash_request_set_tfm()
548  * ahash_request_alloc() - allocate request data structure
575  * ahash_request_free() - zeroize and free the request data structure
596  * ahash_request_set_callback() - set asynchronous callback function
625 	req->base.complete = compl;  in ahash_request_set_callback()
626 	req->base.data = data;  in ahash_request_set_callback()
627 	req->base.flags = flags;  in ahash_request_set_callback()
631  * ahash_request_set_crypt() - set data buffers
634  * @result: buffer that is filled with the message digest -- the caller must
647 	req->src = src;  in ahash_request_set_crypt()
648 	req->nbytes = nbytes;  in ahash_request_set_crypt()
649 	req->result = result;  in ahash_request_set_crypt()
661  * The synchronous message digest API can store user-related context in its
666  * crypto_alloc_shash() - allocate message digest handle
688 	return &tfm->base;  in crypto_shash_tfm()
692  * crypto_free_shash() - zeroize and free the message digest handle
713  * crypto_shash_blocksize() - obtain block size for cipher
733 	return __crypto_shash_alg(crypto_shash_tfm(tfm)->__crt_alg);  in crypto_shash_alg()
737  * crypto_shash_digestsize() - obtain message digest size
747 	return crypto_shash_alg(tfm)->digestsize;  in crypto_shash_digestsize()
752 	return crypto_shash_alg(tfm)->statesize;  in crypto_shash_statesize()
771  * crypto_shash_descsize() - obtain the operational state size
787 	return tfm->descsize;  in crypto_shash_descsize()
792 	return desc->__ctx;  in shash_desc_ctx()
796  * crypto_shash_setkey() - set key for message digest
812  * crypto_shash_digest() - calculate message digest for buffer
818  * This function is a "short-hand" for the function calls of crypto_shash_init,
830  * crypto_shash_tfm_digest() - calculate message digest for buffer
849  * crypto_shash_export() - extract operational state for message digest
854  * caller-allocated output buffer out which must have sufficient size (e.g. by
863  * crypto_shash_import() - import operational state
877  * crypto_shash_init() - (re)initialize message digest
880  * The call (re-)initializes the message digest referenced by the
890 	struct crypto_shash *tfm = desc->tfm;  in crypto_shash_init()
893 		return -ENOKEY;  in crypto_shash_init()
895 	return crypto_shash_alg(tfm)->init(desc);  in crypto_shash_init()
899  * crypto_shash_update() - add data to message digest for processing
914  * crypto_shash_final() - calculate message digest
930  * crypto_shash_finup() - calculate message digest of buffer
936  * This function is a "short-hand" for the function calls of
950 			 sizeof(*desc) + crypto_shash_descsize(desc->tfm));  in shash_desc_zero()