{
    "mode": "man",
    "parameter": "WDCTL",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/WDCTL/8/json",
    "generated": "2026-10-06T13:07:12Z",
    "synopsis": "wdctl [options] [device...]",
    "sections": {
        "NAME": {
            "content": "wdctl - show hardware watchdog status\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "wdctl [options] [device...]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Show hardware watchdog status. The default device is /dev/watchdog. If more than one device\nis specified then the output is separated by one blank line.\n\nIf the device is already used or user has no permissions to read from the device, then wdctl\nreads data from sysfs. In this case information about supported features (flags) might be\nmissing.\n\nNote that the number of supported watchdog features is hardware specific.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-f --flags _",
                    "content": "Print only the specified flags.\n",
                    "flag": "-f",
                    "long": "--flags"
                },
                {
                    "name": "-F --noflags",
                    "content": "Do not print information about flags.\n",
                    "flag": "-F",
                    "long": "--noflags"
                },
                {
                    "name": "-I --noident",
                    "content": "Do not print watchdog identity information.\n",
                    "flag": "-I",
                    "long": "--noident"
                },
                {
                    "name": "-n --noheadings",
                    "content": "Do not print a header line for flags table.\n",
                    "flag": "-n",
                    "long": "--noheadings"
                },
                {
                    "name": "-o --output _",
                    "content": "Define the output columns to use in table of watchdog flags. If no output arrangement is\nspecified, then a default set is used. Use --help to get list of all supported columns.\n",
                    "flag": "-o",
                    "long": "--output"
                },
                {
                    "name": "-O --oneline",
                    "content": "Print all wanted information on one line in key=\"value\" output format.\n",
                    "flag": "-O",
                    "long": "--oneline"
                },
                {
                    "name": "-p --setpretimeout _",
                    "content": "Set the watchdog pre-timeout in seconds. A watchdog pre-timeout is a notification\ngenerated by the watchdog before the watchdog reset might occur in the event the watchdog\nhas not been serviced. This notification is handled by the kernel and can be configured\nto take an action using sysfs or by --setpregovernor.\n",
                    "flag": "-p",
                    "long": "--setpretimeout"
                },
                {
                    "name": "-g --setpregovernor _",
                    "content": "Set pre-timeout governor name. For available governors see default wdctl output.\n",
                    "flag": "-g",
                    "long": "--setpregovernor"
                },
                {
                    "name": "-r --raw",
                    "content": "Use the raw output format.\n",
                    "flag": "-r",
                    "long": "--raw"
                },
                {
                    "name": "-s --settimeout _",
                    "content": "Set the watchdog timeout in seconds.\n",
                    "flag": "-s",
                    "long": "--settimeout"
                },
                {
                    "name": "-T --notimeouts",
                    "content": "Do not print watchdog timeouts.\n",
                    "flag": "-T",
                    "long": "--notimeouts"
                },
                {
                    "name": "-x --flags-only",
                    "content": "Same as -I -T.\n",
                    "flag": "-x",
                    "long": "--flags-only"
                },
                {
                    "name": "-h --help",
                    "content": "Display help text and exit.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-V --version",
                    "content": "Print version and exit.\n",
                    "flag": "-V",
                    "long": "--version"
                }
            ]
        },
        "AUTHORS": {
            "content": "Karel Zak <kzak@redhat.com>, Lennart Poettering <lennart@poettering.net>\n",
            "subsections": []
        },
        "REPORTING BUGS": {
            "content": "For bug reports, use the issue tracker at https://github.com/util-linux/util-linux/issues.\n",
            "subsections": []
        },
        "AVAILABILITY": {
            "content": "The wdctl command is part of the util-linux package which can be downloaded from Linux Kernel\nArchive <https://www.kernel.org/pub/linux/utils/util-linux/>.\n\nutil-linux 2.39.3                            2023-10-23                                     WDCTL(8)",
            "subsections": []
        }
    },
    "summary": "wdctl - show hardware watchdog status",
    "flags": [
        {
            "flag": "-f",
            "long": "--flags",
            "arg": null,
            "description": "Print only the specified flags."
        },
        {
            "flag": "-F",
            "long": "--noflags",
            "arg": null,
            "description": "Do not print information about flags."
        },
        {
            "flag": "-I",
            "long": "--noident",
            "arg": null,
            "description": "Do not print watchdog identity information."
        },
        {
            "flag": "-n",
            "long": "--noheadings",
            "arg": null,
            "description": "Do not print a header line for flags table."
        },
        {
            "flag": "-o",
            "long": "--output",
            "arg": null,
            "description": "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."
        },
        {
            "flag": "-O",
            "long": "--oneline",
            "arg": null,
            "description": "Print all wanted information on one line in key=\"value\" output format."
        },
        {
            "flag": "-p",
            "long": "--setpretimeout",
            "arg": null,
            "description": "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."
        },
        {
            "flag": "-g",
            "long": "--setpregovernor",
            "arg": null,
            "description": "Set pre-timeout governor name. For available governors see default wdctl output."
        },
        {
            "flag": "-r",
            "long": "--raw",
            "arg": null,
            "description": "Use the raw output format."
        },
        {
            "flag": "-s",
            "long": "--settimeout",
            "arg": null,
            "description": "Set the watchdog timeout in seconds."
        },
        {
            "flag": "-T",
            "long": "--notimeouts",
            "arg": null,
            "description": "Do not print watchdog timeouts."
        },
        {
            "flag": "-x",
            "long": "--flags-only",
            "arg": null,
            "description": "Same as -I -T."
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Display help text and exit."
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "Print version and exit."
        }
    ],
    "examples": [],
    "see_also": []
}