n2rng - Ultra-SPARC T2 random number generator device driver
The n2rng device driver is a multi-threaded, loadable hardware driver
supporting hardware assisted random numbers. This support is built into the
Ultra-SPARC T2 and later processors.
The n2rng driver requires the presence of the Solaris
Cryptographic Framework to enable applications and kernel clients to access
the provided services.
You configure the n2rng driver by defining properties in
/platform/sun4v/kernel/drv/n2rng.conf which override the default
settings. The following property is supported:
nostats
Disables the generation of statistics. The nostats
property may be used to help prevent traffic analysis, however, this may
inhibit support personnel.
Solaris crypto drivers must implement statistics variables. Statistics reported
by n2rng may be read using the kstat(1M) utility. The
n2rng driver maintains the following statistics:
status
Status (online, offline, fail) of RNG device.
rngjobs
Number of requests for random data.
rngbytes
Number of bytes read from the RNG device.
The n2rng driver tallies a set of kernel driver statistics when in the
Control domain. Statistics reported by n2rng may be read using the
kstat(1M) utility.
rng(n)-cell0-bias
Bias setting for noise cell 0 of RNG n.
rng(n)-cell0-entropy
Entropy value for noise cell 0 of RNG n.
rng(n)-cell1-bias
Bias setting for noise cell 1 of RNG n.
rng(n)-cell1-entropy
Entropy value for noise cell 1 of RNG n.
rng(n)-cell2-bias
Bias setting for noise cell 2 of RNG n.
rng(n)-cell2-entropy
Entropy value for noise cell 2 of RNG n.
rng(n)-state
State of rng number n (online, offline, error, health
check).
/platform/sun4v/kernel/drv/sparcv9/n2rng
Device driver (SPARC)
/platform/sun4v/kernel/drv/n2rng.conf
Driver configuration file
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE
TYPE |
ATTRIBUTE VALUE |
Architecture |
SPARC |
Interface stability |
Committed |
cryptoadm(1M), kstat(1M), attributes(5)