summaryrefslogtreecommitdiff
path: root/static/openbsd/man4/uonerng.4
diff options
context:
space:
mode:
Diffstat (limited to 'static/openbsd/man4/uonerng.4')
-rw-r--r--static/openbsd/man4/uonerng.471
1 files changed, 71 insertions, 0 deletions
diff --git a/static/openbsd/man4/uonerng.4 b/static/openbsd/man4/uonerng.4
new file mode 100644
index 00000000..a2ff7d06
--- /dev/null
+++ b/static/openbsd/man4/uonerng.4
@@ -0,0 +1,71 @@
+.\" $OpenBSD: uonerng.4,v 1.4 2022/02/18 10:24:32 jsg 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: February 18 2022 $
+.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 enqueue_randomness 9
+to add it to the system entropy pool.
+.Pp
+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
+.Qq Avalanche noise with whitener
+mode,
+which is also the manufacturer's default mode.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr usb 4 ,
+.Xr enqueue_randomness 9
+.Pp
+Moonbase Otago:
+.Lk https://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 of the device firmware so that one may check
+the firmware'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's
+emulated AT modem command set.