summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/ubsec.4 4.html
blob: 3948f6256dae4f0a0b31fbc40e85fa39c92edde3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
<table class="head">
  <tr>
    <td class="head-ltitle">UBSEC(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">UBSEC(4)</td>
  </tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">ubsec</code> &#x2014; <span class="Nd">Broadcom
    and BlueSteel uBsec 5x0x crypto accelerator</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">ubsec* at pci? dev ? function ?</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">ubsec</code> driver supports cards containing
    any of the following chips:</p>
<div class="Bd-indent">
<dl class="Bl-tag">
  <dt>Bluesteel 5501</dt>
  <dd>The original chipset, no longer made. This extremely rare unit was not
      very fast, lacked an RNG, and had a number of other bugs.</dd>
  <dt>Broadcom BCM5801</dt>
  <dd>A BCM5805 without public key engine or random number generator.</dd>
  <dt>Broadcom BCM5802</dt>
  <dd>A slower version of the BCM5805.</dd>
  <dt>Broadcom BCM5805</dt>
  <dd>Faster version of Bluesteel 5601.</dd>
  <dt>Broadcom BCM5820</dt>
  <dd>64 bit version of the chip, and significantly more advanced.</dd>
  <dt>Broadcom BCM5821</dt>
  <dd>Faster version of the BCM5820. This is the chip found on the Sun Crypto
      Accelerator 1000.</dd>
  <dt>Broadcom BCM5822</dt>
  <dd>Faster version of the BCM5820.</dd>
  <dt>Broadcom BCM5823</dt>
  <dd>Faster version of the BCM5822 that also supports AES.</dd>
  <dt>Broadcom BCM5825</dt>
  <dd>Faster PCI Express or PCI-X version of the chip.</dd>
  <dt>Broadcom BCM5860</dt>
  <dd>IPSec/SSL Security Processor that is faster and has more features.</dd>
  <dt>Broadcom BCM5861</dt>
  <dd>Faster version of the BCM5860.</dd>
  <dt>Broadcom BCM5862</dt>
  <dd>Faster version of the BCM5861.</dd>
</dl>
</div>
<p class="Pp">The <code class="Nm">ubsec</code> driver registers itself to
    accelerate DES, Triple-DES, MD5, SHA1, MD5-HMAC, and SHA1-HMAC operations
    for <a class="Xr">opencrypto(9)</a>, and thus for <a class="Xr">ipsec(4)</a>
    and <a class="Xr">crypto(4)</a>. The driver also supports acceleration of
    AES-CBC with the BCM5823 or newer.</p>
<p class="Pp">On those models which contain a public key engine (almost all of
    the more recent ones), this feature is registered with the
    <a class="Xr">crypto(4)</a> subsystem.</p>
<p class="Pp">On all models except the Bluesteel 5501 and Broadcom 5801, the
    driver registers itself to provide random data to the
    <a class="Xr">rnd(4)</a> subsystem.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">crypto(4)</a>, <a class="Xr">intro(4)</a>,
    <a class="Xr">ipsec(4)</a>, <a class="Xr">rnd(4)</a>,
    <a class="Xr">opencrypto(9)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">ubsec</code> device driver appeared in
    <span class="Ux">OpenBSD 2.8</span>. The <code class="Nm">ubsec</code>
    device driver was imported to <span class="Ux">FreeBSD 5.0</span>,
    back-ported to <span class="Ux">FreeBSD 4.8</span>, and subsequently
    imported to <span class="Ux">NetBSD 2.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">The BCM5801 and BCM5802 have not actually been tested.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">June 13, 2018</td>
    <td class="foot-os">NetBSD 10.1</td>
  </tr>
</table>