{"id":3260,"date":"2022-12-20T17:02:11","date_gmt":"2022-12-20T20:02:11","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/devlinkhealth-man8\/"},"modified":"2022-12-20T17:02:11","modified_gmt":"2022-12-20T20:02:11","slug":"devlinkhealth-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/devlinkhealth-man8\/","title":{"rendered":"DEVLINK&minus;HEALTH (man8)"},"content":{"rendered":"<h1 align=\"center\">DEVLINK\u2212HEALTH<\/h1>\n<p> <a href=\"#NAME\">NAME<\/a><br \/> <a href=\"#SYNOPSIS\">SYNOPSIS<\/a><br \/> <a href=\"#DESCRIPTION\">DESCRIPTION<\/a><br \/> <a href=\"#EXAMPLES\">EXAMPLES<\/a><br \/> <a href=\"#SEE ALSO\">SEE ALSO<\/a><br \/> <a href=\"#AUTHOR\">AUTHOR<\/a> <\/p>\n<hr>\n<h2>NAME <a name=\"NAME\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink-health \u2212 devlink health reporting and recovery<\/p>\n<h2>SYNOPSIS <a name=\"SYNOPSIS\"><\/a> <\/h2>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink<\/b> [ <i>OPTIONS<\/i> ] <b>health<\/b> { <i>COMMAND<\/i> | <b>help<\/b> }<\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><i>OPTIONS<\/i> := { <b>\u2212V<\/b>[<i>ersion<\/i>] }<\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health show<\/b> [ { <i>DEV<\/i> | <i>DEV\/PORT_INDEX<\/i> } <b>reporter<\/b> <i>REPORTER<\/i> ]<\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health recover<\/b> { <i>DEV<\/i> | <i>DEV\/PORT_INDEX<\/i> } <b>reporter<\/b> <i>REPORTER<\/i><\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health diagnose<\/b> { <i>DEV<\/i> | <i>DEV\/PORT_INDEX<\/i> } <b>reporter<\/b> <i>REPORTER<\/i><\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health dump show<\/b> { <i>DEV<\/i> | <i>DEV\/PORT_INDEX<\/i> } <b>reporter<\/b> <i>REPORTER<\/i><\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health test<\/b> { <i>DEV<\/i> | <i>DEV\/PORT_INDEX<\/i> } <b>reporter<\/b> <i>REPORTER<\/i><\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health dump clear<\/b> { <i>DEV<\/i> | <i>DEV\/PORT_INDEX<\/i> } <b>reporter<\/b> <i>REPORTER<\/i><\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health set<\/b> { <i>DEV<\/i> | <i>DEV\/PORT_INDEX<\/i> } <b>reporter<\/b> <i>REPORTER<\/i> [ <b>grace_period<\/b> <i>MSEC<\/i> ] [ <b>auto_recover<\/b> { <b>true<\/b> | <b>false<\/b> } ] [ <b>auto_dump<\/b> { <b>true<\/b> | <b>false<\/b> } ]<\/p>\n<p style=\"margin-left:23%; margin-top: 1em\"><b>devlink health help<\/b><\/p>\n<h2>DESCRIPTION <a name=\"DESCRIPTION\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink health show &#8211; Show status and configuration on all supported reporters.<\/b> <br \/> Displays info about reporters registered on devlink devices and ports.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>DEV<\/i> &#8211; specifies the devlink device. <i><br \/> DEV\/PORT_INDEX<\/i> &#8211; specifies the devlink port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>REPORTER<\/i> &#8211; specifies the reporter\u2019s name registered on specified devlink device or port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink health recover &#8211; Initiate a recovery operation on a reporter.<\/b> <br \/> This action performs a recovery and increases the recoveries counter on success.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>DEV<\/i> &#8211; specifies the devlink device. <i><br \/> DEV\/PORT_INDEX<\/i> &#8211; specifies the devlink port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>REPORTER<\/i> &#8211; specifies the reporter\u2019s name registered on specified devlink device or port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink health diagnose &#8211; Retrieve diagnostics data on a reporter.<\/b> <i><br \/> DEV<\/i> &#8211; specifies the devlink device. <i><br \/> DEV\/PORT_INDEX<\/i> &#8211; specifies the devlink port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>REPORTER<\/i> &#8211; specifies the reporter\u2019s name registered on specified devlink device or port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink health test &#8211; Trigger a test event on a reporter.<\/b> <i><br \/> DEV<\/i> &#8211; specifies the devlink device.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>REPORTER<\/i> &#8211; specifies the reporter\u2019s name registered on the devlink device.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink health dump show &#8211; Display the last saved dump.<\/b> <br \/> devlink health saves a single dump per reporter. If an dump is <br \/> not already stored by the Devlink, this command will generate a new <br \/> dump. The dump can be generated either automatically when a <br \/> reporter reports on an error or manually at the user\u2019s request.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>DEV<\/i> &#8211; specifies the devlink device. <i><br \/> DEV\/PORT_INDEX<\/i> &#8211; specifies the devlink port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>REPORTER<\/i> &#8211; specifies the reporter\u2019s name registered on specified devlink device or port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink health dump clear &#8211; Delete the saved dump.<\/b> <br \/> Deleting the saved dump enables a generation of a new dump on <br \/> the next &#8220;devlink health dump show&#8221; command.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>DEV<\/i> &#8211; specifies the devlink device. <i><br \/> DEV\/PORT_INDEX<\/i> &#8211; specifies the devlink port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>REPORTER<\/i> &#8211; specifies the reporter\u2019s name registered on specified devlink device or port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink health set &#8211; Configure health reporter.<\/b> <br \/> Please note that some params are not supported on a reporter which doesn\u2019t support a recovery or dump method.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>DEV<\/i> &#8211; specifies the devlink device. <i><br \/> DEV\/PORT_INDEX<\/i> &#8211; specifies the devlink port.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><i>REPORTER<\/i> &#8211; specifies the reporter\u2019s name registered on specified devlink device or port. <b><br \/> grace_period<\/b> <i>MSEC<\/i><\/p>\n<p style=\"margin-left:22%;\">Time interval between consecutive auto recoveries.<\/p>\n<p style=\"margin-left:11%;\"><b>auto_recover<\/b> { <b>true<\/b> | <b>false<\/b> }<\/p>\n<p style=\"margin-left:22%;\">Indicates whether the devlink should execute automatic recover on error.<\/p>\n<p style=\"margin-left:11%;\"><b>auto_dump<\/b> { <b>true<\/b> | <b>false<\/b> }<\/p>\n<p style=\"margin-left:22%;\">Indicates whether the devlink should execute automatic dump on error.<\/p>\n<h2>EXAMPLES <a name=\"EXAMPLES\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health show<\/p>\n<p style=\"margin-left:17%;\">List status and configuration of available reporters on devices and ports.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health show pci\/0000:00:09.0\/1 reporter tx<\/p>\n<p style=\"margin-left:17%;\">List status and configuration of tx reporter registered on port on pci\/0000:00:09.0\/1<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health recover pci\/0000:00:09.0 reporter fw_fatal<\/p>\n<p style=\"margin-left:17%;\">Initiate recovery on fw_fatal reporter registered on device on pci\/0000:00:09.0.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health recover pci\/0000:00:09.0\/1 reporter tx<\/p>\n<p style=\"margin-left:17%;\">Initiate recovery on tx reporter registered on port on pci\/0000:00:09.0\/1.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health diagnose pci\/0000:00:09.0 reporter fw<\/p>\n<p style=\"margin-left:17%;\">List diagnostics data on the specified device and reporter.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health dump show pci\/0000:00:09.0\/1 reporter tx<\/p>\n<p style=\"margin-left:17%;\">Display the last saved dump on the specified port and reporter.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health dump clear pci\/0000:00:09.0\/1 reporter tx<\/p>\n<p style=\"margin-left:17%;\">Delete saved dump on the specified port and reporter.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health set pci\/0000:00:09.0 reporter fw_fatal grace_period 3500<\/p>\n<p style=\"margin-left:17%;\">Set time interval between auto recoveries to minimum of 3500 msec on the specified device and reporter.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health set pci\/0000:00:09.0\/1 reporter tx grace_period 3500<\/p>\n<p style=\"margin-left:17%;\">Set time interval between auto recoveries to minimum of 3500 msec on the specified port and reporter.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">devlink health set pci\/0000:00:09.0 reporter fw_fatal auto_recover false<\/p>\n<p style=\"margin-left:17%;\">Turn off auto recovery on the specified device and reporter.<\/p>\n<h2>SEE ALSO <a name=\"SEE ALSO\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>devlink<\/b>(8), <b>devlink-dev<\/b>(8), <b>devlink-port<\/b>(8), <b>devlink-param<\/b>(8), <b>devlink-region<\/b>(8),<\/p>\n<h2>AUTHOR <a name=\"AUTHOR\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">Aya Levin <ayal@mellanox.com><\/p>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p>  devlink-health \u2212 devlink health reporting and recovery <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,394,4],"class_list":["post-3260","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-devlink-health","tag-man8"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3260","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3260"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3260\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3260"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3260"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3260"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}