1DEVLINK-HEALTH(8)                    Linux                   DEVLINK-HEALTH(8)
2
3
4

NAME

6       devlink-health - devlink health reporting and recovery
7

SYNOPSIS

9       devlink [ OPTIONS ] health  { COMMAND | help }
10
11
12       OPTIONS := { -V[ersion] }
13
14       devlink health show [ DEV reporter REPORTER ]
15
16       devlink health recover DEV reporter REPORTER
17
18       devlink health diagnose DEV reporter REPORTER
19
20       devlink health dump show DEV reporter REPORTER
21
22       devlink health dump clear DEV reporter REPORTER
23
24       devlink health set DEV reporter REPORTER  { grace_period | auto_recover
25                } { msec | boolean  }
26       devlink health help
27
28

DESCRIPTION

30   devlink health show - Show status and configuration on all supported
31       reporters on all devlink devices.
32       DEV - specifies the devlink device.
33
34
35       REPORTER - specifies the reporter's name registered on the devlink
36       device.
37
38
39   devlink health recover - Initiate a recovery operation on a reporter.
40       This action performs a recovery and increases the recoveries counter on
41       success.
42
43
44       DEV - specifies the devlink device.
45
46
47       REPORTER - specifies the reporter's name registered on the devlink
48       device.
49
50
51   devlink health diagnose - Retrieve diagnostics data on a reporter.
52       DEV - specifies the devlink device.
53
54
55       REPORTER - specifies the reporter's name registered on the devlink
56       device.
57
58
59   devlink health dump show - Display the last saved dump.
60       devlink health saves a single dump per reporter. If an dump is
61       not already stored by the Devlink, this command will generate a new
62       dump. The dump can be generated either automatically when a
63       reporter reports on an error or manually at the user's request.
64
65
66       DEV - specifies the devlink device.
67
68
69       REPORTER - specifies the reporter's name registered on the devlink
70       device.
71
72
73   devlink health dump clear - Delete the saved dump.
74       Deleting the saved dump enables a generation of a new dump on
75       the next "devlink health dump show" command.
76
77
78       DEV - specifies the devlink device.
79
80
81       REPORTER - specifies the reporter's name registered on the devlink
82       device.
83
84
85   devlink health set - Enable the user to configure:
86       1) grace_period [msec] - Time interval between consecutive auto recov‐
87       eries.
88       2) auto_recover [true/false] - Indicates whether the devlink should
89       execute automatic recover on error.
90       Please note that this command is not supported on a reporter which
91       doesn't support a recovery method.
92
93
94       DEV - specifies the devlink device.
95
96
97       REPORTER - specifies the reporter's name registered on the devlink
98       device.
99
100

EXAMPLES

102       devlink health show
103           List status and configuration of available reporters on devices.
104
105       devlink health recover pci/0000:00:09.0 reporter tx
106           Initiate recovery on tx reporter registered on pci/0000:00:09.0.
107
108       devlink health diagnose pci/0000:00:09.0 reporter tx
109           List diagnostics data on the specified device and reporter.
110
111       devlink health dump show pci/0000:00:09.0 reporter tx
112           Display the last saved dump on the specified device and reporter.
113
114       devlink health dump clear pci/0000:00:09.0 reporter tx
115           Delete saved dump on the specified device and reporter.
116
117       devlink health set pci/0000:00:09.0 reporter tx grace_period 3500
118           Set time interval between auto recoveries to minimum of 3500 msec
119           on the specified device and reporter.
120
121       devlink health set pci/0000:00:09.0 reporter tx auto_recover false
122           Turn off auto recovery on the specified device and reporter.
123

SEE ALSO

125       devlink(8), devlink-dev(8), devlink-port(8), devlink-param(8), devlink-
126       region(8),
127
128

AUTHOR

130       Aya Levin <ayal@mellanox.com>
131
132
133
134iproute2                          20 Feb 2019                DEVLINK-HEALTH(8)
Impressum