Linux 6.14-rc1
[linux-stable.git] / crypto / algapi.c
blob5318c214debb0eaa960ee99ae9f8a6457af3b2ab
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * Cryptographic API for algorithms (i.e., low-level API).
5 * Copyright (c) 2006 Herbert Xu <herbert@gondor.apana.org.au>
6 */
8 #include <crypto/algapi.h>
9 #include <linux/err.h>
10 #include <linux/errno.h>
11 #include <linux/fips.h>
12 #include <linux/init.h>
13 #include <linux/kernel.h>
14 #include <linux/list.h>
15 #include <linux/module.h>
16 #include <linux/rtnetlink.h>
17 #include <linux/slab.h>
18 #include <linux/string.h>
19 #include <linux/workqueue.h>
21 #include "internal.h"
23 static LIST_HEAD(crypto_template_list);
25 static inline void crypto_check_module_sig(struct module *mod)
27 if (fips_enabled && mod && !module_sig_ok(mod))
28 panic("Module %s signature verification failed in FIPS mode\n",
29 module_name(mod));
32 static int crypto_check_alg(struct crypto_alg *alg)
34 crypto_check_module_sig(alg->cra_module);
36 if (!alg->cra_name[0] || !alg->cra_driver_name[0])
37 return -EINVAL;
39 if (alg->cra_alignmask & (alg->cra_alignmask + 1))
40 return -EINVAL;
42 /* General maximums for all algs. */
43 if (alg->cra_alignmask > MAX_ALGAPI_ALIGNMASK)
44 return -EINVAL;
46 if (alg->cra_blocksize > MAX_ALGAPI_BLOCKSIZE)
47 return -EINVAL;
49 /* Lower maximums for specific alg types. */
50 if (!alg->cra_type && (alg->cra_flags & CRYPTO_ALG_TYPE_MASK) ==
51 CRYPTO_ALG_TYPE_CIPHER) {
52 if (alg->cra_alignmask > MAX_CIPHER_ALIGNMASK)
53 return -EINVAL;
55 if (alg->cra_blocksize > MAX_CIPHER_BLOCKSIZE)
56 return -EINVAL;
59 if (alg->cra_priority < 0)
60 return -EINVAL;
62 refcount_set(&alg->cra_refcnt, 1);
64 return 0;
67 static void crypto_free_instance(struct crypto_instance *inst)
69 inst->alg.cra_type->free(inst);
72 static void crypto_destroy_instance_workfn(struct work_struct *w)
74 struct crypto_instance *inst = container_of(w, struct crypto_instance,
75 free_work);
76 struct crypto_template *tmpl = inst->tmpl;
78 crypto_free_instance(inst);
79 crypto_tmpl_put(tmpl);
82 static void crypto_destroy_instance(struct crypto_alg *alg)
84 struct crypto_instance *inst = container_of(alg,
85 struct crypto_instance,
86 alg);
88 INIT_WORK(&inst->free_work, crypto_destroy_instance_workfn);
89 schedule_work(&inst->free_work);
93 * This function adds a spawn to the list secondary_spawns which
94 * will be used at the end of crypto_remove_spawns to unregister
95 * instances, unless the spawn happens to be one that is depended
96 * on by the new algorithm (nalg in crypto_remove_spawns).
98 * This function is also responsible for resurrecting any algorithms
99 * in the dependency chain of nalg by unsetting n->dead.
101 static struct list_head *crypto_more_spawns(struct crypto_alg *alg,
102 struct list_head *stack,
103 struct list_head *top,
104 struct list_head *secondary_spawns)
106 struct crypto_spawn *spawn, *n;
108 spawn = list_first_entry_or_null(stack, struct crypto_spawn, list);
109 if (!spawn)
110 return NULL;
112 n = list_prev_entry(spawn, list);
113 list_move(&spawn->list, secondary_spawns);
115 if (list_is_last(&n->list, stack))
116 return top;
118 n = list_next_entry(n, list);
119 if (!spawn->dead)
120 n->dead = false;
122 return &n->inst->alg.cra_users;
125 static void crypto_remove_instance(struct crypto_instance *inst,
126 struct list_head *list)
128 struct crypto_template *tmpl = inst->tmpl;
130 if (crypto_is_dead(&inst->alg))
131 return;
133 inst->alg.cra_flags |= CRYPTO_ALG_DEAD;
135 if (!tmpl || !crypto_tmpl_get(tmpl))
136 return;
138 list_move(&inst->alg.cra_list, list);
139 hlist_del(&inst->list);
140 inst->alg.cra_destroy = crypto_destroy_instance;
142 BUG_ON(!list_empty(&inst->alg.cra_users));
146 * Given an algorithm alg, remove all algorithms that depend on it
147 * through spawns. If nalg is not null, then exempt any algorithms
148 * that is depended on by nalg. This is useful when nalg itself
149 * depends on alg.
151 void crypto_remove_spawns(struct crypto_alg *alg, struct list_head *list,
152 struct crypto_alg *nalg)
154 u32 new_type = (nalg ?: alg)->cra_flags;
155 struct crypto_spawn *spawn, *n;
156 LIST_HEAD(secondary_spawns);
157 struct list_head *spawns;
158 LIST_HEAD(stack);
159 LIST_HEAD(top);
161 spawns = &alg->cra_users;
162 list_for_each_entry_safe(spawn, n, spawns, list) {
163 if ((spawn->alg->cra_flags ^ new_type) & spawn->mask)
164 continue;
166 list_move(&spawn->list, &top);
170 * Perform a depth-first walk starting from alg through
171 * the cra_users tree. The list stack records the path
172 * from alg to the current spawn.
174 spawns = &top;
175 do {
176 while (!list_empty(spawns)) {
177 struct crypto_instance *inst;
179 spawn = list_first_entry(spawns, struct crypto_spawn,
180 list);
181 inst = spawn->inst;
183 list_move(&spawn->list, &stack);
184 spawn->dead = !spawn->registered || &inst->alg != nalg;
186 if (!spawn->registered)
187 break;
189 BUG_ON(&inst->alg == alg);
191 if (&inst->alg == nalg)
192 break;
194 spawns = &inst->alg.cra_users;
197 * Even if spawn->registered is true, the
198 * instance itself may still be unregistered.
199 * This is because it may have failed during
200 * registration. Therefore we still need to
201 * make the following test.
203 * We may encounter an unregistered instance here, since
204 * an instance's spawns are set up prior to the instance
205 * being registered. An unregistered instance will have
206 * NULL ->cra_users.next, since ->cra_users isn't
207 * properly initialized until registration. But an
208 * unregistered instance cannot have any users, so treat
209 * it the same as ->cra_users being empty.
211 if (spawns->next == NULL)
212 break;
214 } while ((spawns = crypto_more_spawns(alg, &stack, &top,
215 &secondary_spawns)));
218 * Remove all instances that are marked as dead. Also
219 * complete the resurrection of the others by moving them
220 * back to the cra_users list.
222 list_for_each_entry_safe(spawn, n, &secondary_spawns, list) {
223 if (!spawn->dead)
224 list_move(&spawn->list, &spawn->alg->cra_users);
225 else if (spawn->registered)
226 crypto_remove_instance(spawn->inst, list);
229 EXPORT_SYMBOL_GPL(crypto_remove_spawns);
231 static void crypto_alg_finish_registration(struct crypto_alg *alg,
232 struct list_head *algs_to_put)
234 struct crypto_alg *q;
236 list_for_each_entry(q, &crypto_alg_list, cra_list) {
237 if (q == alg)
238 continue;
240 if (crypto_is_moribund(q))
241 continue;
243 if (crypto_is_larval(q))
244 continue;
246 if (strcmp(alg->cra_name, q->cra_name))
247 continue;
249 if (strcmp(alg->cra_driver_name, q->cra_driver_name) &&
250 q->cra_priority > alg->cra_priority)
251 continue;
253 crypto_remove_spawns(q, algs_to_put, alg);
256 crypto_notify(CRYPTO_MSG_ALG_LOADED, alg);
259 static struct crypto_larval *crypto_alloc_test_larval(struct crypto_alg *alg)
261 struct crypto_larval *larval;
263 if (!IS_ENABLED(CONFIG_CRYPTO_MANAGER) ||
264 IS_ENABLED(CONFIG_CRYPTO_MANAGER_DISABLE_TESTS) ||
265 (alg->cra_flags & CRYPTO_ALG_INTERNAL))
266 return NULL; /* No self-test needed */
268 larval = crypto_larval_alloc(alg->cra_name,
269 alg->cra_flags | CRYPTO_ALG_TESTED, 0);
270 if (IS_ERR(larval))
271 return larval;
273 larval->adult = crypto_mod_get(alg);
274 if (!larval->adult) {
275 kfree(larval);
276 return ERR_PTR(-ENOENT);
279 refcount_set(&larval->alg.cra_refcnt, 1);
280 memcpy(larval->alg.cra_driver_name, alg->cra_driver_name,
281 CRYPTO_MAX_ALG_NAME);
282 larval->alg.cra_priority = alg->cra_priority;
284 return larval;
287 static struct crypto_larval *
288 __crypto_register_alg(struct crypto_alg *alg, struct list_head *algs_to_put)
290 struct crypto_alg *q;
291 struct crypto_larval *larval;
292 int ret = -EAGAIN;
294 if (crypto_is_dead(alg))
295 goto err;
297 INIT_LIST_HEAD(&alg->cra_users);
299 ret = -EEXIST;
301 list_for_each_entry(q, &crypto_alg_list, cra_list) {
302 if (q == alg)
303 goto err;
305 if (crypto_is_moribund(q))
306 continue;
308 if (crypto_is_larval(q)) {
309 if (!strcmp(alg->cra_driver_name, q->cra_driver_name))
310 goto err;
311 continue;
314 if (!strcmp(q->cra_driver_name, alg->cra_name) ||
315 !strcmp(q->cra_driver_name, alg->cra_driver_name) ||
316 !strcmp(q->cra_name, alg->cra_driver_name))
317 goto err;
320 larval = crypto_alloc_test_larval(alg);
321 if (IS_ERR(larval))
322 goto out;
324 list_add(&alg->cra_list, &crypto_alg_list);
326 if (larval) {
327 /* No cheating! */
328 alg->cra_flags &= ~CRYPTO_ALG_TESTED;
330 list_add(&larval->alg.cra_list, &crypto_alg_list);
331 } else {
332 alg->cra_flags |= CRYPTO_ALG_TESTED;
333 crypto_alg_finish_registration(alg, algs_to_put);
336 out:
337 return larval;
339 err:
340 larval = ERR_PTR(ret);
341 goto out;
344 void crypto_alg_tested(const char *name, int err)
346 struct crypto_larval *test;
347 struct crypto_alg *alg;
348 struct crypto_alg *q;
349 LIST_HEAD(list);
351 down_write(&crypto_alg_sem);
352 list_for_each_entry(q, &crypto_alg_list, cra_list) {
353 if (crypto_is_moribund(q) || !crypto_is_larval(q))
354 continue;
356 test = (struct crypto_larval *)q;
358 if (!strcmp(q->cra_driver_name, name))
359 goto found;
362 pr_err("alg: Unexpected test result for %s: %d\n", name, err);
363 up_write(&crypto_alg_sem);
364 return;
366 found:
367 q->cra_flags |= CRYPTO_ALG_DEAD;
368 alg = test->adult;
370 if (crypto_is_dead(alg))
371 goto complete;
373 if (err == -ECANCELED)
374 alg->cra_flags |= CRYPTO_ALG_FIPS_INTERNAL;
375 else if (err)
376 goto complete;
377 else
378 alg->cra_flags &= ~CRYPTO_ALG_FIPS_INTERNAL;
380 alg->cra_flags |= CRYPTO_ALG_TESTED;
382 crypto_alg_finish_registration(alg, &list);
384 complete:
385 list_del_init(&test->alg.cra_list);
386 complete_all(&test->completion);
388 up_write(&crypto_alg_sem);
390 crypto_alg_put(&test->alg);
391 crypto_remove_final(&list);
393 EXPORT_SYMBOL_GPL(crypto_alg_tested);
395 void crypto_remove_final(struct list_head *list)
397 struct crypto_alg *alg;
398 struct crypto_alg *n;
400 list_for_each_entry_safe(alg, n, list, cra_list) {
401 list_del_init(&alg->cra_list);
402 crypto_alg_put(alg);
405 EXPORT_SYMBOL_GPL(crypto_remove_final);
407 int crypto_register_alg(struct crypto_alg *alg)
409 struct crypto_larval *larval;
410 bool test_started = false;
411 LIST_HEAD(algs_to_put);
412 int err;
414 alg->cra_flags &= ~CRYPTO_ALG_DEAD;
415 err = crypto_check_alg(alg);
416 if (err)
417 return err;
419 down_write(&crypto_alg_sem);
420 larval = __crypto_register_alg(alg, &algs_to_put);
421 if (!IS_ERR_OR_NULL(larval)) {
422 test_started = crypto_boot_test_finished();
423 larval->test_started = test_started;
425 up_write(&crypto_alg_sem);
427 if (IS_ERR(larval))
428 return PTR_ERR(larval);
430 if (test_started)
431 crypto_schedule_test(larval);
432 else
433 crypto_remove_final(&algs_to_put);
435 return 0;
437 EXPORT_SYMBOL_GPL(crypto_register_alg);
439 static int crypto_remove_alg(struct crypto_alg *alg, struct list_head *list)
441 if (unlikely(list_empty(&alg->cra_list)))
442 return -ENOENT;
444 alg->cra_flags |= CRYPTO_ALG_DEAD;
446 list_del_init(&alg->cra_list);
447 crypto_remove_spawns(alg, list, NULL);
449 return 0;
452 void crypto_unregister_alg(struct crypto_alg *alg)
454 int ret;
455 LIST_HEAD(list);
457 down_write(&crypto_alg_sem);
458 ret = crypto_remove_alg(alg, &list);
459 up_write(&crypto_alg_sem);
461 if (WARN(ret, "Algorithm %s is not registered", alg->cra_driver_name))
462 return;
464 if (WARN_ON(refcount_read(&alg->cra_refcnt) != 1))
465 return;
467 if (alg->cra_destroy)
468 alg->cra_destroy(alg);
470 crypto_remove_final(&list);
472 EXPORT_SYMBOL_GPL(crypto_unregister_alg);
474 int crypto_register_algs(struct crypto_alg *algs, int count)
476 int i, ret;
478 for (i = 0; i < count; i++) {
479 ret = crypto_register_alg(&algs[i]);
480 if (ret)
481 goto err;
484 return 0;
486 err:
487 for (--i; i >= 0; --i)
488 crypto_unregister_alg(&algs[i]);
490 return ret;
492 EXPORT_SYMBOL_GPL(crypto_register_algs);
494 void crypto_unregister_algs(struct crypto_alg *algs, int count)
496 int i;
498 for (i = 0; i < count; i++)
499 crypto_unregister_alg(&algs[i]);
501 EXPORT_SYMBOL_GPL(crypto_unregister_algs);
503 int crypto_register_template(struct crypto_template *tmpl)
505 struct crypto_template *q;
506 int err = -EEXIST;
508 down_write(&crypto_alg_sem);
510 crypto_check_module_sig(tmpl->module);
512 list_for_each_entry(q, &crypto_template_list, list) {
513 if (q == tmpl)
514 goto out;
517 list_add(&tmpl->list, &crypto_template_list);
518 err = 0;
519 out:
520 up_write(&crypto_alg_sem);
521 return err;
523 EXPORT_SYMBOL_GPL(crypto_register_template);
525 int crypto_register_templates(struct crypto_template *tmpls, int count)
527 int i, err;
529 for (i = 0; i < count; i++) {
530 err = crypto_register_template(&tmpls[i]);
531 if (err)
532 goto out;
534 return 0;
536 out:
537 for (--i; i >= 0; --i)
538 crypto_unregister_template(&tmpls[i]);
539 return err;
541 EXPORT_SYMBOL_GPL(crypto_register_templates);
543 void crypto_unregister_template(struct crypto_template *tmpl)
545 struct crypto_instance *inst;
546 struct hlist_node *n;
547 struct hlist_head *list;
548 LIST_HEAD(users);
550 down_write(&crypto_alg_sem);
552 BUG_ON(list_empty(&tmpl->list));
553 list_del_init(&tmpl->list);
555 list = &tmpl->instances;
556 hlist_for_each_entry(inst, list, list) {
557 int err = crypto_remove_alg(&inst->alg, &users);
559 BUG_ON(err);
562 up_write(&crypto_alg_sem);
564 hlist_for_each_entry_safe(inst, n, list, list) {
565 BUG_ON(refcount_read(&inst->alg.cra_refcnt) != 1);
566 crypto_free_instance(inst);
568 crypto_remove_final(&users);
570 EXPORT_SYMBOL_GPL(crypto_unregister_template);
572 void crypto_unregister_templates(struct crypto_template *tmpls, int count)
574 int i;
576 for (i = count - 1; i >= 0; --i)
577 crypto_unregister_template(&tmpls[i]);
579 EXPORT_SYMBOL_GPL(crypto_unregister_templates);
581 static struct crypto_template *__crypto_lookup_template(const char *name)
583 struct crypto_template *q, *tmpl = NULL;
585 down_read(&crypto_alg_sem);
586 list_for_each_entry(q, &crypto_template_list, list) {
587 if (strcmp(q->name, name))
588 continue;
589 if (unlikely(!crypto_tmpl_get(q)))
590 continue;
592 tmpl = q;
593 break;
595 up_read(&crypto_alg_sem);
597 return tmpl;
600 struct crypto_template *crypto_lookup_template(const char *name)
602 return try_then_request_module(__crypto_lookup_template(name),
603 "crypto-%s", name);
605 EXPORT_SYMBOL_GPL(crypto_lookup_template);
607 int crypto_register_instance(struct crypto_template *tmpl,
608 struct crypto_instance *inst)
610 struct crypto_larval *larval;
611 struct crypto_spawn *spawn;
612 u32 fips_internal = 0;
613 LIST_HEAD(algs_to_put);
614 int err;
616 err = crypto_check_alg(&inst->alg);
617 if (err)
618 return err;
620 inst->alg.cra_module = tmpl->module;
621 inst->alg.cra_flags |= CRYPTO_ALG_INSTANCE;
623 down_write(&crypto_alg_sem);
625 larval = ERR_PTR(-EAGAIN);
626 for (spawn = inst->spawns; spawn;) {
627 struct crypto_spawn *next;
629 if (spawn->dead)
630 goto unlock;
632 next = spawn->next;
633 spawn->inst = inst;
634 spawn->registered = true;
636 fips_internal |= spawn->alg->cra_flags;
638 crypto_mod_put(spawn->alg);
640 spawn = next;
643 inst->alg.cra_flags |= (fips_internal & CRYPTO_ALG_FIPS_INTERNAL);
645 larval = __crypto_register_alg(&inst->alg, &algs_to_put);
646 if (IS_ERR(larval))
647 goto unlock;
648 else if (larval)
649 larval->test_started = true;
651 hlist_add_head(&inst->list, &tmpl->instances);
652 inst->tmpl = tmpl;
654 unlock:
655 up_write(&crypto_alg_sem);
657 if (IS_ERR(larval))
658 return PTR_ERR(larval);
660 if (larval)
661 crypto_schedule_test(larval);
662 else
663 crypto_remove_final(&algs_to_put);
665 return 0;
667 EXPORT_SYMBOL_GPL(crypto_register_instance);
669 void crypto_unregister_instance(struct crypto_instance *inst)
671 LIST_HEAD(list);
673 down_write(&crypto_alg_sem);
675 crypto_remove_spawns(&inst->alg, &list, NULL);
676 crypto_remove_instance(inst, &list);
678 up_write(&crypto_alg_sem);
680 crypto_remove_final(&list);
682 EXPORT_SYMBOL_GPL(crypto_unregister_instance);
684 int crypto_grab_spawn(struct crypto_spawn *spawn, struct crypto_instance *inst,
685 const char *name, u32 type, u32 mask)
687 struct crypto_alg *alg;
688 int err = -EAGAIN;
690 if (WARN_ON_ONCE(inst == NULL))
691 return -EINVAL;
693 /* Allow the result of crypto_attr_alg_name() to be passed directly */
694 if (IS_ERR(name))
695 return PTR_ERR(name);
697 alg = crypto_find_alg(name, spawn->frontend,
698 type | CRYPTO_ALG_FIPS_INTERNAL, mask);
699 if (IS_ERR(alg))
700 return PTR_ERR(alg);
702 down_write(&crypto_alg_sem);
703 if (!crypto_is_moribund(alg)) {
704 list_add(&spawn->list, &alg->cra_users);
705 spawn->alg = alg;
706 spawn->mask = mask;
707 spawn->next = inst->spawns;
708 inst->spawns = spawn;
709 inst->alg.cra_flags |=
710 (alg->cra_flags & CRYPTO_ALG_INHERITED_FLAGS);
711 err = 0;
713 up_write(&crypto_alg_sem);
714 if (err)
715 crypto_mod_put(alg);
716 return err;
718 EXPORT_SYMBOL_GPL(crypto_grab_spawn);
720 void crypto_drop_spawn(struct crypto_spawn *spawn)
722 if (!spawn->alg) /* not yet initialized? */
723 return;
725 down_write(&crypto_alg_sem);
726 if (!spawn->dead)
727 list_del(&spawn->list);
728 up_write(&crypto_alg_sem);
730 if (!spawn->registered)
731 crypto_mod_put(spawn->alg);
733 EXPORT_SYMBOL_GPL(crypto_drop_spawn);
735 static struct crypto_alg *crypto_spawn_alg(struct crypto_spawn *spawn)
737 struct crypto_alg *alg = ERR_PTR(-EAGAIN);
738 struct crypto_alg *target;
739 bool shoot = false;
741 down_read(&crypto_alg_sem);
742 if (!spawn->dead) {
743 alg = spawn->alg;
744 if (!crypto_mod_get(alg)) {
745 target = crypto_alg_get(alg);
746 shoot = true;
747 alg = ERR_PTR(-EAGAIN);
750 up_read(&crypto_alg_sem);
752 if (shoot) {
753 crypto_shoot_alg(target);
754 crypto_alg_put(target);
757 return alg;
760 struct crypto_tfm *crypto_spawn_tfm(struct crypto_spawn *spawn, u32 type,
761 u32 mask)
763 struct crypto_alg *alg;
764 struct crypto_tfm *tfm;
766 alg = crypto_spawn_alg(spawn);
767 if (IS_ERR(alg))
768 return ERR_CAST(alg);
770 tfm = ERR_PTR(-EINVAL);
771 if (unlikely((alg->cra_flags ^ type) & mask))
772 goto out_put_alg;
774 tfm = __crypto_alloc_tfm(alg, type, mask);
775 if (IS_ERR(tfm))
776 goto out_put_alg;
778 return tfm;
780 out_put_alg:
781 crypto_mod_put(alg);
782 return tfm;
784 EXPORT_SYMBOL_GPL(crypto_spawn_tfm);
786 void *crypto_spawn_tfm2(struct crypto_spawn *spawn)
788 struct crypto_alg *alg;
789 struct crypto_tfm *tfm;
791 alg = crypto_spawn_alg(spawn);
792 if (IS_ERR(alg))
793 return ERR_CAST(alg);
795 tfm = crypto_create_tfm(alg, spawn->frontend);
796 if (IS_ERR(tfm))
797 goto out_put_alg;
799 return tfm;
801 out_put_alg:
802 crypto_mod_put(alg);
803 return tfm;
805 EXPORT_SYMBOL_GPL(crypto_spawn_tfm2);
807 int crypto_register_notifier(struct notifier_block *nb)
809 return blocking_notifier_chain_register(&crypto_chain, nb);
811 EXPORT_SYMBOL_GPL(crypto_register_notifier);
813 int crypto_unregister_notifier(struct notifier_block *nb)
815 return blocking_notifier_chain_unregister(&crypto_chain, nb);
817 EXPORT_SYMBOL_GPL(crypto_unregister_notifier);
819 struct crypto_attr_type *crypto_get_attr_type(struct rtattr **tb)
821 struct rtattr *rta = tb[0];
822 struct crypto_attr_type *algt;
824 if (!rta)
825 return ERR_PTR(-ENOENT);
826 if (RTA_PAYLOAD(rta) < sizeof(*algt))
827 return ERR_PTR(-EINVAL);
828 if (rta->rta_type != CRYPTOA_TYPE)
829 return ERR_PTR(-EINVAL);
831 algt = RTA_DATA(rta);
833 return algt;
835 EXPORT_SYMBOL_GPL(crypto_get_attr_type);
838 * crypto_check_attr_type() - check algorithm type and compute inherited mask
839 * @tb: the template parameters
840 * @type: the algorithm type the template would be instantiated as
841 * @mask_ret: (output) the mask that should be passed to crypto_grab_*()
842 * to restrict the flags of any inner algorithms
844 * Validate that the algorithm type the user requested is compatible with the
845 * one the template would actually be instantiated as. E.g., if the user is
846 * doing crypto_alloc_shash("cbc(aes)", ...), this would return an error because
847 * the "cbc" template creates an "skcipher" algorithm, not an "shash" algorithm.
849 * Also compute the mask to use to restrict the flags of any inner algorithms.
851 * Return: 0 on success; -errno on failure
853 int crypto_check_attr_type(struct rtattr **tb, u32 type, u32 *mask_ret)
855 struct crypto_attr_type *algt;
857 algt = crypto_get_attr_type(tb);
858 if (IS_ERR(algt))
859 return PTR_ERR(algt);
861 if ((algt->type ^ type) & algt->mask)
862 return -EINVAL;
864 *mask_ret = crypto_algt_inherited_mask(algt);
865 return 0;
867 EXPORT_SYMBOL_GPL(crypto_check_attr_type);
869 const char *crypto_attr_alg_name(struct rtattr *rta)
871 struct crypto_attr_alg *alga;
873 if (!rta)
874 return ERR_PTR(-ENOENT);
875 if (RTA_PAYLOAD(rta) < sizeof(*alga))
876 return ERR_PTR(-EINVAL);
877 if (rta->rta_type != CRYPTOA_ALG)
878 return ERR_PTR(-EINVAL);
880 alga = RTA_DATA(rta);
881 alga->name[CRYPTO_MAX_ALG_NAME - 1] = 0;
883 return alga->name;
885 EXPORT_SYMBOL_GPL(crypto_attr_alg_name);
887 int crypto_inst_setname(struct crypto_instance *inst, const char *name,
888 struct crypto_alg *alg)
890 if (snprintf(inst->alg.cra_name, CRYPTO_MAX_ALG_NAME, "%s(%s)", name,
891 alg->cra_name) >= CRYPTO_MAX_ALG_NAME)
892 return -ENAMETOOLONG;
894 if (snprintf(inst->alg.cra_driver_name, CRYPTO_MAX_ALG_NAME, "%s(%s)",
895 name, alg->cra_driver_name) >= CRYPTO_MAX_ALG_NAME)
896 return -ENAMETOOLONG;
898 return 0;
900 EXPORT_SYMBOL_GPL(crypto_inst_setname);
902 void crypto_init_queue(struct crypto_queue *queue, unsigned int max_qlen)
904 INIT_LIST_HEAD(&queue->list);
905 queue->backlog = &queue->list;
906 queue->qlen = 0;
907 queue->max_qlen = max_qlen;
909 EXPORT_SYMBOL_GPL(crypto_init_queue);
911 int crypto_enqueue_request(struct crypto_queue *queue,
912 struct crypto_async_request *request)
914 int err = -EINPROGRESS;
916 if (unlikely(queue->qlen >= queue->max_qlen)) {
917 if (!(request->flags & CRYPTO_TFM_REQ_MAY_BACKLOG)) {
918 err = -ENOSPC;
919 goto out;
921 err = -EBUSY;
922 if (queue->backlog == &queue->list)
923 queue->backlog = &request->list;
926 queue->qlen++;
927 list_add_tail(&request->list, &queue->list);
929 out:
930 return err;
932 EXPORT_SYMBOL_GPL(crypto_enqueue_request);
934 void crypto_enqueue_request_head(struct crypto_queue *queue,
935 struct crypto_async_request *request)
937 if (unlikely(queue->qlen >= queue->max_qlen))
938 queue->backlog = queue->backlog->prev;
940 queue->qlen++;
941 list_add(&request->list, &queue->list);
943 EXPORT_SYMBOL_GPL(crypto_enqueue_request_head);
945 struct crypto_async_request *crypto_dequeue_request(struct crypto_queue *queue)
947 struct list_head *request;
949 if (unlikely(!queue->qlen))
950 return NULL;
952 queue->qlen--;
954 if (queue->backlog != &queue->list)
955 queue->backlog = queue->backlog->next;
957 request = queue->list.next;
958 list_del(request);
960 return list_entry(request, struct crypto_async_request, list);
962 EXPORT_SYMBOL_GPL(crypto_dequeue_request);
964 static inline void crypto_inc_byte(u8 *a, unsigned int size)
966 u8 *b = (a + size);
967 u8 c;
969 for (; size; size--) {
970 c = *--b + 1;
971 *b = c;
972 if (c)
973 break;
977 void crypto_inc(u8 *a, unsigned int size)
979 __be32 *b = (__be32 *)(a + size);
980 u32 c;
982 if (IS_ENABLED(CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS) ||
983 IS_ALIGNED((unsigned long)b, __alignof__(*b)))
984 for (; size >= 4; size -= 4) {
985 c = be32_to_cpu(*--b) + 1;
986 *b = cpu_to_be32(c);
987 if (likely(c))
988 return;
991 crypto_inc_byte(a, size);
993 EXPORT_SYMBOL_GPL(crypto_inc);
995 unsigned int crypto_alg_extsize(struct crypto_alg *alg)
997 return alg->cra_ctxsize +
998 (alg->cra_alignmask & ~(crypto_tfm_ctx_alignment() - 1));
1000 EXPORT_SYMBOL_GPL(crypto_alg_extsize);
1002 int crypto_type_has_alg(const char *name, const struct crypto_type *frontend,
1003 u32 type, u32 mask)
1005 int ret = 0;
1006 struct crypto_alg *alg = crypto_find_alg(name, frontend, type, mask);
1008 if (!IS_ERR(alg)) {
1009 crypto_mod_put(alg);
1010 ret = 1;
1013 return ret;
1015 EXPORT_SYMBOL_GPL(crypto_type_has_alg);
1017 static void __init crypto_start_tests(void)
1019 if (!IS_BUILTIN(CONFIG_CRYPTO_ALGAPI))
1020 return;
1022 if (IS_ENABLED(CONFIG_CRYPTO_MANAGER_DISABLE_TESTS))
1023 return;
1025 set_crypto_boot_test_finished();
1027 for (;;) {
1028 struct crypto_larval *larval = NULL;
1029 struct crypto_alg *q;
1031 down_write(&crypto_alg_sem);
1033 list_for_each_entry(q, &crypto_alg_list, cra_list) {
1034 struct crypto_larval *l;
1036 if (!crypto_is_larval(q))
1037 continue;
1039 l = (void *)q;
1041 if (!crypto_is_test_larval(l))
1042 continue;
1044 if (l->test_started)
1045 continue;
1047 l->test_started = true;
1048 larval = l;
1049 break;
1052 up_write(&crypto_alg_sem);
1054 if (!larval)
1055 break;
1057 crypto_schedule_test(larval);
1061 static int __init crypto_algapi_init(void)
1063 crypto_init_proc();
1064 crypto_start_tests();
1065 return 0;
1068 static void __exit crypto_algapi_exit(void)
1070 crypto_exit_proc();
1074 * We run this at late_initcall so that all the built-in algorithms
1075 * have had a chance to register themselves first.
1077 late_initcall(crypto_algapi_init);
1078 module_exit(crypto_algapi_exit);
1080 MODULE_LICENSE("GPL");
1081 MODULE_DESCRIPTION("Cryptographic algorithms API");
1082 MODULE_SOFTDEP("pre: cryptomgr");