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
     /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.


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: 20 Oct 208                    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
     /kernel/drv/sparcv9/n2rng

         64-bit ELF kernel driver.


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

         Configuration file.


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

















SunOS 5.11           Last change: 20 Oct 208                    2






Devices                                                 n2rng(7d)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 SPARC                       
    
     Availability                 SUNWcakr.v                  
    
     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: 20 Oct 208                    3