2 * Cryptographic API for algorithms (i.e., low-level API).
4 * Copyright (c) 2006 Herbert Xu <herbert@gondor.apana.org.au>
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the Free
8 * Software Foundation; either version 2 of the License, or (at your option)
13 #include <linux/err.h>
14 #include <linux/errno.h>
15 #include <linux/init.h>
16 #include <linux/kernel.h>
17 #include <linux/list.h>
18 #include <linux/module.h>
19 #include <linux/rtnetlink.h>
20 #include <linux/slab.h>
21 #include <linux/string.h>
25 static LIST_HEAD(crypto_template_list);
27 static inline int crypto_set_driver_name(struct crypto_alg *alg)
29 static const char suffix[] = "-generic";
30 char *driver_name = alg->cra_driver_name;
36 len = strlcpy(driver_name, alg->cra_name, CRYPTO_MAX_ALG_NAME);
37 if (len + sizeof(suffix) > CRYPTO_MAX_ALG_NAME)
40 memcpy(driver_name + len, suffix, sizeof(suffix));
44 static int crypto_check_alg(struct crypto_alg *alg)
46 if (alg->cra_alignmask & (alg->cra_alignmask + 1))
49 if (alg->cra_blocksize > PAGE_SIZE / 8)
52 if (alg->cra_priority < 0)
55 return crypto_set_driver_name(alg);
58 static void crypto_destroy_instance(struct crypto_alg *alg)
60 struct crypto_instance *inst = (void *)alg;
61 struct crypto_template *tmpl = inst->tmpl;
64 crypto_tmpl_put(tmpl);
67 static struct list_head *crypto_more_spawns(struct crypto_alg *alg,
68 struct list_head *stack,
69 struct list_head *top,
70 struct list_head *secondary_spawns)
72 struct crypto_spawn *spawn, *n;
74 if (list_empty(stack))
77 spawn = list_first_entry(stack, struct crypto_spawn, list);
78 n = list_entry(spawn->list.next, struct crypto_spawn, list);
80 if (spawn->alg && &n->list != stack && !n->alg)
81 n->alg = (n->list.next == stack) ? alg :
82 &list_entry(n->list.next, struct crypto_spawn,
85 list_move(&spawn->list, secondary_spawns);
87 return &n->list == stack ? top : &n->inst->alg.cra_users;
90 static void crypto_remove_spawn(struct crypto_spawn *spawn,
91 struct list_head *list)
93 struct crypto_instance *inst = spawn->inst;
94 struct crypto_template *tmpl = inst->tmpl;
96 if (crypto_is_dead(&inst->alg))
99 inst->alg.cra_flags |= CRYPTO_ALG_DEAD;
100 if (hlist_unhashed(&inst->list))
103 if (!tmpl || !crypto_tmpl_get(tmpl))
106 crypto_notify(CRYPTO_MSG_ALG_UNREGISTER, &inst->alg);
107 list_move(&inst->alg.cra_list, list);
108 hlist_del(&inst->list);
109 inst->alg.cra_destroy = crypto_destroy_instance;
111 BUG_ON(!list_empty(&inst->alg.cra_users));
114 void crypto_remove_spawns(struct crypto_alg *alg, struct list_head *list,
115 struct crypto_alg *nalg)
117 u32 new_type = (nalg ?: alg)->cra_flags;
118 struct crypto_spawn *spawn, *n;
119 LIST_HEAD(secondary_spawns);
120 struct list_head *spawns;
124 spawns = &alg->cra_users;
125 list_for_each_entry_safe(spawn, n, spawns, list) {
126 if ((spawn->alg->cra_flags ^ new_type) & spawn->mask)
129 list_move(&spawn->list, &top);
134 while (!list_empty(spawns)) {
135 struct crypto_instance *inst;
137 spawn = list_first_entry(spawns, struct crypto_spawn,
141 BUG_ON(&inst->alg == alg);
143 list_move(&spawn->list, &stack);
145 if (&inst->alg == nalg)
149 spawns = &inst->alg.cra_users;
151 } while ((spawns = crypto_more_spawns(alg, &stack, &top,
152 &secondary_spawns)));
154 list_for_each_entry_safe(spawn, n, &secondary_spawns, list) {
156 list_move(&spawn->list, &spawn->alg->cra_users);
158 crypto_remove_spawn(spawn, list);
161 EXPORT_SYMBOL_GPL(crypto_remove_spawns);
163 static struct crypto_larval *__crypto_register_alg(struct crypto_alg *alg)
165 struct crypto_alg *q;
166 struct crypto_larval *larval;
169 if (crypto_is_dead(alg))
172 INIT_LIST_HEAD(&alg->cra_users);
175 alg->cra_flags &= ~CRYPTO_ALG_TESTED;
179 atomic_set(&alg->cra_refcnt, 1);
180 list_for_each_entry(q, &crypto_alg_list, cra_list) {
184 if (crypto_is_moribund(q))
187 if (crypto_is_larval(q)) {
188 if (!strcmp(alg->cra_driver_name, q->cra_driver_name))
193 if (!strcmp(q->cra_driver_name, alg->cra_name) ||
194 !strcmp(q->cra_name, alg->cra_driver_name))
198 larval = crypto_larval_alloc(alg->cra_name,
199 alg->cra_flags | CRYPTO_ALG_TESTED, 0);
204 larval->adult = crypto_mod_get(alg);
208 atomic_set(&larval->alg.cra_refcnt, 1);
209 memcpy(larval->alg.cra_driver_name, alg->cra_driver_name,
210 CRYPTO_MAX_ALG_NAME);
211 larval->alg.cra_priority = alg->cra_priority;
213 list_add(&alg->cra_list, &crypto_alg_list);
214 list_add(&larval->alg.cra_list, &crypto_alg_list);
222 larval = ERR_PTR(ret);
226 void crypto_alg_tested(const char *name, int err)
228 struct crypto_larval *test;
229 struct crypto_alg *alg;
230 struct crypto_alg *q;
233 down_write(&crypto_alg_sem);
234 list_for_each_entry(q, &crypto_alg_list, cra_list) {
235 if (crypto_is_moribund(q) || !crypto_is_larval(q))
238 test = (struct crypto_larval *)q;
240 if (!strcmp(q->cra_driver_name, name))
244 printk(KERN_ERR "alg: Unexpected test result for %s: %d\n", name, err);
248 q->cra_flags |= CRYPTO_ALG_DEAD;
250 if (err || list_empty(&alg->cra_list))
253 alg->cra_flags |= CRYPTO_ALG_TESTED;
255 list_for_each_entry(q, &crypto_alg_list, cra_list) {
259 if (crypto_is_moribund(q))
262 if (crypto_is_larval(q)) {
263 struct crypto_larval *larval = (void *)q;
266 * Check to see if either our generic name or
267 * specific name can satisfy the name requested
268 * by the larval entry q.
270 if (strcmp(alg->cra_name, q->cra_name) &&
271 strcmp(alg->cra_driver_name, q->cra_name))
276 if ((q->cra_flags ^ alg->cra_flags) & larval->mask)
278 if (!crypto_mod_get(alg))
285 if (strcmp(alg->cra_name, q->cra_name))
288 if (strcmp(alg->cra_driver_name, q->cra_driver_name) &&
289 q->cra_priority > alg->cra_priority)
292 crypto_remove_spawns(q, &list, alg);
296 complete_all(&test->completion);
299 up_write(&crypto_alg_sem);
301 crypto_remove_final(&list);
303 EXPORT_SYMBOL_GPL(crypto_alg_tested);
305 void crypto_remove_final(struct list_head *list)
307 struct crypto_alg *alg;
308 struct crypto_alg *n;
310 list_for_each_entry_safe(alg, n, list, cra_list) {
311 list_del_init(&alg->cra_list);
315 EXPORT_SYMBOL_GPL(crypto_remove_final);
317 static void crypto_wait_for_test(struct crypto_larval *larval)
321 err = crypto_probing_notify(CRYPTO_MSG_ALG_REGISTER, larval->adult);
322 if (err != NOTIFY_STOP) {
323 if (WARN_ON(err != NOTIFY_DONE))
325 crypto_alg_tested(larval->alg.cra_driver_name, 0);
328 err = wait_for_completion_interruptible(&larval->completion);
332 crypto_larval_kill(&larval->alg);
335 int crypto_register_alg(struct crypto_alg *alg)
337 struct crypto_larval *larval;
340 err = crypto_check_alg(alg);
344 down_write(&crypto_alg_sem);
345 larval = __crypto_register_alg(alg);
346 up_write(&crypto_alg_sem);
349 return PTR_ERR(larval);
351 crypto_wait_for_test(larval);
354 EXPORT_SYMBOL_GPL(crypto_register_alg);
356 static int crypto_remove_alg(struct crypto_alg *alg, struct list_head *list)
358 if (unlikely(list_empty(&alg->cra_list)))
361 alg->cra_flags |= CRYPTO_ALG_DEAD;
363 crypto_notify(CRYPTO_MSG_ALG_UNREGISTER, alg);
364 list_del_init(&alg->cra_list);
365 crypto_remove_spawns(alg, list, NULL);
370 int crypto_unregister_alg(struct crypto_alg *alg)
375 down_write(&crypto_alg_sem);
376 ret = crypto_remove_alg(alg, &list);
377 up_write(&crypto_alg_sem);
382 BUG_ON(atomic_read(&alg->cra_refcnt) != 1);
383 if (alg->cra_destroy)
384 alg->cra_destroy(alg);
386 crypto_remove_final(&list);
389 EXPORT_SYMBOL_GPL(crypto_unregister_alg);
391 int crypto_register_algs(struct crypto_alg *algs, int count)
395 for (i = 0; i < count; i++) {
396 ret = crypto_register_alg(&algs[i]);
404 for (--i; i >= 0; --i)
405 crypto_unregister_alg(&algs[i]);
409 EXPORT_SYMBOL_GPL(crypto_register_algs);
411 int crypto_unregister_algs(struct crypto_alg *algs, int count)
415 for (i = 0; i < count; i++) {
416 ret = crypto_unregister_alg(&algs[i]);
418 pr_err("Failed to unregister %s %s: %d\n",
419 algs[i].cra_driver_name, algs[i].cra_name, ret);
424 EXPORT_SYMBOL_GPL(crypto_unregister_algs);
426 int crypto_register_template(struct crypto_template *tmpl)
428 struct crypto_template *q;
431 down_write(&crypto_alg_sem);
433 list_for_each_entry(q, &crypto_template_list, list) {
438 list_add(&tmpl->list, &crypto_template_list);
439 crypto_notify(CRYPTO_MSG_TMPL_REGISTER, tmpl);
442 up_write(&crypto_alg_sem);
445 EXPORT_SYMBOL_GPL(crypto_register_template);
447 void crypto_unregister_template(struct crypto_template *tmpl)
449 struct crypto_instance *inst;
450 struct hlist_node *p, *n;
451 struct hlist_head *list;
454 down_write(&crypto_alg_sem);
456 BUG_ON(list_empty(&tmpl->list));
457 list_del_init(&tmpl->list);
459 list = &tmpl->instances;
460 hlist_for_each_entry(inst, p, list, list) {
461 int err = crypto_remove_alg(&inst->alg, &users);
465 crypto_notify(CRYPTO_MSG_TMPL_UNREGISTER, tmpl);
467 up_write(&crypto_alg_sem);
469 hlist_for_each_entry_safe(inst, p, n, list, list) {
470 BUG_ON(atomic_read(&inst->alg.cra_refcnt) != 1);
473 crypto_remove_final(&users);
475 EXPORT_SYMBOL_GPL(crypto_unregister_template);
477 static struct crypto_template *__crypto_lookup_template(const char *name)
479 struct crypto_template *q, *tmpl = NULL;
481 down_read(&crypto_alg_sem);
482 list_for_each_entry(q, &crypto_template_list, list) {
483 if (strcmp(q->name, name))
485 if (unlikely(!crypto_tmpl_get(q)))
491 up_read(&crypto_alg_sem);
496 struct crypto_template *crypto_lookup_template(const char *name)
498 return try_then_request_module(__crypto_lookup_template(name), name);
500 EXPORT_SYMBOL_GPL(crypto_lookup_template);
502 int crypto_register_instance(struct crypto_template *tmpl,
503 struct crypto_instance *inst)
505 struct crypto_larval *larval;
508 err = crypto_check_alg(&inst->alg);
512 inst->alg.cra_module = tmpl->module;
513 inst->alg.cra_flags |= CRYPTO_ALG_INSTANCE;
515 down_write(&crypto_alg_sem);
517 larval = __crypto_register_alg(&inst->alg);
521 hlist_add_head(&inst->list, &tmpl->instances);
525 up_write(&crypto_alg_sem);
527 err = PTR_ERR(larval);
531 crypto_wait_for_test(larval);
537 EXPORT_SYMBOL_GPL(crypto_register_instance);
539 int crypto_unregister_instance(struct crypto_alg *alg)
542 struct crypto_instance *inst = (void *)alg;
543 struct crypto_template *tmpl = inst->tmpl;
546 if (!(alg->cra_flags & CRYPTO_ALG_INSTANCE))
549 BUG_ON(atomic_read(&alg->cra_refcnt) != 1);
551 down_write(&crypto_alg_sem);
553 hlist_del_init(&inst->list);
554 err = crypto_remove_alg(alg, &users);
556 up_write(&crypto_alg_sem);
562 crypto_remove_final(&users);
566 EXPORT_SYMBOL_GPL(crypto_unregister_instance);
568 int crypto_init_spawn(struct crypto_spawn *spawn, struct crypto_alg *alg,
569 struct crypto_instance *inst, u32 mask)
576 down_write(&crypto_alg_sem);
577 if (!crypto_is_moribund(alg)) {
578 list_add(&spawn->list, &alg->cra_users);
582 up_write(&crypto_alg_sem);
586 EXPORT_SYMBOL_GPL(crypto_init_spawn);
588 int crypto_init_spawn2(struct crypto_spawn *spawn, struct crypto_alg *alg,
589 struct crypto_instance *inst,
590 const struct crypto_type *frontend)
594 if ((alg->cra_flags ^ frontend->type) & frontend->maskset)
597 spawn->frontend = frontend;
598 err = crypto_init_spawn(spawn, alg, inst, frontend->maskset);
603 EXPORT_SYMBOL_GPL(crypto_init_spawn2);
605 void crypto_drop_spawn(struct crypto_spawn *spawn)
610 down_write(&crypto_alg_sem);
611 list_del(&spawn->list);
612 up_write(&crypto_alg_sem);
614 EXPORT_SYMBOL_GPL(crypto_drop_spawn);
616 static struct crypto_alg *crypto_spawn_alg(struct crypto_spawn *spawn)
618 struct crypto_alg *alg;
619 struct crypto_alg *alg2;
621 down_read(&crypto_alg_sem);
625 alg2 = crypto_mod_get(alg2);
626 up_read(&crypto_alg_sem);
630 crypto_shoot_alg(alg);
631 return ERR_PTR(-EAGAIN);
637 struct crypto_tfm *crypto_spawn_tfm(struct crypto_spawn *spawn, u32 type,
640 struct crypto_alg *alg;
641 struct crypto_tfm *tfm;
643 alg = crypto_spawn_alg(spawn);
645 return ERR_CAST(alg);
647 tfm = ERR_PTR(-EINVAL);
648 if (unlikely((alg->cra_flags ^ type) & mask))
651 tfm = __crypto_alloc_tfm(alg, type, mask);
661 EXPORT_SYMBOL_GPL(crypto_spawn_tfm);
663 void *crypto_spawn_tfm2(struct crypto_spawn *spawn)
665 struct crypto_alg *alg;
666 struct crypto_tfm *tfm;
668 alg = crypto_spawn_alg(spawn);
670 return ERR_CAST(alg);
672 tfm = crypto_create_tfm(alg, spawn->frontend);
682 EXPORT_SYMBOL_GPL(crypto_spawn_tfm2);
684 int crypto_register_notifier(struct notifier_block *nb)
686 return blocking_notifier_chain_register(&crypto_chain, nb);
688 EXPORT_SYMBOL_GPL(crypto_register_notifier);
690 int crypto_unregister_notifier(struct notifier_block *nb)
692 return blocking_notifier_chain_unregister(&crypto_chain, nb);
694 EXPORT_SYMBOL_GPL(crypto_unregister_notifier);
696 struct crypto_attr_type *crypto_get_attr_type(struct rtattr **tb)
698 struct rtattr *rta = tb[0];
699 struct crypto_attr_type *algt;
702 return ERR_PTR(-ENOENT);
703 if (RTA_PAYLOAD(rta) < sizeof(*algt))
704 return ERR_PTR(-EINVAL);
705 if (rta->rta_type != CRYPTOA_TYPE)
706 return ERR_PTR(-EINVAL);
708 algt = RTA_DATA(rta);
712 EXPORT_SYMBOL_GPL(crypto_get_attr_type);
714 int crypto_check_attr_type(struct rtattr **tb, u32 type)
716 struct crypto_attr_type *algt;
718 algt = crypto_get_attr_type(tb);
720 return PTR_ERR(algt);
722 if ((algt->type ^ type) & algt->mask)
727 EXPORT_SYMBOL_GPL(crypto_check_attr_type);
729 const char *crypto_attr_alg_name(struct rtattr *rta)
731 struct crypto_attr_alg *alga;
734 return ERR_PTR(-ENOENT);
735 if (RTA_PAYLOAD(rta) < sizeof(*alga))
736 return ERR_PTR(-EINVAL);
737 if (rta->rta_type != CRYPTOA_ALG)
738 return ERR_PTR(-EINVAL);
740 alga = RTA_DATA(rta);
741 alga->name[CRYPTO_MAX_ALG_NAME - 1] = 0;
745 EXPORT_SYMBOL_GPL(crypto_attr_alg_name);
747 struct crypto_alg *crypto_attr_alg2(struct rtattr *rta,
748 const struct crypto_type *frontend,
753 name = crypto_attr_alg_name(rta);
755 return ERR_CAST(name);
757 return crypto_find_alg(name, frontend, type, mask);
759 EXPORT_SYMBOL_GPL(crypto_attr_alg2);
761 int crypto_attr_u32(struct rtattr *rta, u32 *num)
763 struct crypto_attr_u32 *nu32;
767 if (RTA_PAYLOAD(rta) < sizeof(*nu32))
769 if (rta->rta_type != CRYPTOA_U32)
772 nu32 = RTA_DATA(rta);
777 EXPORT_SYMBOL_GPL(crypto_attr_u32);
779 void *crypto_alloc_instance2(const char *name, struct crypto_alg *alg,
782 struct crypto_instance *inst;
786 p = kzalloc(head + sizeof(*inst) + sizeof(struct crypto_spawn),
789 return ERR_PTR(-ENOMEM);
791 inst = (void *)(p + head);
794 if (snprintf(inst->alg.cra_name, CRYPTO_MAX_ALG_NAME, "%s(%s)", name,
795 alg->cra_name) >= CRYPTO_MAX_ALG_NAME)
798 if (snprintf(inst->alg.cra_driver_name, CRYPTO_MAX_ALG_NAME, "%s(%s)",
799 name, alg->cra_driver_name) >= CRYPTO_MAX_ALG_NAME)
808 EXPORT_SYMBOL_GPL(crypto_alloc_instance2);
810 struct crypto_instance *crypto_alloc_instance(const char *name,
811 struct crypto_alg *alg)
813 struct crypto_instance *inst;
814 struct crypto_spawn *spawn;
817 inst = crypto_alloc_instance2(name, alg, 0);
821 spawn = crypto_instance_ctx(inst);
822 err = crypto_init_spawn(spawn, alg, inst,
823 CRYPTO_ALG_TYPE_MASK | CRYPTO_ALG_ASYNC);
837 EXPORT_SYMBOL_GPL(crypto_alloc_instance);
839 void crypto_init_queue(struct crypto_queue *queue, unsigned int max_qlen)
841 INIT_LIST_HEAD(&queue->list);
842 queue->backlog = &queue->list;
844 queue->max_qlen = max_qlen;
846 EXPORT_SYMBOL_GPL(crypto_init_queue);
848 int crypto_enqueue_request(struct crypto_queue *queue,
849 struct crypto_async_request *request)
851 int err = -EINPROGRESS;
853 if (unlikely(queue->qlen >= queue->max_qlen)) {
855 if (!(request->flags & CRYPTO_TFM_REQ_MAY_BACKLOG))
857 if (queue->backlog == &queue->list)
858 queue->backlog = &request->list;
862 list_add_tail(&request->list, &queue->list);
867 EXPORT_SYMBOL_GPL(crypto_enqueue_request);
869 void *__crypto_dequeue_request(struct crypto_queue *queue, unsigned int offset)
871 struct list_head *request;
873 if (unlikely(!queue->qlen))
878 if (queue->backlog != &queue->list)
879 queue->backlog = queue->backlog->next;
881 request = queue->list.next;
884 return (char *)list_entry(request, struct crypto_async_request, list) -
887 EXPORT_SYMBOL_GPL(__crypto_dequeue_request);
889 struct crypto_async_request *crypto_dequeue_request(struct crypto_queue *queue)
891 return __crypto_dequeue_request(queue, 0);
893 EXPORT_SYMBOL_GPL(crypto_dequeue_request);
895 int crypto_tfm_in_queue(struct crypto_queue *queue, struct crypto_tfm *tfm)
897 struct crypto_async_request *req;
899 list_for_each_entry(req, &queue->list, list) {
906 EXPORT_SYMBOL_GPL(crypto_tfm_in_queue);
908 static inline void crypto_inc_byte(u8 *a, unsigned int size)
913 for (; size; size--) {
921 void crypto_inc(u8 *a, unsigned int size)
923 __be32 *b = (__be32 *)(a + size);
926 for (; size >= 4; size -= 4) {
927 c = be32_to_cpu(*--b) + 1;
933 crypto_inc_byte(a, size);
935 EXPORT_SYMBOL_GPL(crypto_inc);
937 static inline void crypto_xor_byte(u8 *a, const u8 *b, unsigned int size)
943 void crypto_xor(u8 *dst, const u8 *src, unsigned int size)
948 for (; size >= 4; size -= 4)
951 crypto_xor_byte((u8 *)a, (u8 *)b, size);
953 EXPORT_SYMBOL_GPL(crypto_xor);
955 static int __init crypto_algapi_init(void)
961 static void __exit crypto_algapi_exit(void)
966 module_init(crypto_algapi_init);
967 module_exit(crypto_algapi_exit);
969 MODULE_LICENSE("GPL");
970 MODULE_DESCRIPTION("Cryptographic algorithms API");