xref: /linux/include/crypto/internal/hash.h (revision 9a14b311)
12874c5fdSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */
220036252SHerbert Xu /*
320036252SHerbert Xu  * Hash algorithms.
420036252SHerbert Xu  *
520036252SHerbert Xu  * Copyright (c) 2008 Herbert Xu <herbert@gondor.apana.org.au>
620036252SHerbert Xu  */
720036252SHerbert Xu 
820036252SHerbert Xu #ifndef _CRYPTO_INTERNAL_HASH_H
920036252SHerbert Xu #define _CRYPTO_INTERNAL_HASH_H
1020036252SHerbert Xu 
1120036252SHerbert Xu #include <crypto/algapi.h>
1218e33e6dSHerbert Xu #include <crypto/hash.h>
1320036252SHerbert Xu 
1420036252SHerbert Xu struct ahash_request;
1520036252SHerbert Xu struct scatterlist;
1620036252SHerbert Xu 
1720036252SHerbert Xu struct crypto_hash_walk {
1820036252SHerbert Xu 	char *data;
1920036252SHerbert Xu 
2020036252SHerbert Xu 	unsigned int offset;
21*c626910fSEric Biggers 	unsigned int flags;
2220036252SHerbert Xu 
2320036252SHerbert Xu 	struct page *pg;
2420036252SHerbert Xu 	unsigned int entrylen;
2520036252SHerbert Xu 
2620036252SHerbert Xu 	unsigned int total;
2720036252SHerbert Xu 	struct scatterlist *sg;
2820036252SHerbert Xu };
2920036252SHerbert Xu 
3001c2deceSHerbert Xu struct ahash_instance {
3148fb3e57SEric Biggers 	void (*free)(struct ahash_instance *inst);
3277f7e94dSEric Biggers 	union {
3377f7e94dSEric Biggers 		struct {
3477f7e94dSEric Biggers 			char head[offsetof(struct ahash_alg, halg.base)];
3577f7e94dSEric Biggers 			struct crypto_instance base;
3677f7e94dSEric Biggers 		} s;
3701c2deceSHerbert Xu 		struct ahash_alg alg;
3801c2deceSHerbert Xu 	};
3977f7e94dSEric Biggers };
4001c2deceSHerbert Xu 
412e4fddd8SHerbert Xu struct shash_instance {
4248fb3e57SEric Biggers 	void (*free)(struct shash_instance *inst);
431b84e7d0SEric Biggers 	union {
441b84e7d0SEric Biggers 		struct {
451b84e7d0SEric Biggers 			char head[offsetof(struct shash_alg, base)];
461b84e7d0SEric Biggers 			struct crypto_instance base;
471b84e7d0SEric Biggers 		} s;
482e4fddd8SHerbert Xu 		struct shash_alg alg;
492e4fddd8SHerbert Xu 	};
501b84e7d0SEric Biggers };
512e4fddd8SHerbert Xu 
5201c2deceSHerbert Xu struct crypto_ahash_spawn {
5301c2deceSHerbert Xu 	struct crypto_spawn base;
5401c2deceSHerbert Xu };
5501c2deceSHerbert Xu 
5694296999SHerbert Xu struct crypto_shash_spawn {
5794296999SHerbert Xu 	struct crypto_spawn base;
5894296999SHerbert Xu };
5994296999SHerbert Xu 
6020036252SHerbert Xu int crypto_hash_walk_done(struct crypto_hash_walk *walk, int err);
6120036252SHerbert Xu int crypto_hash_walk_first(struct ahash_request *req,
6220036252SHerbert Xu 			   struct crypto_hash_walk *walk);
6375ecb231SHerbert Xu 
crypto_hash_walk_last(struct crypto_hash_walk * walk)6466f6ce5eSHerbert Xu static inline int crypto_hash_walk_last(struct crypto_hash_walk *walk)
6566f6ce5eSHerbert Xu {
6666f6ce5eSHerbert Xu 	return !(walk->entrylen | walk->total);
6766f6ce5eSHerbert Xu }
6866f6ce5eSHerbert Xu 
6988056ec3SHerbert Xu int crypto_register_ahash(struct ahash_alg *alg);
70c6d633a9SEric Biggers void crypto_unregister_ahash(struct ahash_alg *alg);
716f7473c5SRabin Vincent int crypto_register_ahashes(struct ahash_alg *algs, int count);
726f7473c5SRabin Vincent void crypto_unregister_ahashes(struct ahash_alg *algs, int count);
7301c2deceSHerbert Xu int ahash_register_instance(struct crypto_template *tmpl,
7401c2deceSHerbert Xu 			    struct ahash_instance *inst);
7501c2deceSHerbert Xu 
76c060e16dSEric Biggers int shash_no_setkey(struct crypto_shash *tfm, const u8 *key,
77c060e16dSEric Biggers 		    unsigned int keylen);
78c060e16dSEric Biggers 
crypto_shash_alg_has_setkey(struct shash_alg * alg)79c060e16dSEric Biggers static inline bool crypto_shash_alg_has_setkey(struct shash_alg *alg)
80c060e16dSEric Biggers {
81c060e16dSEric Biggers 	return alg->setkey != shash_no_setkey;
82c060e16dSEric Biggers }
83af3ff804SEric Biggers 
crypto_shash_alg_needs_key(struct shash_alg * alg)84c2881789SEric Biggers static inline bool crypto_shash_alg_needs_key(struct shash_alg *alg)
85c2881789SEric Biggers {
86c2881789SEric Biggers 	return crypto_shash_alg_has_setkey(alg) &&
87c2881789SEric Biggers 		!(alg->base.cra_flags & CRYPTO_ALG_OPTIONAL_KEY);
88c2881789SEric Biggers }
89c2881789SEric Biggers 
9084a9c938SEric Biggers int crypto_grab_ahash(struct crypto_ahash_spawn *spawn,
9184a9c938SEric Biggers 		      struct crypto_instance *inst,
9284a9c938SEric Biggers 		      const char *name, u32 type, u32 mask);
9384a9c938SEric Biggers 
crypto_drop_ahash(struct crypto_ahash_spawn * spawn)9452861c7cSHerbert Xu static inline void crypto_drop_ahash(struct crypto_ahash_spawn *spawn)
9552861c7cSHerbert Xu {
9652861c7cSHerbert Xu 	crypto_drop_spawn(&spawn->base);
9752861c7cSHerbert Xu }
9852861c7cSHerbert Xu 
crypto_spawn_ahash_alg(struct crypto_ahash_spawn * spawn)9984a9c938SEric Biggers static inline struct hash_alg_common *crypto_spawn_ahash_alg(
10084a9c938SEric Biggers 	struct crypto_ahash_spawn *spawn)
10184a9c938SEric Biggers {
10284a9c938SEric Biggers 	return __crypto_hash_alg_common(spawn->base.alg);
10384a9c938SEric Biggers }
10484a9c938SEric Biggers 
1057b5a080bSHerbert Xu int crypto_register_shash(struct shash_alg *alg);
106c6d633a9SEric Biggers void crypto_unregister_shash(struct shash_alg *alg);
10750fc3e8dSJussi Kivilinna int crypto_register_shashes(struct shash_alg *algs, int count);
108c6d633a9SEric Biggers void crypto_unregister_shashes(struct shash_alg *algs, int count);
109619a6ebdSHerbert Xu int shash_register_instance(struct crypto_template *tmpl,
110619a6ebdSHerbert Xu 			    struct shash_instance *inst);
111a39c66ccSEric Biggers void shash_free_singlespawn_instance(struct shash_instance *inst);
1122e4fddd8SHerbert Xu 
113fdfad1ffSEric Biggers int crypto_grab_shash(struct crypto_shash_spawn *spawn,
114fdfad1ffSEric Biggers 		      struct crypto_instance *inst,
115fdfad1ffSEric Biggers 		      const char *name, u32 type, u32 mask);
116fdfad1ffSEric Biggers 
crypto_drop_shash(struct crypto_shash_spawn * spawn)11752861c7cSHerbert Xu static inline void crypto_drop_shash(struct crypto_shash_spawn *spawn)
11852861c7cSHerbert Xu {
11952861c7cSHerbert Xu 	crypto_drop_spawn(&spawn->base);
12052861c7cSHerbert Xu }
12152861c7cSHerbert Xu 
crypto_spawn_shash_alg(struct crypto_shash_spawn * spawn)122fdfad1ffSEric Biggers static inline struct shash_alg *crypto_spawn_shash_alg(
123fdfad1ffSEric Biggers 	struct crypto_shash_spawn *spawn)
124fdfad1ffSEric Biggers {
125fdfad1ffSEric Biggers 	return __crypto_shash_alg(spawn->base.alg);
126fdfad1ffSEric Biggers }
127fdfad1ffSEric Biggers 
1287eddf95eSHerbert Xu int shash_ahash_update(struct ahash_request *req, struct shash_desc *desc);
12966f6ce5eSHerbert Xu int shash_ahash_finup(struct ahash_request *req, struct shash_desc *desc);
1307eddf95eSHerbert Xu int shash_ahash_digest(struct ahash_request *req, struct shash_desc *desc);
1317eddf95eSHerbert Xu 
crypto_ahash_ctx(struct crypto_ahash * tfm)13218e33e6dSHerbert Xu static inline void *crypto_ahash_ctx(struct crypto_ahash *tfm)
13318e33e6dSHerbert Xu {
13488056ec3SHerbert Xu 	return crypto_tfm_ctx(crypto_ahash_tfm(tfm));
13518e33e6dSHerbert Xu }
13618e33e6dSHerbert Xu 
crypto_ahash_ctx_dma(struct crypto_ahash * tfm)137b5f755fbSHerbert Xu static inline void *crypto_ahash_ctx_dma(struct crypto_ahash *tfm)
138b5f755fbSHerbert Xu {
139b5f755fbSHerbert Xu 	return crypto_tfm_ctx_dma(crypto_ahash_tfm(tfm));
140b5f755fbSHerbert Xu }
141b5f755fbSHerbert Xu 
__crypto_ahash_alg(struct crypto_alg * alg)1424dc10c01SHerbert Xu static inline struct ahash_alg *__crypto_ahash_alg(struct crypto_alg *alg)
1434dc10c01SHerbert Xu {
1444dc10c01SHerbert Xu 	return container_of(__crypto_hash_alg_common(alg), struct ahash_alg,
1454dc10c01SHerbert Xu 			    halg);
1464dc10c01SHerbert Xu }
1474dc10c01SHerbert Xu 
crypto_ahash_alg(struct crypto_ahash * hash)1483908edf8SHerbert Xu static inline struct ahash_alg *crypto_ahash_alg(struct crypto_ahash *hash)
1493908edf8SHerbert Xu {
1503908edf8SHerbert Xu 	return container_of(crypto_hash_alg_common(hash), struct ahash_alg,
1513908edf8SHerbert Xu 			    halg);
1523908edf8SHerbert Xu }
1533908edf8SHerbert Xu 
crypto_ahash_set_statesize(struct crypto_ahash * tfm,unsigned int size)154c7535fb2SHerbert Xu static inline void crypto_ahash_set_statesize(struct crypto_ahash *tfm,
155c7535fb2SHerbert Xu 					      unsigned int size)
156c7535fb2SHerbert Xu {
157c7535fb2SHerbert Xu 	tfm->statesize = size;
158c7535fb2SHerbert Xu }
159c7535fb2SHerbert Xu 
crypto_ahash_set_reqsize(struct crypto_ahash * tfm,unsigned int reqsize)160fc00127fSHerbert Xu static inline void crypto_ahash_set_reqsize(struct crypto_ahash *tfm,
161fc00127fSHerbert Xu 					    unsigned int reqsize)
162fc00127fSHerbert Xu {
16388056ec3SHerbert Xu 	tfm->reqsize = reqsize;
164fc00127fSHerbert Xu }
165fc00127fSHerbert Xu 
crypto_ahash_set_reqsize_dma(struct crypto_ahash * ahash,unsigned int reqsize)166b5f755fbSHerbert Xu static inline void crypto_ahash_set_reqsize_dma(struct crypto_ahash *ahash,
167b5f755fbSHerbert Xu 						unsigned int reqsize)
168b5f755fbSHerbert Xu {
169b5f755fbSHerbert Xu 	reqsize += crypto_dma_align() & ~(crypto_tfm_ctx_alignment() - 1);
170b5f755fbSHerbert Xu 	ahash->reqsize = reqsize;
171b5f755fbSHerbert Xu }
172b5f755fbSHerbert Xu 
ahash_crypto_instance(struct ahash_instance * inst)17301c2deceSHerbert Xu static inline struct crypto_instance *ahash_crypto_instance(
17401c2deceSHerbert Xu 	struct ahash_instance *inst)
17501c2deceSHerbert Xu {
17677f7e94dSEric Biggers 	return &inst->s.base;
17701c2deceSHerbert Xu }
17801c2deceSHerbert Xu 
ahash_instance(struct crypto_instance * inst)17901c2deceSHerbert Xu static inline struct ahash_instance *ahash_instance(
18001c2deceSHerbert Xu 	struct crypto_instance *inst)
18101c2deceSHerbert Xu {
18277f7e94dSEric Biggers 	return container_of(inst, struct ahash_instance, s.base);
18301c2deceSHerbert Xu }
18401c2deceSHerbert Xu 
ahash_alg_instance(struct crypto_ahash * ahash)185b00ba76aSHerbert Xu static inline struct ahash_instance *ahash_alg_instance(
186b00ba76aSHerbert Xu 	struct crypto_ahash *ahash)
187b00ba76aSHerbert Xu {
188b00ba76aSHerbert Xu 	return ahash_instance(crypto_tfm_alg_instance(&ahash->base));
189b00ba76aSHerbert Xu }
190b00ba76aSHerbert Xu 
ahash_instance_ctx(struct ahash_instance * inst)19101c2deceSHerbert Xu static inline void *ahash_instance_ctx(struct ahash_instance *inst)
19201c2deceSHerbert Xu {
19301c2deceSHerbert Xu 	return crypto_instance_ctx(ahash_crypto_instance(inst));
19401c2deceSHerbert Xu }
19501c2deceSHerbert Xu 
ahash_request_ctx_dma(struct ahash_request * req)196b5f755fbSHerbert Xu static inline void *ahash_request_ctx_dma(struct ahash_request *req)
197b5f755fbSHerbert Xu {
198b5f755fbSHerbert Xu 	unsigned int align = crypto_dma_align();
199b5f755fbSHerbert Xu 
200b5f755fbSHerbert Xu 	if (align <= crypto_tfm_ctx_alignment())
201b5f755fbSHerbert Xu 		align = 1;
202b5f755fbSHerbert Xu 
203b5f755fbSHerbert Xu 	return PTR_ALIGN(ahash_request_ctx(req), align);
204b5f755fbSHerbert Xu }
205b5f755fbSHerbert Xu 
ahash_request_complete(struct ahash_request * req,int err)206ef0579b6SHerbert Xu static inline void ahash_request_complete(struct ahash_request *req, int err)
207ef0579b6SHerbert Xu {
208d9588045SHerbert Xu 	crypto_request_complete(&req->base, err);
209ef0579b6SHerbert Xu }
210ef0579b6SHerbert Xu 
ahash_request_flags(struct ahash_request * req)211ef0579b6SHerbert Xu static inline u32 ahash_request_flags(struct ahash_request *req)
212ef0579b6SHerbert Xu {
213ef0579b6SHerbert Xu 	return req->base.flags;
214ef0579b6SHerbert Xu }
215ef0579b6SHerbert Xu 
crypto_spawn_ahash(struct crypto_ahash_spawn * spawn)21601c2deceSHerbert Xu static inline struct crypto_ahash *crypto_spawn_ahash(
21701c2deceSHerbert Xu 	struct crypto_ahash_spawn *spawn)
21801c2deceSHerbert Xu {
21901c2deceSHerbert Xu 	return crypto_spawn_tfm2(&spawn->base);
22001c2deceSHerbert Xu }
22101c2deceSHerbert Xu 
ahash_enqueue_request(struct crypto_queue * queue,struct ahash_request * request)22218e33e6dSHerbert Xu static inline int ahash_enqueue_request(struct crypto_queue *queue,
22318e33e6dSHerbert Xu 					     struct ahash_request *request)
22418e33e6dSHerbert Xu {
22518e33e6dSHerbert Xu 	return crypto_enqueue_request(queue, &request->base);
22618e33e6dSHerbert Xu }
22718e33e6dSHerbert Xu 
ahash_dequeue_request(struct crypto_queue * queue)22818e33e6dSHerbert Xu static inline struct ahash_request *ahash_dequeue_request(
22918e33e6dSHerbert Xu 	struct crypto_queue *queue)
23018e33e6dSHerbert Xu {
23118e33e6dSHerbert Xu 	return ahash_request_cast(crypto_dequeue_request(queue));
23218e33e6dSHerbert Xu }
23318e33e6dSHerbert Xu 
crypto_shash_ctx(struct crypto_shash * tfm)2347b5a080bSHerbert Xu static inline void *crypto_shash_ctx(struct crypto_shash *tfm)
2357b5a080bSHerbert Xu {
2367b5a080bSHerbert Xu 	return crypto_tfm_ctx(&tfm->base);
2377b5a080bSHerbert Xu }
2387b5a080bSHerbert Xu 
shash_crypto_instance(struct shash_instance * inst)2392e4fddd8SHerbert Xu static inline struct crypto_instance *shash_crypto_instance(
2402e4fddd8SHerbert Xu 	struct shash_instance *inst)
2412e4fddd8SHerbert Xu {
2421b84e7d0SEric Biggers 	return &inst->s.base;
2432e4fddd8SHerbert Xu }
2442e4fddd8SHerbert Xu 
shash_instance(struct crypto_instance * inst)2452e4fddd8SHerbert Xu static inline struct shash_instance *shash_instance(
2462e4fddd8SHerbert Xu 	struct crypto_instance *inst)
2472e4fddd8SHerbert Xu {
2481b84e7d0SEric Biggers 	return container_of(inst, struct shash_instance, s.base);
2492e4fddd8SHerbert Xu }
2502e4fddd8SHerbert Xu 
shash_alg_instance(struct crypto_shash * shash)251d9e1670bSHerbert Xu static inline struct shash_instance *shash_alg_instance(
252d9e1670bSHerbert Xu 	struct crypto_shash *shash)
253d9e1670bSHerbert Xu {
254d9e1670bSHerbert Xu 	return shash_instance(crypto_tfm_alg_instance(&shash->base));
255d9e1670bSHerbert Xu }
256d9e1670bSHerbert Xu 
shash_instance_ctx(struct shash_instance * inst)257ef5d590cSHerbert Xu static inline void *shash_instance_ctx(struct shash_instance *inst)
258ef5d590cSHerbert Xu {
259ef5d590cSHerbert Xu 	return crypto_instance_ctx(shash_crypto_instance(inst));
260ef5d590cSHerbert Xu }
261ef5d590cSHerbert Xu 
crypto_spawn_shash(struct crypto_shash_spawn * spawn)26294296999SHerbert Xu static inline struct crypto_shash *crypto_spawn_shash(
26394296999SHerbert Xu 	struct crypto_shash_spawn *spawn)
26494296999SHerbert Xu {
26594296999SHerbert Xu 	return crypto_spawn_tfm2(&spawn->base);
26694296999SHerbert Xu }
26794296999SHerbert Xu 
__crypto_shash_cast(struct crypto_tfm * tfm)2680390e6aeSHerbert Xu static inline struct crypto_shash *__crypto_shash_cast(struct crypto_tfm *tfm)
2690390e6aeSHerbert Xu {
270113adefcSHerbert Xu 	return container_of(tfm, struct crypto_shash, base);
2710390e6aeSHerbert Xu }
2720390e6aeSHerbert Xu 
27320036252SHerbert Xu #endif	/* _CRYPTO_INTERNAL_HASH_H */
27420036252SHerbert Xu 
275