]>
Commit | Line | Data |
---|---|---|
3147e0d3 AL |
1 | .TH DEVLINK\-HEALTH 8 "20 Feb 2019" "iproute2" "Linux" |
2 | .SH NAME | |
3 | devlink-health \- devlink health reporting and recovery | |
4 | .SH SYNOPSIS | |
5 | .sp | |
6 | .ad l | |
7 | .in +8 | |
8 | .ti -8 | |
9 | .B devlink | |
10 | .RI "[ " OPTIONS " ]" | |
11 | .B health | |
12 | .RI " { " COMMAND " | " | |
13 | .BR help " }" | |
14 | .sp | |
15 | ||
16 | .ti -8 | |
17 | .IR OPTIONS " := { " | |
18 | \fB\-V\fR[\fIersion\fR] } | |
19 | ||
20 | .ti -8 | |
860a5d12 | 21 | .B devlink health show |
1fe8c44b | 22 | .RI "[ { " DEV " | " DEV/PORT_INDEX " }" |
3147e0d3 AL |
23 | .B reporter |
24 | .RI ""REPORTER " ] " | |
25 | ||
26 | .ti -8 | |
860a5d12 | 27 | .B devlink health recover |
1fe8c44b | 28 | .RI "{ " DEV " | " DEV/PORT_INDEX " }" |
3147e0d3 AL |
29 | .B reporter |
30 | .RI "" REPORTER "" | |
31 | ||
32 | .ti -8 | |
860a5d12 | 33 | .B devlink health diagnose |
1fe8c44b | 34 | .RI "{ " DEV " | " DEV/PORT_INDEX " }" |
3147e0d3 AL |
35 | .B reporter |
36 | .RI "" REPORTER "" | |
37 | ||
38 | .ti -8 | |
860a5d12 | 39 | .B devlink health dump show |
1fe8c44b | 40 | .RI "{ " DEV " | " DEV/PORT_INDEX " }" |
3147e0d3 AL |
41 | .B reporter |
42 | .RI "" REPORTER "" | |
43 | ||
44 | .ti -8 | |
860a5d12 | 45 | .B devlink health dump clear |
1fe8c44b | 46 | .RI "{ " DEV " | " DEV/PORT_INDEX " }" |
3147e0d3 AL |
47 | .B reporter |
48 | .RI "" REPORTER "" | |
49 | ||
50 | .ti -8 | |
860a5d12 | 51 | .B devlink health set |
1fe8c44b | 52 | .RI "{ " DEV " | " DEV/PORT_INDEX " }" |
3147e0d3 AL |
53 | .B reporter |
54 | .RI "" REPORTER "" | |
860a5d12 | 55 | [ |
90ce848b | 56 | .BI "grace_period " MSEC " |
860a5d12 | 57 | ] [ |
90ce848b | 58 | .BR auto_recover " { " true " | " false " } " |
860a5d12 | 59 | ] [ |
4aa0c9c9 | 60 | .BR auto_dump " { " true " | " false " } " |
860a5d12 | 61 | ] |
90ce848b | 62 | |
3147e0d3 AL |
63 | .ti -8 |
64 | .B devlink health help | |
65 | ||
66 | .SH "DESCRIPTION" | |
1fe8c44b VT |
67 | .SS devlink health show - Show status and configuration on all supported reporters. |
68 | Displays info about reporters registered on devlink devices and ports. | |
3147e0d3 AL |
69 | |
70 | .PP | |
71 | .I "DEV" | |
72 | - specifies the devlink device. | |
1fe8c44b VT |
73 | .br |
74 | .I DEV/PORT_INDEX | |
75 | - specifies the devlink port. | |
3147e0d3 AL |
76 | |
77 | .PP | |
78 | .I "REPORTER" | |
1fe8c44b | 79 | - specifies the reporter's name registered on specified devlink device or port. |
3147e0d3 AL |
80 | |
81 | .SS devlink health recover - Initiate a recovery operation on a reporter. | |
82 | This action performs a recovery and increases the recoveries counter on success. | |
83 | ||
84 | .PP | |
85 | .I "DEV" | |
86 | - specifies the devlink device. | |
1fe8c44b VT |
87 | .br |
88 | .I DEV/PORT_INDEX | |
89 | - specifies the devlink port. | |
3147e0d3 AL |
90 | |
91 | .PP | |
92 | .I "REPORTER" | |
1fe8c44b | 93 | - specifies the reporter's name registered on specified devlink device or port. |
3147e0d3 AL |
94 | |
95 | .SS devlink health diagnose - Retrieve diagnostics data on a reporter. | |
96 | ||
97 | .PP | |
1fe8c44b | 98 | .I DEV |
3147e0d3 | 99 | - specifies the devlink device. |
1fe8c44b VT |
100 | .br |
101 | .I DEV/PORT_INDEX | |
102 | - specifies the devlink port. | |
3147e0d3 AL |
103 | |
104 | .PP | |
105 | .I "REPORTER" | |
1fe8c44b | 106 | - specifies the reporter's name registered on specified devlink device or port. |
3147e0d3 AL |
107 | |
108 | .SS devlink health dump show - Display the last saved dump. | |
109 | ||
110 | .PD 0 | |
111 | .P | |
112 | devlink health saves a single dump per reporter. If an dump is | |
113 | .P | |
114 | not already stored by the Devlink, this command will generate a new | |
115 | .P | |
116 | dump. The dump can be generated either automatically when a | |
117 | .P | |
118 | reporter reports on an error or manually at the user's request. | |
119 | .PD | |
120 | ||
121 | .PP | |
122 | .I "DEV" | |
123 | - specifies the devlink device. | |
1fe8c44b VT |
124 | .br |
125 | .I DEV/PORT_INDEX | |
126 | - specifies the devlink port. | |
3147e0d3 AL |
127 | |
128 | .PP | |
129 | .I "REPORTER" | |
1fe8c44b | 130 | - specifies the reporter's name registered on specified devlink device or port. |
3147e0d3 AL |
131 | |
132 | .SS devlink health dump clear - Delete the saved dump. | |
133 | Deleting the saved dump enables a generation of a new dump on | |
134 | .PD 0 | |
135 | .P | |
136 | the next "devlink health dump show" command. | |
137 | .PD | |
138 | ||
139 | .PP | |
140 | .I "DEV" | |
141 | - specifies the devlink device. | |
1fe8c44b VT |
142 | .br |
143 | .I DEV/PORT_INDEX | |
144 | - specifies the devlink port. | |
3147e0d3 AL |
145 | |
146 | .PP | |
147 | .I "REPORTER" | |
1fe8c44b | 148 | - specifies the reporter's name registered on specified devlink device or port. |
3147e0d3 | 149 | |
90ce848b | 150 | .SS devlink health set - Configure health reporter. |
4aa0c9c9 EBE |
151 | Please note that some params are not supported on a reporter which |
152 | doesn't support a recovery or dump method. | |
3147e0d3 AL |
153 | |
154 | .PP | |
155 | .I "DEV" | |
156 | - specifies the devlink device. | |
1fe8c44b VT |
157 | .br |
158 | .I DEV/PORT_INDEX | |
159 | - specifies the devlink port. | |
3147e0d3 AL |
160 | |
161 | .PP | |
162 | .I "REPORTER" | |
1fe8c44b | 163 | - specifies the reporter's name registered on specified devlink device or port. |
3147e0d3 | 164 | |
90ce848b JP |
165 | .TP |
166 | .BI grace_period " MSEC " | |
167 | Time interval between consecutive auto recoveries. | |
168 | ||
169 | .TP | |
170 | .BR auto_recover " { " true " | " false " } " | |
171 | Indicates whether the devlink should execute automatic recover on error. | |
172 | ||
4aa0c9c9 EBE |
173 | .TP |
174 | .BR auto_dump " { " true " | " false " } " | |
175 | Indicates whether the devlink should execute automatic dump on error. | |
176 | ||
3147e0d3 AL |
177 | .SH "EXAMPLES" |
178 | .PP | |
179 | devlink health show | |
180 | .RS 4 | |
1fe8c44b VT |
181 | List status and configuration of available reporters on devices and ports. |
182 | .RE | |
183 | .PP | |
184 | devlink health show pci/0000:00:09.0/1 reporter tx | |
185 | .RS 4 | |
186 | List status and configuration of tx reporter registered on port on pci/0000:00:09.0/1 | |
3147e0d3 AL |
187 | .RE |
188 | .PP | |
1fe8c44b | 189 | devlink health recover pci/0000:00:09.0 reporter fw_fatal |
3147e0d3 | 190 | .RS 4 |
1fe8c44b | 191 | Initiate recovery on fw_fatal reporter registered on device on pci/0000:00:09.0. |
3147e0d3 AL |
192 | .RE |
193 | .PP | |
1fe8c44b VT |
194 | devlink health recover pci/0000:00:09.0/1 reporter tx |
195 | .RS 4 | |
196 | Initiate recovery on tx reporter registered on port on pci/0000:00:09.0/1. | |
197 | .RE | |
198 | .PP | |
199 | devlink health diagnose pci/0000:00:09.0 reporter fw | |
3147e0d3 AL |
200 | .RS 4 |
201 | List diagnostics data on the specified device and reporter. | |
202 | .RE | |
203 | .PP | |
1fe8c44b | 204 | devlink health dump show pci/0000:00:09.0/1 reporter tx |
3147e0d3 | 205 | .RS 4 |
1fe8c44b | 206 | Display the last saved dump on the specified port and reporter. |
3147e0d3 AL |
207 | .RE |
208 | .PP | |
1fe8c44b | 209 | devlink health dump clear pci/0000:00:09.0/1 reporter tx |
3147e0d3 | 210 | .RS 4 |
1fe8c44b | 211 | Delete saved dump on the specified port and reporter. |
3147e0d3 AL |
212 | .RE |
213 | .PP | |
1fe8c44b | 214 | devlink health set pci/0000:00:09.0 reporter fw_fatal grace_period 3500 |
3147e0d3 AL |
215 | .RS 4 |
216 | Set time interval between auto recoveries to minimum of 3500 msec on | |
217 | the specified device and reporter. | |
218 | .RE | |
219 | .PP | |
1fe8c44b VT |
220 | devlink health set pci/0000:00:09.0/1 reporter tx grace_period 3500 |
221 | .RS 4 | |
222 | Set time interval between auto recoveries to minimum of 3500 msec on | |
223 | the specified port and reporter. | |
224 | .RE | |
225 | .PP | |
226 | devlink health set pci/0000:00:09.0 reporter fw_fatal auto_recover false | |
3147e0d3 AL |
227 | .RS 4 |
228 | Turn off auto recovery on the specified device and reporter. | |
1fe8c44b | 229 | |
3147e0d3 AL |
230 | .RE |
231 | .SH SEE ALSO | |
232 | .BR devlink (8), | |
233 | .BR devlink-dev (8), | |
234 | .BR devlink-port (8), | |
235 | .BR devlink-param (8), | |
236 | .BR devlink-region (8), | |
237 | .br | |
238 | ||
239 | .SH AUTHOR | |
240 | Aya Levin <ayal@mellanox.com> |