1 /* 2 * Crypto engine API 3 * 4 * Copyright (c) 2016 Baolin Wang <baolin.wang@linaro.org> 5 * 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) 9 * any later version. 10 * 11 */ 12 #ifndef _CRYPTO_ENGINE_H 13 #define _CRYPTO_ENGINE_H 14 15 #include <linux/crypto.h> 16 #include <linux/list.h> 17 #include <linux/kernel.h> 18 #include <linux/kthread.h> 19 #include <crypto/algapi.h> 20 #include <crypto/hash.h> 21 22 #define ENGINE_NAME_LEN 30 23 /* 24 * struct crypto_engine - crypto hardware engine 25 * @name: the engine name 26 * @idling: the engine is entering idle state 27 * @busy: request pump is busy 28 * @running: the engine is on working 29 * @cur_req_prepared: current request is prepared 30 * @list: link with the global crypto engine list 31 * @queue_lock: spinlock to syncronise access to request queue 32 * @queue: the crypto queue of the engine 33 * @rt: whether this queue is set to run as a realtime task 34 * @prepare_crypt_hardware: a request will soon arrive from the queue 35 * so the subsystem requests the driver to prepare the hardware 36 * by issuing this call 37 * @unprepare_crypt_hardware: there are currently no more requests on the 38 * queue so the subsystem notifies the driver that it may relax the 39 * hardware by issuing this call 40 * @prepare_cipher_request: do some prepare if need before handle the current request 41 * @unprepare_cipher_request: undo any work done by prepare_cipher_request() 42 * @cipher_one_request: do encryption for current request 43 * @prepare_hash_request: do some prepare if need before handle the current request 44 * @unprepare_hash_request: undo any work done by prepare_hash_request() 45 * @hash_one_request: do hash for current request 46 * @kworker: kthread worker struct for request pump 47 * @pump_requests: work struct for scheduling work to the request pump 48 * @priv_data: the engine private data 49 * @cur_req: the current request which is on processing 50 */ 51 struct crypto_engine { 52 char name[ENGINE_NAME_LEN]; 53 bool idling; 54 bool busy; 55 bool running; 56 bool cur_req_prepared; 57 58 struct list_head list; 59 spinlock_t queue_lock; 60 struct crypto_queue queue; 61 struct device *dev; 62 63 bool rt; 64 65 int (*prepare_crypt_hardware)(struct crypto_engine *engine); 66 int (*unprepare_crypt_hardware)(struct crypto_engine *engine); 67 68 int (*prepare_cipher_request)(struct crypto_engine *engine, 69 struct ablkcipher_request *req); 70 int (*unprepare_cipher_request)(struct crypto_engine *engine, 71 struct ablkcipher_request *req); 72 int (*prepare_hash_request)(struct crypto_engine *engine, 73 struct ahash_request *req); 74 int (*unprepare_hash_request)(struct crypto_engine *engine, 75 struct ahash_request *req); 76 int (*cipher_one_request)(struct crypto_engine *engine, 77 struct ablkcipher_request *req); 78 int (*hash_one_request)(struct crypto_engine *engine, 79 struct ahash_request *req); 80 81 struct kthread_worker *kworker; 82 struct kthread_work pump_requests; 83 84 void *priv_data; 85 struct crypto_async_request *cur_req; 86 }; 87 88 int crypto_transfer_cipher_request(struct crypto_engine *engine, 89 struct ablkcipher_request *req, 90 bool need_pump); 91 int crypto_transfer_cipher_request_to_engine(struct crypto_engine *engine, 92 struct ablkcipher_request *req); 93 int crypto_transfer_hash_request(struct crypto_engine *engine, 94 struct ahash_request *req, bool need_pump); 95 int crypto_transfer_hash_request_to_engine(struct crypto_engine *engine, 96 struct ahash_request *req); 97 void crypto_finalize_cipher_request(struct crypto_engine *engine, 98 struct ablkcipher_request *req, int err); 99 void crypto_finalize_hash_request(struct crypto_engine *engine, 100 struct ahash_request *req, int err); 101 int crypto_engine_start(struct crypto_engine *engine); 102 int crypto_engine_stop(struct crypto_engine *engine); 103 struct crypto_engine *crypto_engine_alloc_init(struct device *dev, bool rt); 104 int crypto_engine_exit(struct crypto_engine *engine); 105 106 #endif /* _CRYPTO_ENGINE_H */ 107