Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8bc618d6 authored by Herbert Xu's avatar Herbert Xu
Browse files

crypto: doc - Use ahash 



This patch replaces the crypto_hash example in api-intro.txt with
crypto_ahash.

Signed-off-by: default avatarHerbert Xu <herbert@gondor.apana.org.au>
parent 0660511c

Documentation/crypto/api-intro.txt

+14 −9
Original line number Diff line number Diff line
@@ -49,28 +49,33 @@ under development. 


Here's an example of how to use the API:



	#include <linux/crypto.h>

	#include <crypto/ahash.h>

	#include <linux/err.h>

	#include <linux/scatterlist.h>

	

	struct scatterlist sg[2];

	char result[128];

	struct crypto_hash *tfm;

	struct hash_desc desc;

	struct crypto_ahash *tfm;

	struct ahash_request *req;

	

	tfm = crypto_alloc_hash("md5", 0, CRYPTO_ALG_ASYNC);

	tfm = crypto_alloc_ahash("md5", 0, CRYPTO_ALG_ASYNC);

	if (IS_ERR(tfm))

		fail();

		

	/* ... set up the scatterlists ... */



	desc.tfm = tfm;

	desc.flags = 0;

	req = ahash_request_alloc(tfm, GFP_ATOMIC);

	if (!req)

		fail();



	ahash_request_set_callback(req, 0, NULL, NULL);

	ahash_request_set_crypt(req, sg, result, 2);

	

	if (crypto_hash_digest(&desc, sg, 2, result))

	if (crypto_ahash_digest(req))

		fail();



	crypto_free_hash(tfm);

	ahash_request_free(req);

	crypto_free_ahash(tfm);



    

Many real examples are available in the regression test module (tcrypt.c).