1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3 * Asynchronous Compression operations
4 *
5 * Copyright (c) 2016, Intel Corporation
6 * Authors: Weigang Li <weigang.li@intel.com>
7 * Giovanni Cabiddu <giovanni.cabiddu@intel.com>
8 */
9 #ifndef _CRYPTO_ACOMP_INT_H
10 #define _CRYPTO_ACOMP_INT_H
11
12 #include <crypto/acompress.h>
13 #include <crypto/algapi.h>
14
15 /**
16 * struct acomp_alg - asynchronous compression algorithm
17 *
18 * @compress: Function performs a compress operation
19 * @decompress: Function performs a de-compress operation
20 * @dst_free: Frees destination buffer if allocated inside the algorithm
21 * @init: Initialize the cryptographic transformation object.
22 * This function is used to initialize the cryptographic
23 * transformation object. This function is called only once at
24 * the instantiation time, right after the transformation context
25 * was allocated. In case the cryptographic hardware has some
26 * special requirements which need to be handled by software, this
27 * function shall check for the precise requirement of the
28 * transformation and put any software fallbacks in place.
29 * @exit: Deinitialize the cryptographic transformation object. This is a
30 * counterpart to @init, used to remove various changes set in
31 * @init.
32 *
33 * @reqsize: Context size for (de)compression requests
34 * @base: Common crypto API algorithm data structure
35 * @calg: Cmonn algorithm data structure shared with scomp
36 */
37 struct acomp_alg {
38 int (*compress)(struct acomp_req *req);
39 int (*decompress)(struct acomp_req *req);
40 void (*dst_free)(struct scatterlist *dst);
41 int (*init)(struct crypto_acomp *tfm);
42 void (*exit)(struct crypto_acomp *tfm);
43
44 unsigned int reqsize;
45
46 union {
47 struct COMP_ALG_COMMON;
48 struct comp_alg_common calg;
49 };
50 };
51
52 /*
53 * Transform internal helpers.
54 */
acomp_request_ctx(struct acomp_req * req)55 static inline void *acomp_request_ctx(struct acomp_req *req)
56 {
57 return req->__ctx;
58 }
59
acomp_tfm_ctx(struct crypto_acomp * tfm)60 static inline void *acomp_tfm_ctx(struct crypto_acomp *tfm)
61 {
62 return tfm->base.__crt_ctx;
63 }
64
acomp_request_complete(struct acomp_req * req,int err)65 static inline void acomp_request_complete(struct acomp_req *req,
66 int err)
67 {
68 crypto_request_complete(&req->base, err);
69 }
70
__acomp_request_alloc_noprof(struct crypto_acomp * tfm)71 static inline struct acomp_req *__acomp_request_alloc_noprof(struct crypto_acomp *tfm)
72 {
73 struct acomp_req *req;
74
75 req = kzalloc_noprof(sizeof(*req) + crypto_acomp_reqsize(tfm), GFP_KERNEL);
76 if (likely(req))
77 acomp_request_set_tfm(req, tfm);
78 return req;
79 }
80 #define __acomp_request_alloc(...) alloc_hooks(__acomp_request_alloc_noprof(__VA_ARGS__))
81
__acomp_request_free(struct acomp_req * req)82 static inline void __acomp_request_free(struct acomp_req *req)
83 {
84 kfree_sensitive(req);
85 }
86
87 /**
88 * crypto_register_acomp() -- Register asynchronous compression algorithm
89 *
90 * Function registers an implementation of an asynchronous
91 * compression algorithm
92 *
93 * @alg: algorithm definition
94 *
95 * Return: zero on success; error code in case of error
96 */
97 int crypto_register_acomp(struct acomp_alg *alg);
98
99 /**
100 * crypto_unregister_acomp() -- Unregister asynchronous compression algorithm
101 *
102 * Function unregisters an implementation of an asynchronous
103 * compression algorithm
104 *
105 * @alg: algorithm definition
106 */
107 void crypto_unregister_acomp(struct acomp_alg *alg);
108
109 int crypto_register_acomps(struct acomp_alg *algs, int count);
110 void crypto_unregister_acomps(struct acomp_alg *algs, int count);
111
112 #endif
113