xref: /freebsd/share/man/man4/man4.i386/glxsb.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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.\"
17*40326c17SJohn-Mark Gurney.Dd July 29, 2020
18edd30e9cSPhilip Paeps.Dt GLXSB 4 i386
19edd30e9cSPhilip Paeps.Os
20edd30e9cSPhilip Paeps.Sh NAME
21edd30e9cSPhilip Paeps.Nm glxsb
22edd30e9cSPhilip Paeps.Nd Geode LX Security Block crypto accelerator
23edd30e9cSPhilip Paeps.Sh SYNOPSIS
24edd30e9cSPhilip PaepsTo compile this driver into the kernel,
25edd30e9cSPhilip Paepsplace the following lines in your
26edd30e9cSPhilip Paepskernel configuration file:
27edd30e9cSPhilip Paeps.Bd -ragged -offset indent
28edd30e9cSPhilip Paeps.Cd "device crypto"
29edd30e9cSPhilip Paeps.Cd "device glxsb"
30edd30e9cSPhilip Paeps.Ed
31edd30e9cSPhilip Paeps.Pp
32edd30e9cSPhilip PaepsAlternatively, to load the driver as a
33edd30e9cSPhilip Paepsmodule at boot time, place the following line in
34edd30e9cSPhilip Paeps.Xr loader.conf 5 :
35edd30e9cSPhilip Paeps.Bd -literal -offset indent
36edd30e9cSPhilip Paepsglxsb_load="YES"
37edd30e9cSPhilip Paeps.Ed
38edd30e9cSPhilip Paeps.Sh DESCRIPTION
39edd30e9cSPhilip PaepsThe
40edd30e9cSPhilip Paeps.Nm
41edd30e9cSPhilip Paepsdriver supports the security block of the Geode LX series processors.
42edd30e9cSPhilip PaepsThe Geode LX is a member of the AMD Geode family
43edd30e9cSPhilip Paepsof integrated x86 system chips.
44edd30e9cSPhilip Paeps.Pp
45edd30e9cSPhilip PaepsDriven by periodic checks for available data from the generator,
46edd30e9cSPhilip Paeps.Nm
47edd30e9cSPhilip Paepssupplies entropy to the
48edd30e9cSPhilip Paeps.Xr random 4
49edd30e9cSPhilip Paepsdriver for common usage.
50edd30e9cSPhilip Paeps.Pp
51edd30e9cSPhilip Paeps.Nm
52edd30e9cSPhilip Paepsalso supports acceleration of AES-128-CBC operations for
53edd30e9cSPhilip Paeps.Xr crypto 4 .
542c97c274SChristian BruefferIt also registers itself to accelerate other HMAC algorithms, although
55edd30e9cSPhilip Paepsthere is no hardware acceleration for those algorithms.
56edd30e9cSPhilip PaepsThis is only needed so
57edd30e9cSPhilip Paeps.Nm
58edd30e9cSPhilip Paepscan work with
59edd30e9cSPhilip Paeps.Xr ipsec 4 .
60edd30e9cSPhilip Paeps.Sh CAVEAT
61edd30e9cSPhilip PaepsThe
62edd30e9cSPhilip Paeps.Xr crypto 9
63edd30e9cSPhilip Paepsframework will fail to open the crypto session on the device if the AES
642c97c274SChristian Bruefferkey's length is != 128 bits.
652c97c274SChristian BruefferThis prevents the use of the
66edd30e9cSPhilip Paeps.Nm
672c97c274SChristian Bruefferdevice driver with AES keys of length != 128 bits.
68edd30e9cSPhilip Paeps.Sh SEE ALSO
69edd30e9cSPhilip Paeps.Xr crypto 4 ,
70edd30e9cSPhilip Paeps.Xr intro 4 ,
71edd30e9cSPhilip Paeps.Xr ipsec 4 ,
72068b48d6SJoel Dahl.Xr pci 4 ,
73edd30e9cSPhilip Paeps.Xr random 4 ,
74*40326c17SJohn-Mark Gurney.Xr crypto 7 ,
75edd30e9cSPhilip Paeps.Xr crypto 9
76edd30e9cSPhilip Paeps.Sh HISTORY
77edd30e9cSPhilip PaepsThe
78edd30e9cSPhilip Paeps.Nm
79edd30e9cSPhilip Paepsdevice driver first appeared in
80edd30e9cSPhilip Paeps.Ox 4.1 .
81edd30e9cSPhilip PaepsThe
82edd30e9cSPhilip Paeps.Nm
832c97c274SChristian Bruefferdevice driver was imported into
842a72feb4SChristian Brueffer.Fx 7.1 .
85edd30e9cSPhilip Paeps.Sh AUTHORS
86edd30e9cSPhilip Paeps.An -nosplit
87edd30e9cSPhilip PaepsThe
88edd30e9cSPhilip Paeps.Nm
89edd30e9cSPhilip Paepsdevice driver was written for
90edd30e9cSPhilip Paeps.Ox
91edd30e9cSPhilip Paepsby
92edd30e9cSPhilip Paeps.An Tom Cosgrove .
93edd30e9cSPhilip PaepsIt was ported to
94edd30e9cSPhilip Paeps.Fx
95edd30e9cSPhilip Paepsby
966c899950SBaptiste Daroussin.An Patrick Lamaiziere Aq Mt patfbsd@davenulle.org .
97