Name
devlink-health - devlink health reporting and recoverySynopsis
devlink "[ " OPTIONS " ]" health " { " COMMAND " | " help " }"OPTIONS " := { "
-V[ersion] } devlink health show "[ { " DEV " | " DEV/PORT_INDEX " }" reporter ""REPORTER " ] " devlink health recover "{ " DEV " | " DEV/PORT_INDEX " }" reporter "" REPORTER "" devlink health diagnose "{ " DEV " | " DEV/PORT_INDEX " }" reporter "" REPORTER "" devlink health dump show "{ " DEV " | " DEV/PORT_INDEX " }" reporter "" REPORTER "" "devlink health test""{ " DEV " | " DEV/PORT_INDEX " }" reporter "" REPORTER "" devlink health dump clear "{ " DEV " | " DEV/PORT_INDEX " }" reporter "" REPORTER "" devlink health set "{ " DEV " | " DEV/PORT_INDEX " }" reporter "" REPORTER "" [ grace_period " MSEC ] [ auto_recover " { " true " | " false " } "] [ auto_dump " { " true " | " false " } "] devlink health help
Description
Devlink Health Show - Show Status And Configuration On All Supported Reporters.
Displays info about reporters registered on devlink devices and ports."DEV" - specifies the devlink device. DEV/PORT_INDEX - specifies the devlink port.
"REPORTER" - specifies the reporter's name registered on specified devlink device or port.
Devlink Health Recover - Initiate A Recovery Operation On A Reporter.
This action performs a recovery and increases the recoveries counter on success."DEV" - specifies the devlink device. DEV/PORT_INDEX - specifies the devlink port.
"REPORTER" - specifies the reporter's name registered on specified devlink device or port.
Devlink Health Diagnose - Retrieve Diagnostics Data On A Reporter.
DEV - specifies the devlink device. DEV/PORT_INDEX - specifies the devlink port.
"REPORTER" - specifies the reporter's name registered on specified devlink device or port.
Devlink Health Test - Trigger A Test Event On A Reporter.
"DEV" - specifies the devlink device.
"REPORTER" - specifies the reporter's name registered on the devlink device.
Devlink Health Dump Show - Display The Last Saved Dump.
devlink health saves a single dump per reporter. If an dump is
not already stored by the Devlink, this command will generate a new
dump. The dump can be generated either automatically when a
reporter reports on an error or manually at the user's request.
"DEV" - specifies the devlink device. DEV/PORT_INDEX - specifies the devlink port.
"REPORTER" - specifies the reporter's name registered on specified devlink device or port.
Devlink Health Dump Clear - Delete The Saved Dump.
Deleting the saved dump enables a generation of a new dump onthe next "devlink health dump show" command.
"DEV" - specifies the devlink device. DEV/PORT_INDEX - specifies the devlink port.
"REPORTER" - specifies the reporter's name registered on specified devlink device or port.
Devlink Health Set - Configure Health Reporter.
Please note that some params are not supported on a reporter which doesn't support a recovery or dump method."DEV" - specifies the devlink device. DEV/PORT_INDEX - specifies the devlink port.
"REPORTER" - specifies the reporter's name registered on specified devlink device or port.
Time interval between consecutive auto recoveries.
auto_recover " { " true " | " false " } "Indicates whether the devlink should execute automatic recover on error.
auto_dump " { " true " | " false " } "Indicates whether the devlink should execute automatic dump on error.
Examples
devlink health show List status and configuration of available reporters on devices and ports.
devlink health show pci/0000:00:09.0/1 reporter tx List status and configuration of tx reporter registered on port on pci/0000:00:09.0/1
devlink health recover pci/0000:00:09.0 reporter fw_fatal Initiate recovery on fw_fatal reporter registered on device on pci/0000:00:09.0.
devlink health recover pci/0000:00:09.0/1 reporter tx Initiate recovery on tx reporter registered on port on pci/0000:00:09.0/1.
devlink health diagnose pci/0000:00:09.0 reporter fw List diagnostics data on the specified device and reporter.
devlink health dump show pci/0000:00:09.0/1 reporter tx Display the last saved dump on the specified port and reporter.
devlink health dump clear pci/0000:00:09.0/1 reporter tx Delete saved dump on the specified port and reporter.
devlink health set pci/0000:00:09.0 reporter fw_fatal grace_period 3500 Set time interval between auto recoveries to minimum of 3500 msec on the specified device and reporter.
devlink health set pci/0000:00:09.0/1 reporter tx grace_period 3500 Set time interval between auto recoveries to minimum of 3500 msec on the specified port and reporter.
devlink health set pci/0000:00:09.0 reporter fw_fatal auto_recover false Turn off auto recovery on the specified device and reporter.
See Also
- devlink(8),
- devlink-dev(8),
- devlink-port(8),
- devlink-param(8),
- devlink-region(8),