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