Print this page
11621 fmadm and fmstat document privileges incorrectly
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/fmstat.1m.man.txt
+++ new/usr/src/man/man1m/fmstat.1m.man.txt
1 1 FMSTAT(1M) Maintenance Commands FMSTAT(1M)
2 2
3 3
|
↓ open down ↓ |
3 lines elided |
↑ open up ↑ |
4 4
5 5 NAME
6 6 fmstat - report fault management module statistics
7 7
8 8 SYNOPSIS
9 9 fmstat [-astTz] [-d u | d ] [-m module] [interval [count]]
10 10
11 11
12 12 DESCRIPTION
13 13 The fmstat utility can be used by administrators and service personnel
14 - to report statistics associated with the Solaris Fault Manager, fmd(1M)
15 - and its associated set of modules. The Fault Manager runs in the
16 - background on each Solaris system. It receives telemetry information
17 - relating to problems detected by the system software, diagnoses these
18 - problems, and initiates proactive self-healing activities such as
19 - disabling faulty components.
14 + to report statistics associated with the Fault Manager, fmd(1M) and its
15 + associated set of modules. The Fault Manager runs in the background on
16 + each system. It receives telemetry information relating to problems
17 + detected by the system software, diagnoses these problems, and
18 + initiates proactive self-healing activities such as disabling faulty
19 + components.
20 20
21 21
22 22 You can use fmstat to view statistics for diagnosis engines and agents
23 23 that are currently participating in fault management. The documentation
24 24 for fmd(1M), fmadm(1M), and fmdump(1M) describes more about tools to
25 25 observe fault management activities.
26 26
27 27
28 28 If the -m option is present or the -t option is present, fmstat reports
29 29 any statistics kept by the specified fault management module. The
30 30 module list can be obtained using fmadm config.
31 31
32 32
33 33 If the -m option is not present, fmstat reports the following
34 34 statistics for each of its client modules:
35 35
36 36 module
37 37 The name of the fault management module, as reported by
38 38 fmadm config.
39 39
40 40
41 41 ev_recv
42 42 The number of telemetry events received by the module.
43 43
44 44
45 45 ev_acpt
46 46 The number of events accepted by the module as relevant to a
47 47 diagnosis.
48 48
49 49
50 50 wait
51 51 The average number of telemetry events waiting to be
52 52 examined by the module.
53 53
54 54
55 55 svc_t
56 56 The average service time for telemetry events received by
57 57 the module, in milliseconds.
58 58
59 59
60 60 %w
61 61 The percentage of time that there were telemetry events
62 62 waiting to be examined by the module.
63 63
64 64
65 65 %b
66 66 The percentage of time that the module was busy processing
67 67 telemetry events.
68 68
69 69
70 70 open
71 71 The number of active cases (open problem investigations)
72 72 owned by the module.
73 73
74 74
75 75 solve
76 76 The total number of cases solved by this module since it was
77 77 loaded.
78 78
79 79
80 80 memsz
|
↓ open down ↓ |
51 lines elided |
↑ open up ↑ |
81 81 The amount of dynamic memory currently allocated by this
82 82 module.
83 83
84 84
85 85 bufsz
86 86 The amount of persistent buffer space currently allocated by
87 87 this module.
88 88
89 89
90 90
91 - The fmstat utility requires the user to posses the SYS_CONFIG
92 - privilege. Refer to the for more information about how to configure
93 - Solaris privileges.
91 + The fmstat utility requires the user to possess the PRIV_SYS_ADMIN
92 + privilege. See privileges(5).
94 93
95 94 OPTIONS
96 95 The following options are supported:
97 96
98 97 -a
99 98 Print all statistics for a module, including those kept on
100 99 its behalf by fmd. If the -a option is not present, only
101 100 those statistics kept by the module are reported. If the
102 101 -a option is used without the -m module, a set of global
103 102 statistics associated with fmd are displayed.
104 103
105 104
106 105 -d u | d
107 106 Display a time stamp.
108 107
109 108 Specify u for a printed representation of the internal
110 109 representation of time. See time(2). Specify d for
111 110 standard date format. See date(1).
112 111
113 112
114 113 -m module
115 114 Print a report on the statistics associated with the
116 115 specified fault management module, instead of the default
117 116 statistics report. Modules can publish an arbitrary set of
118 117 statistics to help Sun service the fault management
119 118 software itself. The module statistics constitute a
120 119 Private interface. See attributes(5) for information on
121 120 Sun's rules for Private interfaces. Scripts should not be
122 121 written that depend upon the values of fault management
123 122 module statistics as they can change without notice.
124 123
125 124
126 125 -s
127 126 Print a report on Soft Error Rate Discrimination (SERD)
128 127 engines associated with the module instead of the default
129 128 module statistics report. A SERD engine is a construct
130 129 used by fault management software to determine if a
131 130 statistical threshold measured as N events in some time T
132 131 has been exceeded. The -s option can only be used in
133 132 combination with the -m option.
134 133
135 134
136 135 -t
137 136 Print a report on the statistics associated with each
138 137 fault management event transport. Each fault management
139 138 module can provide the implementation of one or more event
140 139 transports.
141 140
142 141
143 142 -T
144 143 Print a table of the authority information associated with
145 144 each fault management event transport. If the -m option is
146 145 present, only transports associated with the specified
147 146 module are displayed.
148 147
149 148
150 149 -z
151 150 Omit statistics with a zero value from the report
152 151 associated with the specified fault management module. The
153 152 -z option can only be used in combination with the -m
154 153 option.
155 154
156 155
157 156 OPERANDS
158 157 The following operands are supported:
159 158
160 159 count
161 160 Print only count reports, and then exit.
162 161
163 162
164 163 interval
165 164 Print a new report every interval seconds.
166 165
167 166
168 167
169 168 If no interval and no count are specified, a single report is printed
170 169 and fmstat exits. If an interval is specified but no count is
171 170 specified, fmstat prints reports every interval seconds indefinitely
172 171 until the command is interrupted.
173 172
174 173 EXIT STATUS
175 174 The following exit values are returned:
176 175
177 176 0
178 177 Successful completion.
179 178
180 179
181 180 1
182 181 A fatal error occurred. A fatal error could be the failure to
183 182 communicate with fmd(1M). It could also be that insufficient
184 183 privileges were available to perform the requested operation.
185 184
186 185
187 186 2
188 187 Invalid command-line options were specified.
189 188
190 189
191 190 ATTRIBUTES
192 191 See attributes(5) for descriptions of the following attributes:
193 192
194 193
195 194
196 195
197 196 +--------------------+-----------------+
|
↓ open down ↓ |
94 lines elided |
↑ open up ↑ |
198 197 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
199 198 +--------------------+-----------------+
200 199 |Interface Stability | See below. |
201 200 +--------------------+-----------------+
202 201
203 202
204 203 The command-line options are Evolving. The human-readable default
205 204 report is Unstable. The human-readable module report is Private.
206 205
207 206 SEE ALSO
208 - fmadm(1M), fmd(1M), fmdump(1M), attributes(5)
207 + fmadm(1M), fmd(1M), fmdump(1M), attributes(5), privileges(5)
209 208
210 209
211 210
212 -
213 -
214 - June 16, 2009 FMSTAT(1M)
211 + August 26, 2019 FMSTAT(1M)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX