Manual Pages for UNIX Operating System command usage for man n2rng

Devices                                                 n2rng(7d)



NAME
     n2rng - Ultra-SPARC T2 random number generator device driver

DESCRIPTION
     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 CMT processor.


     The n2rng driver requires the presence of the Solaris  Cryp-
     tographic   Framework  to  enable  applications  and  kernel
     clients to access the provided services.

CONFIGURATION
     You configure the n2rng driver  by  defining  properties  in
     /platform/sun4v/kernel/drv/n2cp.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.


CRYPTO STATISTICS
     Solaris crypto drivers must implement statistics  variables.
     Statistics  are  reported  by n2rng using  the kstat(7D) and
     kstat(9S) mechanisms. The n2rng driver maintains the follow-
     ing 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.


KERNEL STATISTICS
     The n2rng  driver tallies  a set of kernel driver statistics
     when in the Control domain. Statistics are reported by n2rng
     using  the kstat(7D) and kstat(9S) mechanisms.  All  statis-
     tics are maintained as unsigned, and all are 64 bits.

     rng(n)-cell0-bias           Bias setting for noise cell 0 of
                                 RNG n.




SunOS 5.11          Last change: 15 Apr 2009                    1






Devices                                                 n2rng(7d)



     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)-cell3-entropy        Entropy value for noise  cell  2
                                 of RNG n.


     rng(n)-state                State of rng number  n  (online,
                                 offline, error,  health check).


FILES
     /platform/sun4v/kernel/drv/sparcv9/n2cp

         64-bit ELF kernel driver.


     /platform/sun4v/kernel/drv/n2rng.conf

         Configuration file.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

















SunOS 5.11          Last change: 15 Apr 2009                    2






Devices                                                 n2rng(7d)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Architecture                | SPARC                       |
    |_____________________________|_____________________________|
    | Availability                | system/kernel/platform      |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     cryptoadm(1M), kstat(1M), printers.conf(4), attributes(5)


     Solaris Cryptographic Framework - Solaris Software Developer
     Collection


     Solaris Security for Developer's Guide  -  Solaris  Software
     Developer Collection


































SunOS 5.11          Last change: 15 Apr 2009                    3