114 lines
3.2 KiB
Groff
114 lines
3.2 KiB
Groff
.\" $OpenBSD: crypto.4,v 1.4 2002/09/12 07:15:03 deraadt Exp $
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.\" Copyright (c) 2001 Theo de Raadt
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
|
|
.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.Dd October 3, 2002
|
|
.Dt CRYPTO 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm crypto
|
|
.Nd hardware crypto access driver
|
|
.Sh SYNOPSIS
|
|
.Nm device crypto
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
driver provides userland applications access to hardware crypto support
|
|
via the kernel.
|
|
The
|
|
.Pa /dev/crypto
|
|
device node primarily operates in an
|
|
.Xr ioctl 2
|
|
based model, permitting a variety of applications to query device capabilities,
|
|
submit transactions, and get results.
|
|
.Pp
|
|
If
|
|
.Ar count
|
|
given in the specification, and is greater than 0, a maximum of one
|
|
.Nm crypto
|
|
device is created.
|
|
.Pp
|
|
The following
|
|
.Xr ioctl 2
|
|
calls apply only to the
|
|
.Nm crypto
|
|
devices:
|
|
.Bl -tag -width CIOCGSESSION
|
|
.It Dv CIOCGSESSION
|
|
Setup a new crypto session for a new type of operation.
|
|
.It Dv CIOCFSESSION
|
|
Free a previously established session.
|
|
.It Dv CIOCCRYPT
|
|
Perform a crypto operation against a previously setup session.
|
|
.El
|
|
.Pp
|
|
.Sh FEATURES
|
|
Depending on hardware being present, the following symmetric and
|
|
assymetric cryptographic features are potentially available from
|
|
.Pa /dev/crypto :
|
|
.Pp
|
|
.Bl -tag -compact -width CRYPTO_RIPEMD160_HMAC -offset indent
|
|
.It CRYPTO_DES_CBC
|
|
.It CRYPTO_3DES_CBC
|
|
.It CRYPTO_BLF_CBC
|
|
.It CRYPTO_CAST_CBC
|
|
.It CRYPTO_SKIPJACK_CBC
|
|
.It CRYPTO_MD5_HMAC
|
|
.It CRYPTO_SHA1_HMAC
|
|
.It CRYPTO_RIPEMD160_HMAC
|
|
.It CRYPTO_MD5_KPDK
|
|
.It CRYPTO_SHA1_KPDK
|
|
.It CRYPTO_AES_CBC
|
|
.It CRYPTO_ARC4
|
|
.It CRYPTO_MD5
|
|
.It CRYPTO_SHA1
|
|
.It CRK_MOD_EXP
|
|
.It CRK_MOD_EXP_CRT
|
|
.It CRK_DSA_SIGN
|
|
.It CRK_DSA_VERIFY
|
|
.It CRK_DH_COMPUTE_KEY
|
|
.El
|
|
.Pp
|
|
.Sh FILES
|
|
.Bl -tag -width /dev/crypto -compact
|
|
.It Pa /dev/crypto
|
|
crypto access device
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr hifn 4 ,
|
|
.Xr ubsec 4 ,
|
|
.Xr crypto 9
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
driver first appeared in
|
|
OpenBSD 3.0.
|
|
The
|
|
.Nm
|
|
driver was imported to FreeBSD in 5.0.
|