xref: /linux/crypto/internal.h (revision d639d9fa162aadec1ae9980c4dcf6e50bd2f8290)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * Cryptographic API.
4  *
5  * Copyright (c) 2002 James Morris <jmorris@intercode.com.au>
6  * Copyright (c) 2005 Herbert Xu <herbert@gondor.apana.org.au>
7  */
8 #ifndef _CRYPTO_INTERNAL_H
9 #define _CRYPTO_INTERNAL_H
10 
11 #include <crypto/algapi.h>
12 #include <linux/completion.h>
13 #include <linux/jump_label.h>
14 #include <linux/list.h>
15 #include <linux/module.h>
16 #include <linux/notifier.h>
17 #include <linux/numa.h>
18 #include <linux/refcount.h>
19 #include <linux/rwsem.h>
20 #include <linux/scatterlist.h>
21 #include <linux/sched.h>
22 #include <linux/types.h>
23 
24 struct crypto_instance;
25 struct crypto_template;
26 
27 struct crypto_larval {
28 	struct crypto_alg alg;
29 	struct crypto_alg *adult;
30 	struct completion completion;
31 	u32 mask;
32 	bool test_started;
33 };
34 
35 struct crypto_type {
36 	unsigned int (*ctxsize)(struct crypto_alg *alg, u32 type, u32 mask);
37 	unsigned int (*extsize)(struct crypto_alg *alg);
38 	int (*init_tfm)(struct crypto_tfm *tfm);
39 	void (*show)(struct seq_file *m, struct crypto_alg *alg);
40 	int (*report)(struct sk_buff *skb, struct crypto_alg *alg);
41 	void (*free)(struct crypto_instance *inst);
42 	void (*destroy)(struct crypto_alg *alg);
43 
44 	unsigned int type;
45 	unsigned int maskclear;
46 	unsigned int maskset;
47 	unsigned int tfmsize;
48 	unsigned int algsize;
49 };
50 
51 enum {
52 	CRYPTOA_UNSPEC,
53 	CRYPTOA_ALG,
54 	CRYPTOA_TYPE,
55 	__CRYPTOA_MAX,
56 };
57 
58 #define CRYPTOA_MAX (__CRYPTOA_MAX - 1)
59 
60 /* Maximum number of (rtattr) parameters for each template. */
61 #define CRYPTO_MAX_ATTRS 32
62 
63 extern struct rw_semaphore crypto_alg_sem;
64 extern struct list_head crypto_alg_list __guarded_by(&crypto_alg_sem);
65 extern struct blocking_notifier_head crypto_chain;
66 
67 int alg_test(const char *driver, const char *alg, u32 type, u32 mask);
68 
69 #if !IS_BUILTIN(CONFIG_CRYPTO_ALGAPI) || !IS_ENABLED(CONFIG_CRYPTO_SELFTESTS)
70 static inline bool crypto_boot_test_finished(void)
71 {
72 	return true;
73 }
74 static inline void set_crypto_boot_test_finished(void)
75 {
76 }
77 #else
78 DECLARE_STATIC_KEY_FALSE(__crypto_boot_test_finished);
79 static inline bool crypto_boot_test_finished(void)
80 {
81 	return static_branch_likely(&__crypto_boot_test_finished);
82 }
83 static inline void set_crypto_boot_test_finished(void)
84 {
85 	static_branch_enable(&__crypto_boot_test_finished);
86 }
87 #endif /* !IS_BUILTIN(CONFIG_CRYPTO_ALGAPI) ||
88 	* !IS_ENABLED(CONFIG_CRYPTO_SELFTESTS)
89 	*/
90 
91 #ifdef CONFIG_PROC_FS
92 void __init crypto_init_proc(void);
93 void __exit crypto_exit_proc(void);
94 #else
95 static inline void crypto_init_proc(void)
96 { }
97 static inline void crypto_exit_proc(void)
98 { }
99 #endif
100 
101 static inline unsigned int crypto_cipher_ctxsize(struct crypto_alg *alg)
102 {
103 	return alg->cra_ctxsize;
104 }
105 
106 static inline unsigned int crypto_compress_ctxsize(struct crypto_alg *alg)
107 {
108 	return alg->cra_ctxsize;
109 }
110 
111 struct crypto_alg *crypto_mod_get(struct crypto_alg *alg);
112 struct crypto_alg *crypto_alg_mod_lookup(const char *name, u32 type, u32 mask);
113 
114 struct crypto_larval *crypto_larval_alloc(const char *name, u32 type, u32 mask);
115 void crypto_schedule_test(struct crypto_larval *larval);
116 void crypto_alg_tested(const char *name, int err);
117 
118 void crypto_remove_spawns(struct crypto_alg *alg, struct list_head *list,
119 			  struct crypto_alg *nalg);
120 void crypto_remove_final(struct list_head *list);
121 void crypto_shoot_alg(struct crypto_alg *alg);
122 struct crypto_tfm *__crypto_alloc_tfm(struct crypto_alg *alg, u32 type,
123 				      u32 mask);
124 void *crypto_create_tfm_node(struct crypto_alg *alg,
125 			const struct crypto_type *frontend, int node);
126 
127 static inline void *crypto_create_tfm(struct crypto_alg *alg,
128 			const struct crypto_type *frontend)
129 {
130 	return crypto_create_tfm_node(alg, frontend, NUMA_NO_NODE);
131 }
132 
133 struct crypto_alg *crypto_find_alg(const char *alg_name,
134 				   const struct crypto_type *frontend,
135 				   u32 type, u32 mask);
136 
137 void *crypto_alloc_tfm_node(const char *alg_name,
138 		       const struct crypto_type *frontend, u32 type, u32 mask,
139 		       int node);
140 
141 static inline void *crypto_alloc_tfm(const char *alg_name,
142 		       const struct crypto_type *frontend, u32 type, u32 mask)
143 {
144 	return crypto_alloc_tfm_node(alg_name, frontend, type, mask, NUMA_NO_NODE);
145 }
146 
147 int crypto_probing_notify(unsigned long val, void *v);
148 
149 unsigned int crypto_alg_extsize(struct crypto_alg *alg);
150 
151 int crypto_type_has_alg(const char *name, const struct crypto_type *frontend,
152 			u32 type, u32 mask);
153 
154 static inline struct crypto_alg *crypto_alg_get(struct crypto_alg *alg)
155 {
156 	refcount_inc(&alg->cra_refcnt);
157 	return alg;
158 }
159 
160 void crypto_destroy_alg(struct crypto_alg *alg);
161 
162 static inline void crypto_alg_put(struct crypto_alg *alg)
163 {
164 	if (refcount_dec_and_test(&alg->cra_refcnt))
165 		crypto_destroy_alg(alg);
166 }
167 
168 static inline int crypto_tmpl_get(struct crypto_template *tmpl)
169 {
170 	return try_module_get(tmpl->module);
171 }
172 
173 static inline void crypto_tmpl_put(struct crypto_template *tmpl)
174 {
175 	module_put(tmpl->module);
176 }
177 
178 static inline int crypto_is_larval(struct crypto_alg *alg)
179 {
180 	return alg->cra_flags & CRYPTO_ALG_LARVAL;
181 }
182 
183 static inline int crypto_is_dead(struct crypto_alg *alg)
184 {
185 	return alg->cra_flags & CRYPTO_ALG_DEAD;
186 }
187 
188 static inline int crypto_is_moribund(struct crypto_alg *alg)
189 {
190 	return alg->cra_flags & (CRYPTO_ALG_DEAD | CRYPTO_ALG_DYING);
191 }
192 
193 static inline void crypto_notify(unsigned long val, void *v)
194 {
195 	blocking_notifier_call_chain(&crypto_chain, val, v);
196 }
197 
198 static inline void crypto_yield(u32 flags)
199 {
200 	if (flags & CRYPTO_TFM_REQ_MAY_SLEEP)
201 		cond_resched();
202 }
203 
204 static inline int crypto_is_test_larval(struct crypto_larval *larval)
205 {
206 	return larval->alg.cra_driver_name[0];
207 }
208 
209 #endif	/* _CRYPTO_INTERNAL_H */
210 
211