uonerng(4) a driver for the Moonbase Otago OneRNG, from Devin Reade.

ok deraadt@

3 files changed, 81 insertions, 4 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 111d8d160dd..cde50426b44 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.611 2016/01/07 11:31:12 mikeb Exp $
+#	$OpenBSD: Makefile,v 1.612 2016/01/08 09:36:59 mpi Exp $
 
 MAN=	aac.4 ac97.4 acphy.4 \
 	acpi.4 acpiac.4 acpiasus.4 acpibat.4 acpibtn.4 acpicpu.4 acpidock.4 \
@@ -61,7 +61,7 @@ MAN=	aac.4 ac97.4 acphy.4 \
 	uftdi.4 ugen.4 ugl.4 ugold.4 uguru.4 uhci.4 uhid.4 uhidev.4 uipaq.4 \
 	uk.4 ukbd.4 \
 	ukphy.4 ulpt.4 umass.4 umbg.4 umcs.4 umct.4 umidi.4 umodem.4 ums.4 \
-	umsm.4 unix.4 uow.4 uoaklux.4 uoakrh.4 uoakv.4 upd.4 \
+	umsm.4 unix.4 uonerng.4 uow.4 uoaklux.4 uoakrh.4 uoakv.4 upd.4 \
 	upgt.4 upl.4 uplcom.4 ural.4 url.4 urlphy.4 \
 	urndis.4 urtw.4 urtwn.4 usb.4  usbf.4 uscom.4 uslcom.4 usps.4 \
 	uthum.4 uticom.4 utpms.4 utwitch.4 utrh.4 uts.4 uvideo.4 uvisor.4 \
diff --git a/share/man/man4/uonerng.4 b/share/man/man4/uonerng.4
new file mode 100644
index 00000000000..ab6b74bfa90
--- /dev/null
+++ b/share/man/man4/uonerng.4
@@ -0,0 +1,75 @@
+.\"	$OpenBSD: uonerng.4,v 1.1 2016/01/08 09:36:59 mpi Exp $
+.\"
+.\" Copyright (c) 2015 Devin Reade <gdr@gno.org>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: January 8 2016 $
+.Dt ONERNG 4
+.Os
+.Sh NAME
+.Nm uonerng
+.Nd Moonbase Otago OneRNG TRNG
+.Sh SYNOPSIS
+.Cd "uonerng* at uhub?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the Moonbase Otago OneRNG, a USB true random
+number generator (TRNG).
+.Nm
+reads raw entropy from the OneRNG and uses
+.Xr add_true_randomness 9
+to add it to the system entropy pool.
+.Sh IMPLEMENTATION NOTES
+The OneRNG is capable of operating in one of several modes, some of
+which are intended for production use and some of which are for testing
+and validating the hardware.
+.Pp
+.Nm
+operates in the
+.Do
+Avalanche noise with whitener
+.Dc
+mode, which is also the manufacturer
+.Ap s
+default mode.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr usb 4 ,
+.Xr add_true_randomness 9
+.Pp
+Moonbase Otago:
+.Lk http://onerng.info/onerng
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 5.9 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Devin Reade Aq Mt gdr@gno.org .
+.Sh BUGS
+The OneRNG permits downloading the device firmware so that one may check
+the firmware
+.Ap s
+cryptographic signature as provided by the manufacturer.  The
+.Nm
+driver does not perform nor support this action.  In order to currently
+perform such a validation, it would be necessary to disable
+.Nm
+in the kernel and then download the firmware via the OneRNG
+.Ap s
+emulated AT modem command set.
diff --git a/share/man/man4/usb.4 b/share/man/man4/usb.4
index e21c94a595f..63503ed440a 100644
--- a/share/man/man4/usb.4
+++ b/share/man/man4/usb.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: usb.4,v 1.170 2015/11/21 08:04:20 jmc Exp $
+.\"	$OpenBSD: usb.4,v 1.171 2016/01/08 09:36:59 mpi Exp $
 .\"	$NetBSD: usb.4,v 1.15 1999/07/29 14:20:32 augustss Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
@@ -28,7 +28,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: November 21 2015 $
+.Dd $Mdocdate: January 8 2016 $
 .Dt USB 4
 .Os
 .Sh NAME
@@ -286,6 +286,8 @@ USB generic device support
 Genesys Logic based host-to-host adapters
 .It Xr ugold 4
 TEMPer gold HID thermometer and hygrometer
+.It Xr uonerng 4
+Moonbase Otago OneRNG TRNG
 .It Xr uow 4
 Maxim/Dallas DS2490 USB 1-Wire adapter
 .It Xr upl 4