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)
--- EOF ---