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