# wdctl

## NAME



           wdctl - show hardware watchdog status
    


## SYNOPSIS



           **wdctl**[options] [_device_...]
    


## DESCRIPTION



           Show hardware watchdog status. The default device is
           _/dev/watchdog_. If more than one device is specified then the
           output is separated by one blank line.
    
           If the device is already used or user has no permissions to read
           from the device, then **wdctl** reads data from sysfs. In this case
           information about supported features (flags) might be missing.
    
           Note that the number of supported watchdog features is hardware
           specific.
    


## OPTIONS



           **-f** , **--flags** _list_
               Print only the specified flags.
    
           **-F** , **--noflags**
               Do not print information about flags.
    
           **-I** , **--noident**
               Do not print watchdog identity information.
    
           **-n** , **--noheadings**
               Do not print a header line for flags table.
    
           **-o** , **--output** _list_
               Define the output columns to use in table of watchdog flags.
               If no output arrangement is specified, then a default set is
               used. Use **--help** to get list of all supported columns.
    
           **-O** , **--oneline**
               Print all wanted information on one line in key="value" output
               format.
    
           **-p** , **--setpretimeout** _seconds_
               Set the watchdog pre-timeout in seconds. A watchdog
               pre-timeout is a notification generated by the watchdog before
               the watchdog reset might occur in the event the watchdog has
               not been serviced. This notification is handled by the kernel
               and can be configured to take an action using sysfs or by
               **--setpregovernor**.
    
           **-g** , **--setpregovernor** _governor_
               Set pre-timeout governor name. For available governors see
               default **wdctl** output.
    
           **-r** , **--raw**
               Use the raw output format.
    
           **-s** , **--settimeout** _seconds_
               Set the watchdog timeout in seconds.
    
           **-T** , **--notimeouts**
               Do not print watchdog timeouts.
    
           **-x** , **--flags-only**
               Same as **-I -T**.
    
           **-h** , **--help**
               Display help text and exit.
    
           **-V** , **--version**
               Display version and exit.
    


## AVAILABILITY



           The **wdctl** command is part of the util-linux package which can be
           downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) 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
    
    util-linux 2.42-start-521-ec46  2025-08-09                       _WDCTL_(8)
    


* * *