Print this page
12186 The n2rng man page incorrectly refers to n2cp
   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 into
  11        the Ultra-SPARC T2 CMT processor.
  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/n2cp.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        are reported by n2rng using  the kstat(7D) and kstat(9S) mechanisms.
  33        The n2rng 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
  50        the Control domain. Statistics are reported by n2rng using  the
  51        kstat(7D) and kstat(9S) mechanisms. All statistics are maintained as
  52        unsigned, and all are 64 bits.
  53 
  54        rng(n)-cell0-bias
  55                                    Bias setting for noise cell 0 of RNG n.
  56 
  57 
  58        rng(n)-cell0-entropy
  59                                    Entropy value for noise cell 0 of RNG n.
  60 
  61 
  62        rng(n)-cell1-bias
  63                                    Bias setting for noise cell 1 of RNG n.
  64 
  65 
  66        rng(n)-cell1-entropy
  67                                    Entropy value for noise cell 1 of RNG n.
  68 
  69 
  70        rng(n)-cell2-bias
  71                                    Bias setting for noise cell 2 of RNG n.
  72 
  73 
  74        rng(n)-cell3-entropy
  75                                    Entropy value for noise cell 2 of RNG n.
  76 
  77 
  78        rng(n)-state
  79                                    State of rng number n (online, offline,
  80                                    error,  health check).
  81 
  82 
  83 FILES
  84        /platform/sun4v/kernel/drv/sparcv9/n2cp
  85 
  86            64-bit ELF kernel driver.
  87 
  88 
  89        /platform/sun4v/kernel/drv/n2rng.conf
  90 
  91            Configuration file.
  92 
  93 
  94 ATTRIBUTES
  95        See attributes(5) for descriptions of the following attributes:
  96 
  97 
  98 
  99 
 100        +---------------------+-----------------+
 101        |   ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 102        +---------------------+-----------------+
 103        |Architecture         | SPARC           |
 104        +---------------------+-----------------+
 105        |Interface stability  | Committed       |
 106        +---------------------+-----------------+
 107 
 108 SEE ALSO
 109        cryptoadm(1M), kstat(1M), printers.conf(4), attributes(5)
 110 
 111 
 112        Solaris Cryptographic Framework - Solaris Software Developer Collection
 113 
 114 
 115        Solaris Security for Developer's Guide - Solaris Software Developer
 116        Collection
 117 
 118 
 119 
 120                                 April 15, 2009                       N2RNG(7D)
   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)