1 N2RNG(7D)                           Devices                          N2RNG(7D)
   2 
   3 
   4 
   5 NAME
   6        n2rng - Ultra-SPARC T2 random number generator device driver
   7 
   8 DESCRIPTION
   9        The n2rng device driver is a multi-threaded, loadable hardware driver
  10        supporting hardware assisted random numbers.  This support is built
  11        into the Ultra-SPARC T2 and later processors.
  12 
  13 
  14        The n2rng driver requires the presence of the Solaris Cryptographic
  15        Framework to enable applications and kernel clients to access the
  16        provided services.
  17 
  18 CONFIGURATION
  19        You configure the n2rng driver by defining properties in
  20        /platform/sun4v/kernel/drv/n2rng.conf which override the default
  21        settings.  The following property is supported:
  22 
  23        nostats
  24                                    Disables the generation of statistics.  The
  25                                    nostats property may be used to help
  26                                    prevent traffic analysis, however, this may
  27                                    inhibit support personnel.
  28 
  29 
  30 CRYPTO STATISTICS
  31        Solaris crypto drivers must implement statistics variables.  Statistics
  32        reported by n2rng may be read using the kstat(1M) utility.  The n2rng
  33        driver maintains the following statistics:
  34 
  35        status
  36                                    Status (online, offline, fail) of RNG
  37                                    device.
  38 
  39 
  40        rngjobs
  41                                    Number of requests for random data.
  42 
  43 
  44        rngbytes
  45                                    Number of bytes read from the RNG device.
  46 
  47 
  48 KERNEL STATISTICS
  49        The n2rng driver tallies a set of kernel driver statistics when in the
  50        Control domain.  Statistics reported by n2rng may be read using the
  51        kstat(1M) utility.
  52 
  53        rng(n)-cell0-bias
  54                                    Bias setting for noise cell 0 of RNG n.
  55 
  56 
  57        rng(n)-cell0-entropy
  58                                    Entropy value for noise cell 0 of RNG n.
  59 
  60 
  61        rng(n)-cell1-bias
  62                                    Bias setting for noise cell 1 of RNG n.
  63 
  64 
  65        rng(n)-cell1-entropy
  66                                    Entropy value for noise cell 1 of RNG n.
  67 
  68 
  69        rng(n)-cell2-bias
  70                                    Bias setting for noise cell 2 of RNG n.
  71 
  72 
  73        rng(n)-cell2-entropy
  74                                    Entropy value for noise cell 2 of RNG n.
  75 
  76 
  77        rng(n)-state
  78                                    State of rng number n (online, offline,
  79                                    error, health check).
  80 
  81 
  82 FILES
  83        /platform/sun4v/kernel/drv/sparcv9/n2rng
  84 
  85            Device driver (SPARC)
  86 
  87 
  88        /platform/sun4v/kernel/drv/n2rng.conf
  89 
  90            Driver configuration file
  91 
  92 
  93 ATTRIBUTES
  94        See attributes(5) for descriptions of the following attributes:
  95 
  96 
  97 
  98 
  99        +---------------------+-----------------+
 100        |   ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 101        +---------------------+-----------------+
 102        |Architecture         | SPARC           |
 103        +---------------------+-----------------+
 104        |Interface stability  | Committed       |
 105        +---------------------+-----------------+
 106 
 107 SEE ALSO
 108        cryptoadm(1M), kstat(1M), attributes(5)
 109 
 110 
 111 
 112                                January 12, 2020                      N2RNG(7D)