1 .\" $OpenBSD: crypto.4,v 1.4 2002/09/12 07:15:03 deraadt Exp $
3 .\" Copyright (c) 2001 Theo de Raadt
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. The name of the author may not be used to endorse or promote products
15 .\" derived from this software without specific prior written permission.
17 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20 .\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
21 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
23 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
25 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
26 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 .\" POSSIBILITY OF SUCH DAMAGE.
37 .Nd hardware crypto access driver
44 driver provides a device-independent framework to support
45 cryptographic operations in the kernel.
48 driver provides userland applications access to this support
52 This node primarily operates in an
54 based model, permitting a variety of applications to query device capabilities,
55 submit transactions, and get results.
59 given in the specification, and is greater than 0, a maximum of one
65 calls apply only to the
68 .Bl -tag -width ".Dv CIOCGSESSION"
70 Setup a new crypto session for a new type of operation.
72 Free a previously established session.
74 Perform a crypto operation against a previously setup session.
77 Depending on hardware being present, the following symmetric and
78 asymmetric cryptographic features are potentially available from
81 .Bl -tag -width ".Dv CRYPTO_RIPEMD160_HMAC" -offset indent -compact
83 .It Dv CRYPTO_3DES_CBC
85 .It Dv CRYPTO_CAST_CBC
86 .It Dv CRYPTO_SKIPJACK_CBC
87 .It Dv CRYPTO_MD5_HMAC
88 .It Dv CRYPTO_SHA1_HMAC
89 .It Dv CRYPTO_RIPEMD160_HMAC
90 .It Dv CRYPTO_MD5_KPDK
91 .It Dv CRYPTO_SHA1_KPDK
97 .It Dv CRK_MOD_EXP_CRT
100 .It Dv CRK_DH_COMPUTE_KEY
103 .Bl -tag -width ".Pa /dev/crypto" -compact
115 driver first appeared in
119 driver was imported to