1n2rng(7d)                           Devices                          n2rng(7d)
2
3
4

NAME

6       n2rng - Ultra-SPARC T2 random number generator device driver
7

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  pro‐
16       vided services.
17

CONFIGURATION

19       You  configure  the  n2rng  driver  by  defining  properties  in /plat‐
20       form/sun4v/kernel/drv/n2cp.conf which override  the  default  settings.
21       The following property is supported:
22
23       nostats                     Disables  the generation of statistics. The
24                                   nostats property may be used to  help  pre‐
25                                   vent  traffic  analysis,  however, this may
26                                   inhibit support personnel.
27
28

CRYPTO STATISTICS

30       Solaris crypto drivers must implement statistics variables.  Statistics
31       are  reported  by  n2rng using  the kstat(7D) and kstat(9S) mechanisms.
32       The n2rng driver maintains the following statistics:
33
34       status                      Status  (online,  offline,  fail)  of   RNG
35                                   device.
36
37
38       rngjobs                     Number of requests for random data.
39
40
41       rngbytes                    Number of bytes read from the RNG device.
42
43

KERNEL STATISTICS

45       The  n2rng   driver  tallies  a set of kernel driver statistics when in
46       the Control  domain.  Statistics  are  reported  by  n2rng  using   the
47       kstat(7D)  and  kstat(9S)  mechanisms. All statistics are maintained as
48       unsigned, and all are 64 bits.
49
50       rng(n)-cell0-bias           Bias setting for noise cell 0 of RNG n.
51
52
53       rng(n)-cell0-entropy        Entropy value for noise cell 0 of RNG n.
54
55
56       rng(n)-cell1-bias           Bias setting for noise cell 1 of RNG n.
57
58
59       rng(n)-cell1-entropy        Entropy value for noise cell 1 of RNG n.
60
61
62       rng(n)-cell2-bias           Bias setting for noise cell 2 of RNG n.
63
64
65       rng(n)-cell3-entropy        Entropy value for noise cell 2 of RNG n.
66
67
68       rng(n)-state                State of rng  number  n  (online,  offline,
69                                   error,  health check).
70
71

FILES

73       /platform/sun4v/kernel/drv/sparcv9/n2cp
74
75           64-bit ELF kernel driver.
76
77
78       /platform/sun4v/kernel/drv/n2rng.conf
79
80           Configuration file.
81
82

ATTRIBUTES

84       See attributes(5) for descriptions of the following attributes:
85
86
87
88
89       ┌─────────────────────────────┬─────────────────────────────┐
90       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
91       ├─────────────────────────────┼─────────────────────────────┤
92       │Architecture                 │SPARC                        │
93       ├─────────────────────────────┼─────────────────────────────┤
94       │Availability                 │SUNWcakr.v                   │
95       ├─────────────────────────────┼─────────────────────────────┤
96       │Interface stability          │Committed                    │
97       └─────────────────────────────┴─────────────────────────────┘
98

SEE ALSO

100       cryptoadm(1M), kstat(1M), printers.conf(4), attributes(5)
101
102
103       Solaris Cryptographic Framework - Solaris Software Developer Collection
104
105
106       Solaris  Security  for  Developer's  Guide - Solaris Software Developer
107       Collection
108
109
110
111SunOS 5.11                        15 Apr 2009                        n2rng(7d)
Impressum