xref: /freebsd/share/man/man4/man4.i386/glxsb.4 (revision e6bfd18d21b225af6a0ed67ceeaf1293b7b9eba5)
1.\" $OpenBSD: glxsb.4,v 1.5 2007/05/31 19:19:54 jmc Exp $
2.\"
3.\"Copyright (c) 2006 Tom Cosgrove <tom@openbsd.org>
4.\"
5.\"Permission to use, copy, modify, and distribute this software for any
6.\"purpose with or without fee is hereby granted, provided that the above
7.\"copyright notice and this permission notice appear in all copies.
8.\"
9.\"THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\"WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\"MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\"ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\"WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\"ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\"OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.\" $FreeBSD$
18.\"
19.Dd July 29, 2020
20.Dt GLXSB 4 i386
21.Os
22.Sh NAME
23.Nm glxsb
24.Nd Geode LX Security Block crypto accelerator
25.Sh SYNOPSIS
26To compile this driver into the kernel,
27place the following lines in your
28kernel configuration file:
29.Bd -ragged -offset indent
30.Cd "device crypto"
31.Cd "device glxsb"
32.Ed
33.Pp
34Alternatively, to load the driver as a
35module at boot time, place the following line in
36.Xr loader.conf 5 :
37.Bd -literal -offset indent
38glxsb_load="YES"
39.Ed
40.Sh DESCRIPTION
41The
42.Nm
43driver supports the security block of the Geode LX series processors.
44The Geode LX is a member of the AMD Geode family
45of integrated x86 system chips.
46.Pp
47Driven by periodic checks for available data from the generator,
48.Nm
49supplies entropy to the
50.Xr random 4
51driver for common usage.
52.Pp
53.Nm
54also supports acceleration of AES-128-CBC operations for
55.Xr crypto 4 .
56It also registers itself to accelerate other HMAC algorithms, although
57there is no hardware acceleration for those algorithms.
58This is only needed so
59.Nm
60can work with
61.Xr ipsec 4 .
62.Sh CAVEAT
63The
64.Xr crypto 9
65framework will fail to open the crypto session on the device if the AES
66key's length is != 128 bits.
67This prevents the use of the
68.Nm
69device driver with AES keys of length != 128 bits.
70.Sh SEE ALSO
71.Xr crypto 4 ,
72.Xr intro 4 ,
73.Xr ipsec 4 ,
74.Xr pci 4 ,
75.Xr random 4 ,
76.Xr crypto 7 ,
77.Xr crypto 9
78.Sh HISTORY
79The
80.Nm
81device driver first appeared in
82.Ox 4.1 .
83The
84.Nm
85device driver was imported into
86.Fx 7.1 .
87.Sh AUTHORS
88.An -nosplit
89The
90.Nm
91device driver was written for
92.Ox
93by
94.An Tom Cosgrove .
95It was ported to
96.Fx
97by
98.An Patrick Lamaiziere Aq Mt patfbsd@davenulle.org .
99