ONERNG(4)

💖 ONERNG(4) 💖

okay bestie, this is the ONERNG(4) page from the Kernel Interfaces Manual, and it’s literally all about the uonerng driver. 🦋

✨ NAME ✨

• uonerng — the Moonbase Otago OneRNG TRNG driver. That’s a USB true random number generator, and yes it’s giving entropy icon energy. 🎀

🦋 SYNOPSIS 🦋

uonerng* at uhub?

🌸 DESCRIPTION 🌸

okay so the uonerng driver is the support system for the Moonbase Otago OneRNG, a USB true random number generator (TRNG). It reads raw entropy from the OneRNG and uses enqueue_randomness(9) to add that entropy into the system entropy pool. 🔥

The OneRNG can operate in one of several modes. Some are intended for production use, and some are for testing and validating the hardware. (No, don’t mix them up, bestie.)

uonerng operates in the "Avalanche noise with whitener" mode. That’s also the manufacturer's default mode, so it’s the main character setting. 💅

🔎 SEE ALSO 🔎

• intro(4)
• usb(4)
• enqueue_randomness(9)
• Moonbase Otago: https://onerng.info/onerng

⭐ HISTORY ⭐

The uonerng driver first appeared in OpenBSD 5.9. a true era, honestly. 🫶

🎀 AUTHORS 🎀

The uonerng driver was written by Devin Reade <gdr@gno.org>. slay. 👑

💀 BUGS 💀

The OneRNG permits downloading of the device firmware so that one may check the firmware's cryptographic signature as provided by the manufacturer. But the uonerng driver does not perform nor support this action. Not me expecting the driver to do firmware validation. 🙈

So, to currently perform such a validation, it would be necessary to disable uonerng in the kernel and then download the firmware via the OneRNG's emulated AT modem command set. That’s the whole caveat, and it’s important, so don’t skip it. 😭

---

xoxo, Debian 💖 February 18, 2022 — that’s the source/version and date energy at the very end, bestie. 🫶