NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON

DEVLINK-HEALTH(8)                   Linux                  DEVLINK-HEALTH(8)

NAME         top

       devlink-health - devlink health reporting and recovery

SYNOPSIS         top

       devlink [ OPTIONS ] health  { COMMAND | help }

       OPTIONS := { -V[ersion] }

       devlink health show [ DEV reporter REPORTER ]

       devlink health recover DEV reporter REPORTER

       devlink health diagnose DEV reporter REPORTER

       devlink health dump show DEV reporter REPORTER

       devlink health dump clear DEV reporter REPORTER

       devlink health set DEV reporter REPORTER  { grace_period |
               auto_recover  } { msec | boolean  }
       devlink health help

DESCRIPTION         top

   devlink health show - Show status and configuration on all supported
       reporters on all devlink devices.
       DEV - specifies the devlink device.

       REPORTER - specifies the reporter's name registered on the devlink
       device.

   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.

       REPORTER - specifies the reporter's name registered on the devlink
       device.

   devlink health diagnose - Retrieve diagnostics data 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.

       REPORTER - specifies the reporter's name registered on the devlink
       device.

   devlink health dump clear - Delete the saved dump.
       Deleting the saved dump enables a generation of a new dump on
       the next "devlink health dump show" command.

       DEV - specifies the devlink device.

       REPORTER - specifies the reporter's name registered on the devlink
       device.

   devlink health set - Enable the user to configure:
       1) grace_period [msec] - Time interval between consecutive auto
       recoveries.
       2) auto_recover [true/false] - Indicates whether the devlink should
       execute automatic recover on error.
       Please note that this command is not supported on a reporter which
       doesn't support a recovery method.

       DEV - specifies the devlink device.

       REPORTER - specifies the reporter's name registered on the devlink
       device.

EXAMPLES         top

       devlink health show
           List status and configuration of available reporters on devices.

       devlink health recover pci/0000:00:09.0 reporter tx
           Initiate recovery on tx reporter registered on pci/0000:00:09.0.

       devlink health diagnose pci/0000:00:09.0 reporter tx
           List diagnostics data on the specified device and reporter.

       devlink health dump show pci/0000:00:09.0 reporter tx
           Display the last saved dump on the specified device and reporter.

       devlink health dump clear pci/0000:00:09.0 reporter tx
           Delete saved dump on the specified device and reporter.

       devlink health set pci/0000:00:09.0 reporter tx 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 reporter tx auto_recover false
           Turn off auto recovery on the specified device and reporter.

SEE ALSO         top

       devlink(8), devlink-dev(8), devlink-port(8), devlink-param(8),
       devlink-region(8),

AUTHOR         top

       Aya Levin <ayal@mellanox.com>

COLOPHON         top

       This page is part of the iproute2 (utilities for controlling TCP/IP
       networking and traffic) project.  Information about the project can
       be found at 
       ⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
       If you have a bug report for this manual page, send it to
       netdev@vger.kernel.org, shemminger@osdl.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2019-07-28.  (At that time, the date of the most recent commit that
       was found in the repository was 2019-07-26.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

iproute2                         20 Feb 2019               DEVLINK-HEALTH(8)

Pages that refer to this page: devlink(8)