xref: /freebsd/share/man/man4/man4.i386/glxsb.4 (revision 068b48d674ae8e2c007102173b93de9a9cb95ba9)
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.Sh DESCRIPTION
41edd30e9cSPhilip PaepsThe
42edd30e9cSPhilip Paeps.Nm
43edd30e9cSPhilip Paepsdriver supports the security block of the Geode LX series processors.
44edd30e9cSPhilip PaepsThe Geode LX is a member of the AMD Geode family
45edd30e9cSPhilip Paepsof integrated x86 system chips.
46edd30e9cSPhilip Paeps.Pp
47edd30e9cSPhilip PaepsDriven by periodic checks for available data from the generator,
48edd30e9cSPhilip Paeps.Nm
49edd30e9cSPhilip Paepssupplies entropy to the
50edd30e9cSPhilip Paeps.Xr random 4
51edd30e9cSPhilip Paepsdriver for common usage.
52edd30e9cSPhilip Paeps.Pp
53edd30e9cSPhilip Paeps.Nm
54edd30e9cSPhilip Paepsalso supports acceleration of AES-128-CBC operations for
55edd30e9cSPhilip Paeps.Xr crypto 4 .
562c97c274SChristian BruefferIt also registers itself to accelerate other HMAC algorithms, although
57edd30e9cSPhilip Paepsthere is no hardware acceleration for those algorithms.
58edd30e9cSPhilip PaepsThis is only needed so
59edd30e9cSPhilip Paeps.Nm
60edd30e9cSPhilip Paepscan work with
61edd30e9cSPhilip Paeps.Xr ipsec 4 .
62edd30e9cSPhilip Paeps.Sh CAVEAT
63edd30e9cSPhilip PaepsThe
64edd30e9cSPhilip Paeps.Xr crypto 9
65edd30e9cSPhilip Paepsframework will fail to open the crypto session on the device if the AES
662c97c274SChristian Bruefferkey's length is != 128 bits.
672c97c274SChristian BruefferThis prevents the use of the
68edd30e9cSPhilip Paeps.Nm
692c97c274SChristian Bruefferdevice driver with AES keys of length != 128 bits.
70edd30e9cSPhilip Paeps.Sh SEE ALSO
71edd30e9cSPhilip Paeps.Xr crypto 4 ,
72edd30e9cSPhilip Paeps.Xr intro 4 ,
73edd30e9cSPhilip Paeps.Xr ipsec 4 ,
74*068b48d6SJoel Dahl.Xr pci 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
842c97c274SChristian Bruefferdevice driver was imported into
852a72feb4SChristian Brueffer.Fx 7.1 .
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
976c899950SBaptiste Daroussin.An Patrick Lamaiziere Aq Mt patfbsd@davenulle.org .
98