cryptodev.h revision 1.16 1 1.16 darran /* $NetBSD: cryptodev.h,v 1.16 2009/03/25 01:26:13 darran Exp $ */
2 1.5 jonathan /* $FreeBSD: src/sys/opencrypto/cryptodev.h,v 1.2.2.6 2003/07/02 17:04:50 sam Exp $ */
3 1.1 jonathan /* $OpenBSD: cryptodev.h,v 1.33 2002/07/17 23:52:39 art Exp $ */
4 1.1 jonathan
5 1.13 tls /*-
6 1.13 tls * Copyright (c) 2008 The NetBSD Foundation, Inc.
7 1.13 tls * All rights reserved.
8 1.13 tls *
9 1.13 tls * This code is derived from software contributed to The NetBSD Foundation
10 1.13 tls * by Coyote Point Systems, Inc.
11 1.13 tls *
12 1.13 tls * Redistribution and use in source and binary forms, with or without
13 1.13 tls * modification, are permitted provided that the following conditions
14 1.13 tls * are met:
15 1.13 tls * 1. Redistributions of source code must retain the above copyright
16 1.13 tls * notice, this list of conditions and the following disclaimer.
17 1.13 tls * 2. Redistributions in binary form must reproduce the above copyright
18 1.13 tls * notice, this list of conditions and the following disclaimer in the
19 1.13 tls * documentation and/or other materials provided with the distribution.
20 1.13 tls *
21 1.13 tls * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22 1.13 tls * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23 1.13 tls * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24 1.13 tls * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25 1.13 tls * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26 1.13 tls * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27 1.13 tls * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 1.13 tls * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 1.13 tls * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 1.13 tls * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31 1.13 tls * POSSIBILITY OF SUCH DAMAGE.
32 1.13 tls */
33 1.13 tls
34 1.1 jonathan /*
35 1.1 jonathan * The author of this code is Angelos D. Keromytis (angelos (at) cis.upenn.edu)
36 1.1 jonathan *
37 1.1 jonathan * This code was written by Angelos D. Keromytis in Athens, Greece, in
38 1.1 jonathan * February 2000. Network Security Technologies Inc. (NSTI) kindly
39 1.1 jonathan * supported the development of this code.
40 1.1 jonathan *
41 1.1 jonathan * Copyright (c) 2000 Angelos D. Keromytis
42 1.1 jonathan *
43 1.1 jonathan * Permission to use, copy, and modify this software with or without fee
44 1.1 jonathan * is hereby granted, provided that this entire notice is included in
45 1.1 jonathan * all source code copies of any software which is or includes a copy or
46 1.1 jonathan * modification of this software.
47 1.1 jonathan *
48 1.1 jonathan * THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR
49 1.1 jonathan * IMPLIED WARRANTY. IN PARTICULAR, NONE OF THE AUTHORS MAKES ANY
50 1.1 jonathan * REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE
51 1.1 jonathan * MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR
52 1.1 jonathan * PURPOSE.
53 1.1 jonathan *
54 1.1 jonathan * Copyright (c) 2001 Theo de Raadt
55 1.1 jonathan *
56 1.1 jonathan * Redistribution and use in source and binary forms, with or without
57 1.1 jonathan * modification, are permitted provided that the following conditions
58 1.1 jonathan * are met:
59 1.1 jonathan *
60 1.1 jonathan * 1. Redistributions of source code must retain the above copyright
61 1.1 jonathan * notice, this list of conditions and the following disclaimer.
62 1.1 jonathan * 2. Redistributions in binary form must reproduce the above copyright
63 1.1 jonathan * notice, this list of conditions and the following disclaimer in the
64 1.1 jonathan * documentation and/or other materials provided with the distribution.
65 1.1 jonathan * 3. The name of the author may not be used to endorse or promote products
66 1.1 jonathan * derived from this software without specific prior written permission.
67 1.1 jonathan *
68 1.1 jonathan * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
69 1.1 jonathan * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
70 1.1 jonathan * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
71 1.1 jonathan * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
72 1.1 jonathan * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
73 1.1 jonathan * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
74 1.1 jonathan * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
75 1.1 jonathan * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
76 1.1 jonathan * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
77 1.1 jonathan * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
78 1.1 jonathan *
79 1.1 jonathan * Effort sponsored in part by the Defense Advanced Research Projects
80 1.1 jonathan * Agency (DARPA) and Air Force Research Laboratory, Air Force
81 1.1 jonathan * Materiel Command, USAF, under agreement number F30602-01-2-0537.
82 1.1 jonathan *
83 1.1 jonathan */
84 1.1 jonathan
85 1.1 jonathan #ifndef _CRYPTO_CRYPTO_H_
86 1.1 jonathan #define _CRYPTO_CRYPTO_H_
87 1.1 jonathan
88 1.1 jonathan #include <sys/ioccom.h>
89 1.1 jonathan
90 1.1 jonathan /* Some initial values */
91 1.1 jonathan #define CRYPTO_DRIVERS_INITIAL 4
92 1.1 jonathan #define CRYPTO_SW_SESSIONS 32
93 1.1 jonathan
94 1.1 jonathan /* HMAC values */
95 1.1 jonathan #define HMAC_BLOCK_LEN 64
96 1.1 jonathan #define HMAC_IPAD_VAL 0x36
97 1.1 jonathan #define HMAC_OPAD_VAL 0x5C
98 1.1 jonathan
99 1.1 jonathan /* Encryption algorithm block sizes */
100 1.1 jonathan #define DES_BLOCK_LEN 8
101 1.1 jonathan #define DES3_BLOCK_LEN 8
102 1.1 jonathan #define BLOWFISH_BLOCK_LEN 8
103 1.1 jonathan #define SKIPJACK_BLOCK_LEN 8
104 1.1 jonathan #define CAST128_BLOCK_LEN 8
105 1.1 jonathan #define RIJNDAEL128_BLOCK_LEN 16
106 1.1 jonathan #define EALG_MAX_BLOCK_LEN 16 /* Keep this updated */
107 1.1 jonathan
108 1.1 jonathan /* Maximum hash algorithm result length */
109 1.1 jonathan #define AALG_MAX_RESULT_LEN 64 /* Keep this updated */
110 1.1 jonathan
111 1.1 jonathan #define CRYPTO_ALGORITHM_MIN 1
112 1.1 jonathan #define CRYPTO_DES_CBC 1
113 1.1 jonathan #define CRYPTO_3DES_CBC 2
114 1.1 jonathan #define CRYPTO_BLF_CBC 3
115 1.1 jonathan #define CRYPTO_CAST_CBC 4
116 1.1 jonathan #define CRYPTO_SKIPJACK_CBC 5
117 1.1 jonathan #define CRYPTO_MD5_HMAC 6
118 1.1 jonathan #define CRYPTO_SHA1_HMAC 7
119 1.1 jonathan #define CRYPTO_RIPEMD160_HMAC 8
120 1.1 jonathan #define CRYPTO_MD5_KPDK 9
121 1.1 jonathan #define CRYPTO_SHA1_KPDK 10
122 1.1 jonathan #define CRYPTO_RIJNDAEL128_CBC 11 /* 128 bit blocksize */
123 1.1 jonathan #define CRYPTO_AES_CBC 11 /* 128 bit blocksize -- the same as above */
124 1.1 jonathan #define CRYPTO_ARC4 12
125 1.1 jonathan #define CRYPTO_MD5 13
126 1.1 jonathan #define CRYPTO_SHA1 14
127 1.1 jonathan #define CRYPTO_SHA2_HMAC 15
128 1.1 jonathan #define CRYPTO_NULL_HMAC 16
129 1.1 jonathan #define CRYPTO_NULL_CBC 17
130 1.1 jonathan #define CRYPTO_DEFLATE_COMP 18 /* Deflate compression algorithm */
131 1.11 tls #define CRYPTO_MD5_HMAC_96 19
132 1.11 tls #define CRYPTO_SHA1_HMAC_96 20
133 1.11 tls #define CRYPTO_RIPEMD160_HMAC_96 21
134 1.16 darran #define CRYPTO_GZIP_COMP 22 /* Deflate compression algorithm */
135 1.16 darran #define CRYPTO_ALGORITHM_MAX 23 /* Keep updated - see below */
136 1.1 jonathan
137 1.1 jonathan /* Algorithm flags */
138 1.1 jonathan #define CRYPTO_ALG_FLAG_SUPPORTED 0x01 /* Algorithm is supported */
139 1.1 jonathan #define CRYPTO_ALG_FLAG_RNG_ENABLE 0x02 /* Has HW RNG for DH/DSA */
140 1.1 jonathan #define CRYPTO_ALG_FLAG_DSA_SHA 0x04 /* Can do SHA on msg */
141 1.1 jonathan
142 1.1 jonathan struct session_op {
143 1.1 jonathan u_int32_t cipher; /* ie. CRYPTO_DES_CBC */
144 1.1 jonathan u_int32_t mac; /* ie. CRYPTO_MD5_HMAC */
145 1.16 darran u_int32_t comp_alg; /* ie. CRYPTO_GZIP_COMP */
146 1.1 jonathan
147 1.1 jonathan u_int32_t keylen; /* cipher key */
148 1.8 christos void * key;
149 1.1 jonathan int mackeylen; /* mac key */
150 1.8 christos void * mackey;
151 1.1 jonathan
152 1.6 perry u_int32_t ses; /* returns: session # */
153 1.1 jonathan };
154 1.1 jonathan
155 1.13 tls /* to support multiple session creation */
156 1.13 tls
157 1.13 tls struct session_n_op {
158 1.13 tls u_int32_t cipher; /* ie. CRYPTO_DES_CBC */
159 1.13 tls u_int32_t mac; /* ie. CRYPTO_MD5_HMAC */
160 1.16 darran u_int32_t comp_alg; /* ie. CRYPTO_GZIP_COMP */
161 1.13 tls
162 1.13 tls u_int32_t keylen; /* cipher key */
163 1.13 tls void * key;
164 1.13 tls int mackeylen; /* mac key */
165 1.13 tls void * mackey;
166 1.13 tls
167 1.13 tls u_int32_t ses; /* returns: session # */
168 1.13 tls int status;
169 1.13 tls };
170 1.13 tls
171 1.1 jonathan struct crypt_op {
172 1.1 jonathan u_int32_t ses;
173 1.1 jonathan u_int16_t op; /* i.e. COP_ENCRYPT */
174 1.1 jonathan #define COP_ENCRYPT 1
175 1.1 jonathan #define COP_DECRYPT 2
176 1.16 darran #define COP_COMP 3
177 1.16 darran #define COP_DECOMP 4
178 1.1 jonathan u_int16_t flags;
179 1.1 jonathan #define COP_F_BATCH 0x0008 /* Dispatch as quickly as possible */
180 1.16 darran u_int len; /* src len */
181 1.8 christos void * src, *dst; /* become iov[] inside kernel */
182 1.8 christos void * mac; /* must be big enough for chosen MAC */
183 1.8 christos void * iv;
184 1.16 darran u_int dst_len; /* dst len if not 0 */
185 1.1 jonathan };
186 1.1 jonathan
187 1.13 tls /* to support multiple session creation */
188 1.13 tls /*
189 1.13 tls *
190 1.13 tls * The reqid field is filled when the operation has
191 1.13 tls * been accepted and started, and can be used to later retrieve
192 1.13 tls * the operation results via CIOCNCRYPTRET or identify the
193 1.13 tls * request in the completion list returned by CIOCNCRYPTRETM.
194 1.13 tls *
195 1.13 tls * The opaque pointer can be set arbitrarily by the user
196 1.13 tls * and it is passed back in the crypt_result structure
197 1.13 tls * when the request completes. This field can be used for example
198 1.13 tls * to track context for the request and avoid lookups in the
199 1.13 tls * user application.
200 1.13 tls */
201 1.13 tls
202 1.13 tls struct crypt_n_op {
203 1.13 tls u_int32_t ses;
204 1.13 tls u_int16_t op; /* i.e. COP_ENCRYPT */
205 1.13 tls #define COP_ENCRYPT 1
206 1.13 tls #define COP_DECRYPT 2
207 1.13 tls u_int16_t flags;
208 1.13 tls #define COP_F_BATCH 0x0008 /* Dispatch as quickly as possible */
209 1.16 darran #define COP_F_MORE 0x0010 /* more data to follow */
210 1.16 darran u_int len; /* src len */
211 1.13 tls
212 1.13 tls u_int32_t reqid; /* request id */
213 1.13 tls int status; /* status of request -accepted or not */
214 1.13 tls void *opaque; /* opaque pointer returned to user */
215 1.13 tls u_int32_t keylen; /* cipher key - optional */
216 1.13 tls void * key;
217 1.13 tls u_int32_t mackeylen; /* also optional */
218 1.13 tls void * mackey;
219 1.13 tls
220 1.13 tls void * src, *dst; /* become iov[] inside kernel */
221 1.13 tls void * mac; /* must be big enough for chosen MAC */
222 1.13 tls void * iv;
223 1.16 darran u_int dst_len; /* dst len if not 0 */
224 1.13 tls };
225 1.13 tls
226 1.13 tls /* CIOCNCRYPTM ioctl argument, supporting one or more asynchronous
227 1.13 tls * crypt_n_op operations.
228 1.13 tls * Each crypt_n_op will receive a request id which can be used to check its
229 1.13 tls * status via CIOCNCRYPTRET, or to watch for its completion in the list
230 1.13 tls * obtained via CIOCNCRYPTRETM.
231 1.13 tls */
232 1.13 tls struct crypt_mop {
233 1.13 tls size_t count; /* how many */
234 1.13 tls struct crypt_n_op * reqs; /* where to get them */
235 1.13 tls };
236 1.13 tls
237 1.13 tls struct crypt_sfop {
238 1.13 tls size_t count;
239 1.13 tls u_int32_t *sesid;
240 1.13 tls };
241 1.13 tls
242 1.13 tls struct crypt_sgop {
243 1.13 tls size_t count;
244 1.13 tls struct session_n_op * sessions;
245 1.13 tls };
246 1.13 tls
247 1.1 jonathan #define CRYPTO_MAX_MAC_LEN 20
248 1.1 jonathan
249 1.1 jonathan /* bignum parameter, in packed bytes, ... */
250 1.1 jonathan struct crparam {
251 1.8 christos void * crp_p;
252 1.1 jonathan u_int crp_nbits;
253 1.1 jonathan };
254 1.1 jonathan
255 1.1 jonathan #define CRK_MAXPARAM 8
256 1.1 jonathan
257 1.1 jonathan struct crypt_kop {
258 1.1 jonathan u_int crk_op; /* ie. CRK_MOD_EXP or other */
259 1.1 jonathan u_int crk_status; /* return status */
260 1.1 jonathan u_short crk_iparams; /* # of input parameters */
261 1.1 jonathan u_short crk_oparams; /* # of output parameters */
262 1.1 jonathan u_int crk_pad1;
263 1.1 jonathan struct crparam crk_param[CRK_MAXPARAM];
264 1.1 jonathan };
265 1.13 tls
266 1.13 tls /*
267 1.13 tls * Used with the CIOCNFKEYM ioctl.
268 1.13 tls *
269 1.13 tls * This structure allows the OCF to return a request id
270 1.13 tls * for each of the kop operations specified in the CIOCNFKEYM call.
271 1.13 tls *
272 1.13 tls * The crk_opaque pointer can be arbitrarily set by the user
273 1.13 tls * and it is passed back in the crypt_result structure
274 1.13 tls * when the request completes. This field can be used for example
275 1.13 tls * to track context for the request and avoid lookups in the
276 1.13 tls * user application.
277 1.13 tls */
278 1.13 tls struct crypt_n_kop {
279 1.13 tls u_int crk_op; /* ie. CRK_MOD_EXP or other */
280 1.13 tls u_int crk_status; /* return status */
281 1.13 tls u_short crk_iparams; /* # of input parameters */
282 1.13 tls u_short crk_oparams; /* # of output parameters */
283 1.13 tls u_int32_t crk_reqid; /* request id */
284 1.13 tls struct crparam crk_param[CRK_MAXPARAM];
285 1.13 tls void *crk_opaque; /* opaque pointer returned to user */
286 1.13 tls };
287 1.13 tls
288 1.13 tls struct crypt_mkop {
289 1.13 tls size_t count; /* how many */
290 1.13 tls struct crypt_n_kop * reqs; /* where to get them */
291 1.13 tls };
292 1.13 tls
293 1.13 tls /* Asynchronous key or crypto result.
294 1.13 tls * Note that the status will be set in the crypt_result structure,
295 1.13 tls * not in the original crypt_kop structure (crk_status).
296 1.13 tls */
297 1.13 tls struct crypt_result {
298 1.13 tls u_int32_t reqid; /* request id */
299 1.13 tls u_int32_t status; /* status of request: 0 if successful */
300 1.13 tls void * opaque; /* Opaque pointer from the user, passed along */
301 1.13 tls };
302 1.13 tls
303 1.13 tls struct cryptret {
304 1.13 tls size_t count; /* space for how many */
305 1.13 tls struct crypt_result * results; /* where to put them */
306 1.13 tls };
307 1.13 tls
308 1.13 tls
309 1.13 tls /* Assymetric key operations */
310 1.1 jonathan #define CRK_ALGORITM_MIN 0
311 1.1 jonathan #define CRK_MOD_EXP 0
312 1.1 jonathan #define CRK_MOD_EXP_CRT 1
313 1.1 jonathan #define CRK_DSA_SIGN 2
314 1.1 jonathan #define CRK_DSA_VERIFY 3
315 1.1 jonathan #define CRK_DH_COMPUTE_KEY 4
316 1.9 tls #define CRK_MOD_ADD 5
317 1.9 tls #define CRK_MOD_ADDINV 6
318 1.9 tls #define CRK_MOD_SUB 7
319 1.9 tls #define CRK_MOD_MULT 8
320 1.9 tls #define CRK_MOD_MULTINV 9
321 1.9 tls #define CRK_MOD 10
322 1.9 tls #define CRK_ALGORITHM_MAX 10 /* Keep updated - see below */
323 1.1 jonathan
324 1.1 jonathan #define CRF_MOD_EXP (1 << CRK_MOD_EXP)
325 1.1 jonathan #define CRF_MOD_EXP_CRT (1 << CRK_MOD_EXP_CRT)
326 1.1 jonathan #define CRF_DSA_SIGN (1 << CRK_DSA_SIGN)
327 1.1 jonathan #define CRF_DSA_VERIFY (1 << CRK_DSA_VERIFY)
328 1.1 jonathan #define CRF_DH_COMPUTE_KEY (1 << CRK_DH_COMPUTE_KEY)
329 1.9 tls #define CRF_MOD_ADD (1 << CRK_MOD_ADD)
330 1.9 tls #define CRF_MOD_ADDINV (1 << CRK_MOD_ADDINV)
331 1.9 tls #define CRF_MOD_SUB (1 << CRK_MOD_SUB)
332 1.9 tls #define CRF_MOD_MULT (1 << CRK_MOD_MULT)
333 1.9 tls #define CRF_MOD_MULTINV (1 << CRK_MOD_MULTINV)
334 1.9 tls #define CRF_MOD (1 << CRK_MOD)
335 1.1 jonathan
336 1.1 jonathan /*
337 1.13 tls * A large comment here once held descriptions of the ioctl
338 1.13 tls * requests implemented by the device. This text has been moved
339 1.13 tls * to the crypto(4) manual page and, later, removed from this file
340 1.13 tls * as it was always a step behind the times.
341 1.13 tls */
342 1.13 tls
343 1.13 tls /*
344 1.1 jonathan * done against open of /dev/crypto, to get a cloned descriptor.
345 1.13 tls * Please use F_SETFD against the cloned descriptor. But this ioctl
346 1.13 tls * is obsolete (the device now clones): please, just don't use it.
347 1.1 jonathan */
348 1.1 jonathan #define CRIOGET _IOWR('c', 100, u_int32_t)
349 1.1 jonathan
350 1.1 jonathan /* the following are done against the cloned descriptor */
351 1.1 jonathan #define CIOCFSESSION _IOW('c', 102, u_int32_t)
352 1.1 jonathan #define CIOCKEY _IOWR('c', 104, struct crypt_kop)
353 1.13 tls #define CIOCNFKEYM _IOWR('c', 108, struct crypt_mkop)
354 1.13 tls #define CIOCNFSESSION _IOW('c', 109, struct crypt_sfop)
355 1.13 tls #define CIOCNCRYPTRETM _IOWR('c', 110, struct cryptret)
356 1.13 tls #define CIOCNCRYPTRET _IOWR('c', 111, struct crypt_result)
357 1.1 jonathan
358 1.16 darran #define CIOCGSESSION _IOWR('c', 112, struct session_op)
359 1.16 darran #define CIOCNGSESSION _IOWR('c', 113, struct crypt_sgop)
360 1.16 darran #define CIOCCRYPT _IOWR('c', 114, struct crypt_op)
361 1.16 darran #define CIOCNCRYPTM _IOWR('c', 115, struct crypt_mop)
362 1.16 darran
363 1.1 jonathan #define CIOCASYMFEAT _IOR('c', 105, u_int32_t)
364 1.1 jonathan
365 1.1 jonathan struct cryptotstat {
366 1.1 jonathan struct timespec acc; /* total accumulated time */
367 1.1 jonathan struct timespec min; /* max time */
368 1.1 jonathan struct timespec max; /* max time */
369 1.1 jonathan u_int32_t count; /* number of observations */
370 1.1 jonathan };
371 1.1 jonathan
372 1.1 jonathan struct cryptostats {
373 1.1 jonathan u_int32_t cs_ops; /* symmetric crypto ops submitted */
374 1.1 jonathan u_int32_t cs_errs; /* symmetric crypto ops that failed */
375 1.1 jonathan u_int32_t cs_kops; /* asymetric/key ops submitted */
376 1.1 jonathan u_int32_t cs_kerrs; /* asymetric/key ops that failed */
377 1.1 jonathan u_int32_t cs_intrs; /* crypto swi thread activations */
378 1.1 jonathan u_int32_t cs_rets; /* crypto return thread activations */
379 1.1 jonathan u_int32_t cs_blocks; /* symmetric op driver block */
380 1.1 jonathan u_int32_t cs_kblocks; /* symmetric op driver block */
381 1.1 jonathan /*
382 1.1 jonathan * When CRYPTO_TIMING is defined at compile time and the
383 1.1 jonathan * sysctl debug.crypto is set to 1, the crypto system will
384 1.1 jonathan * accumulate statistics about how long it takes to process
385 1.1 jonathan * crypto requests at various points during processing.
386 1.1 jonathan */
387 1.1 jonathan struct cryptotstat cs_invoke; /* crypto_dipsatch -> crypto_invoke */
388 1.1 jonathan struct cryptotstat cs_done; /* crypto_invoke -> crypto_done */
389 1.1 jonathan struct cryptotstat cs_cb; /* crypto_done -> callback */
390 1.1 jonathan struct cryptotstat cs_finis; /* callback -> callback return */
391 1.1 jonathan };
392 1.1 jonathan
393 1.1 jonathan #ifdef _KERNEL
394 1.1 jonathan /* Standard initialization structure beginning */
395 1.1 jonathan struct cryptoini {
396 1.1 jonathan int cri_alg; /* Algorithm to use */
397 1.1 jonathan int cri_klen; /* Key length, in bits */
398 1.1 jonathan int cri_rnd; /* Algorithm rounds, where relevant */
399 1.8 christos char *cri_key; /* key to use */
400 1.1 jonathan u_int8_t cri_iv[EALG_MAX_BLOCK_LEN]; /* IV to use */
401 1.1 jonathan struct cryptoini *cri_next;
402 1.1 jonathan };
403 1.1 jonathan
404 1.1 jonathan /* Describe boundaries of a single crypto operation */
405 1.1 jonathan struct cryptodesc {
406 1.1 jonathan int crd_skip; /* How many bytes to ignore from start */
407 1.1 jonathan int crd_len; /* How many bytes to process */
408 1.1 jonathan int crd_inject; /* Where to inject results, if applicable */
409 1.1 jonathan int crd_flags;
410 1.1 jonathan
411 1.1 jonathan #define CRD_F_ENCRYPT 0x01 /* Set when doing encryption */
412 1.1 jonathan #define CRD_F_IV_PRESENT 0x02 /* When encrypting, IV is already in
413 1.1 jonathan place, so don't copy. */
414 1.1 jonathan #define CRD_F_IV_EXPLICIT 0x04 /* IV explicitly provided */
415 1.1 jonathan #define CRD_F_DSA_SHA_NEEDED 0x08 /* Compute SHA-1 of buffer for DSA */
416 1.16 darran #define CRD_F_COMP 0x10 /* Set when doing compression */
417 1.1 jonathan
418 1.1 jonathan struct cryptoini CRD_INI; /* Initialization/context data */
419 1.1 jonathan #define crd_iv CRD_INI.cri_iv
420 1.1 jonathan #define crd_key CRD_INI.cri_key
421 1.1 jonathan #define crd_rnd CRD_INI.cri_rnd
422 1.1 jonathan #define crd_alg CRD_INI.cri_alg
423 1.1 jonathan #define crd_klen CRD_INI.cri_klen
424 1.1 jonathan
425 1.1 jonathan struct cryptodesc *crd_next;
426 1.1 jonathan };
427 1.1 jonathan
428 1.1 jonathan /* Structure describing complete operation */
429 1.1 jonathan struct cryptop {
430 1.16 darran TAILQ_ENTRY(cryptop) crp_next;
431 1.13 tls u_int64_t crp_sid; /* Session ID */
432 1.13 tls
433 1.13 tls u_int32_t crp_reqid; /* request id */
434 1.13 tls void * crp_usropaque; /* Opaque pointer from user, passed along */
435 1.1 jonathan
436 1.1 jonathan int crp_ilen; /* Input data total length */
437 1.1 jonathan int crp_olen; /* Result total length */
438 1.1 jonathan
439 1.1 jonathan int crp_etype; /*
440 1.1 jonathan * Error type (zero means no error).
441 1.1 jonathan * All error codes except EAGAIN
442 1.1 jonathan * indicate possible data corruption (as in,
443 1.1 jonathan * the data have been touched). On all
444 1.1 jonathan * errors, the crp_sid may have changed
445 1.1 jonathan * (reset to a new one), so the caller
446 1.1 jonathan * should always check and use the new
447 1.1 jonathan * value on future requests.
448 1.1 jonathan */
449 1.15 darran int crp_flags; /* Note: must hold mutext to modify */
450 1.1 jonathan
451 1.5 jonathan #define CRYPTO_F_IMBUF 0x0001 /* Input/output are mbuf chains */
452 1.5 jonathan #define CRYPTO_F_IOV 0x0002 /* Input/output are uio */
453 1.5 jonathan #define CRYPTO_F_REL 0x0004 /* Must return data in same place */
454 1.5 jonathan #define CRYPTO_F_BATCH 0x0008 /* Batch op if possible possible */
455 1.5 jonathan #define CRYPTO_F_CBIMM 0x0010 /* Do callback immediately */
456 1.5 jonathan #define CRYPTO_F_DONE 0x0020 /* Operation completed */
457 1.5 jonathan #define CRYPTO_F_CBIFSYNC 0x0040 /* Do CBIMM if op is synchronous */
458 1.12 tls #define CRYPTO_F_ONRETQ 0x0080 /* Request is on return queue */
459 1.15 darran #define CRYPTO_F_USER 0x0100 /* Request is in user context */
460 1.16 darran #define CRYPTO_F_MORE 0x0200 /* more data to follow */
461 1.1 jonathan
462 1.8 christos void * crp_buf; /* Data to be processed */
463 1.8 christos void * crp_opaque; /* Opaque pointer, passed along */
464 1.1 jonathan struct cryptodesc *crp_desc; /* Linked list of processing descriptors */
465 1.1 jonathan
466 1.1 jonathan int (*crp_callback)(struct cryptop *); /* Callback function */
467 1.1 jonathan
468 1.8 christos void * crp_mac;
469 1.1 jonathan struct timespec crp_tstamp; /* performance time stamp */
470 1.12 tls kcondvar_t crp_cv;
471 1.13 tls struct fcrypt *fcrp;
472 1.13 tls void * dst;
473 1.13 tls void * mac;
474 1.13 tls u_int len;
475 1.13 tls u_char tmp_iv[EALG_MAX_BLOCK_LEN];
476 1.13 tls u_char tmp_mac[CRYPTO_MAX_MAC_LEN];
477 1.13 tls
478 1.13 tls struct iovec iovec[1];
479 1.13 tls struct uio uio;
480 1.16 darran uint32_t magic;
481 1.1 jonathan };
482 1.1 jonathan
483 1.1 jonathan #define CRYPTO_BUF_CONTIG 0x0
484 1.1 jonathan #define CRYPTO_BUF_IOV 0x1
485 1.1 jonathan #define CRYPTO_BUF_MBUF 0x2
486 1.1 jonathan
487 1.1 jonathan #define CRYPTO_OP_DECRYPT 0x0
488 1.1 jonathan #define CRYPTO_OP_ENCRYPT 0x1
489 1.1 jonathan
490 1.1 jonathan /*
491 1.1 jonathan * Hints passed to process methods.
492 1.1 jonathan */
493 1.1 jonathan #define CRYPTO_HINT_MORE 0x1 /* more ops coming shortly */
494 1.1 jonathan
495 1.1 jonathan struct cryptkop {
496 1.16 darran TAILQ_ENTRY(cryptkop) krp_next;
497 1.13 tls
498 1.13 tls u_int32_t krp_reqid; /* request id */
499 1.13 tls void * krp_usropaque; /* Opaque pointer from user, passed along */
500 1.1 jonathan
501 1.1 jonathan u_int krp_op; /* ie. CRK_MOD_EXP or other */
502 1.1 jonathan u_int krp_status; /* return status */
503 1.1 jonathan u_short krp_iparams; /* # of input parameters */
504 1.1 jonathan u_short krp_oparams; /* # of output parameters */
505 1.1 jonathan u_int32_t krp_hid;
506 1.1 jonathan struct crparam krp_param[CRK_MAXPARAM]; /* kvm */
507 1.1 jonathan int (*krp_callback)(struct cryptkop *);
508 1.12 tls int krp_flags; /* same values as crp_flags */
509 1.12 tls kcondvar_t krp_cv;
510 1.13 tls struct fcrypt *fcrp;
511 1.13 tls struct crparam crk_param[CRK_MAXPARAM];
512 1.1 jonathan };
513 1.1 jonathan
514 1.1 jonathan /* Crypto capabilities structure */
515 1.1 jonathan struct cryptocap {
516 1.1 jonathan u_int32_t cc_sessions;
517 1.1 jonathan
518 1.1 jonathan /*
519 1.1 jonathan * Largest possible operator length (in bits) for each type of
520 1.1 jonathan * encryption algorithm.
521 1.1 jonathan */
522 1.1 jonathan u_int16_t cc_max_op_len[CRYPTO_ALGORITHM_MAX + 1];
523 1.1 jonathan
524 1.1 jonathan u_int8_t cc_alg[CRYPTO_ALGORITHM_MAX + 1];
525 1.1 jonathan
526 1.1 jonathan u_int8_t cc_kalg[CRK_ALGORITHM_MAX + 1];
527 1.1 jonathan
528 1.1 jonathan u_int8_t cc_flags;
529 1.1 jonathan u_int8_t cc_qblocked; /* symmetric q blocked */
530 1.1 jonathan u_int8_t cc_kqblocked; /* asymmetric q blocked */
531 1.5 jonathan #define CRYPTOCAP_F_CLEANUP 0x01 /* needs resource cleanup */
532 1.5 jonathan #define CRYPTOCAP_F_SOFTWARE 0x02 /* software implementation */
533 1.5 jonathan #define CRYPTOCAP_F_SYNC 0x04 /* operates synchronously */
534 1.1 jonathan
535 1.1 jonathan void *cc_arg; /* callback argument */
536 1.1 jonathan int (*cc_newsession)(void*, u_int32_t*, struct cryptoini*);
537 1.1 jonathan int (*cc_process) (void*, struct cryptop *, int);
538 1.1 jonathan int (*cc_freesession) (void*, u_int64_t);
539 1.1 jonathan void *cc_karg; /* callback argument */
540 1.1 jonathan int (*cc_kprocess) (void*, struct cryptkop *, int);
541 1.1 jonathan };
542 1.5 jonathan
543 1.5 jonathan /*
544 1.5 jonathan * Session ids are 64 bits. The lower 32 bits contain a "local id" which
545 1.5 jonathan * is a driver-private session identifier. The upper 32 bits contain a
546 1.5 jonathan * "hardware id" used by the core crypto code to identify the driver and
547 1.5 jonathan * a copy of the driver's capabilities that can be used by client code to
548 1.5 jonathan * optimize operation.
549 1.5 jonathan */
550 1.5 jonathan #define CRYPTO_SESID2HID(_sid) (((_sid) >> 32) & 0xffffff)
551 1.5 jonathan #define CRYPTO_SESID2CAPS(_sid) (((_sid) >> 56) & 0xff)
552 1.5 jonathan #define CRYPTO_SESID2LID(_sid) (((u_int32_t) (_sid)) & 0xffffffff)
553 1.1 jonathan
554 1.1 jonathan MALLOC_DECLARE(M_CRYPTO_DATA);
555 1.1 jonathan
556 1.1 jonathan extern int crypto_newsession(u_int64_t *sid, struct cryptoini *cri, int hard);
557 1.1 jonathan extern int crypto_freesession(u_int64_t sid);
558 1.1 jonathan extern int32_t crypto_get_driverid(u_int32_t flags);
559 1.1 jonathan extern int crypto_register(u_int32_t driverid, int alg, u_int16_t maxoplen,
560 1.1 jonathan u_int32_t flags,
561 1.1 jonathan int (*newses)(void*, u_int32_t*, struct cryptoini*),
562 1.1 jonathan int (*freeses)(void*, u_int64_t),
563 1.1 jonathan int (*process)(void*, struct cryptop *, int),
564 1.1 jonathan void *arg);
565 1.1 jonathan extern int crypto_kregister(u_int32_t, int, u_int32_t,
566 1.1 jonathan int (*)(void*, struct cryptkop *, int),
567 1.1 jonathan void *arg);
568 1.1 jonathan extern int crypto_unregister(u_int32_t driverid, int alg);
569 1.1 jonathan extern int crypto_unregister_all(u_int32_t driverid);
570 1.1 jonathan extern int crypto_dispatch(struct cryptop *crp);
571 1.1 jonathan extern int crypto_kdispatch(struct cryptkop *);
572 1.1 jonathan #define CRYPTO_SYMQ 0x1
573 1.1 jonathan #define CRYPTO_ASYMQ 0x2
574 1.1 jonathan extern int crypto_unblock(u_int32_t, int);
575 1.1 jonathan extern void crypto_done(struct cryptop *crp);
576 1.1 jonathan extern void crypto_kdone(struct cryptkop *);
577 1.1 jonathan extern int crypto_getfeat(int *);
578 1.1 jonathan
579 1.8 christos void cuio_copydata(struct uio *, int, int, void *);
580 1.8 christos void cuio_copyback(struct uio *, int, int, void *);
581 1.1 jonathan int cuio_apply(struct uio *, int, int,
582 1.8 christos int (*f)(void *, void *, unsigned int), void *);
583 1.1 jonathan
584 1.12 tls extern int crypto_ret_q_remove(struct cryptop *);
585 1.12 tls extern int crypto_ret_kq_remove(struct cryptkop *);
586 1.1 jonathan extern void crypto_freereq(struct cryptop *crp);
587 1.1 jonathan extern struct cryptop *crypto_getreq(int num);
588 1.1 jonathan
589 1.1 jonathan extern int crypto_usercrypto; /* userland may do crypto requests */
590 1.1 jonathan extern int crypto_userasymcrypto; /* userland may do asym crypto reqs */
591 1.1 jonathan extern int crypto_devallowsoft; /* only use hardware crypto */
592 1.3 jonathan
593 1.12 tls /*
594 1.12 tls * Asymmetric operations are allocated in cryptodev.c but can be
595 1.12 tls * freed in crypto.c.
596 1.12 tls */
597 1.15 darran extern struct pool cryptkop_pool;
598 1.12 tls
599 1.12 tls /*
600 1.12 tls * Mutual exclusion and its unwelcome friends.
601 1.12 tls */
602 1.12 tls
603 1.12 tls extern kmutex_t crypto_mtx;
604 1.3 jonathan
605 1.3 jonathan /*
606 1.3 jonathan * initialize the crypto framework subsystem (not the pseudo-device).
607 1.3 jonathan * This must be called very early in boot, so the framework is ready
608 1.3 jonathan * to handle registration requests when crpto hardware is autoconfigured.
609 1.3 jonathan * (This declaration doesnt really belong here but there's no header
610 1.3 jonathan * for the raw framework.)
611 1.3 jonathan */
612 1.7 thorpej void crypto_init(void);
613 1.1 jonathan
614 1.1 jonathan /*
615 1.1 jonathan * Crypto-related utility routines used mainly by drivers.
616 1.1 jonathan *
617 1.1 jonathan * XXX these don't really belong here; but for now they're
618 1.1 jonathan * kept apart from the rest of the system.
619 1.1 jonathan */
620 1.1 jonathan struct mbuf;
621 1.1 jonathan struct mbuf *m_getptr(struct mbuf *, int, int *);
622 1.1 jonathan
623 1.1 jonathan struct uio;
624 1.8 christos extern void cuio_copydata(struct uio* uio, int off, int len, void *cp);
625 1.8 christos extern void cuio_copyback(struct uio* uio, int off, int len, void *cp);
626 1.1 jonathan extern int cuio_getptr(struct uio *, int loc, int *off);
627 1.1 jonathan
628 1.12 tls #ifdef CRYPTO_DEBUG /* yuck, netipsec defines these differently */
629 1.12 tls #ifndef DPRINTF
630 1.12 tls #define DPRINTF(a) uprintf a
631 1.12 tls #endif
632 1.12 tls #ifndef DCPRINTF
633 1.12 tls #define DCPRINTF(a) printf a
634 1.12 tls #endif
635 1.12 tls #else
636 1.12 tls #ifndef DPRINTF
637 1.12 tls #define DPRINTF(a)
638 1.12 tls #endif
639 1.12 tls #ifndef DCPRINTF
640 1.12 tls #define DCPRINTF(a)
641 1.12 tls #endif
642 1.12 tls #endif
643 1.1 jonathan
644 1.1 jonathan #endif /* _KERNEL */
645 1.1 jonathan #endif /* _CRYPTO_CRYPTO_H_ */
646