summaryrefslogtreecommitdiffstats
path: root/sys-utils/wdctl.8
blob: 6c288543d44260917788aff1f1163d4674756b11 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
'\" t
.\"     Title: wdctl
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-01-31
.\"    Manual: System Administration
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "WDCTL" "8" "2024-01-31" "util\-linux 2.40" "System Administration"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
wdctl \- show hardware watchdog status
.SH "SYNOPSIS"
.sp
\fBwdctl\fP [options] [\fIdevice\fP...]
.SH "DESCRIPTION"
.sp
Show hardware watchdog status. The default device is \fI/dev/watchdog\fP. If more than one device is specified then the output is separated by one blank line.
.sp
If the device is already used or user has no permissions to read from the device, then \fBwdctl\fP reads data from sysfs. In this case information about supported features (flags) might be missing.
.sp
Note that the number of supported watchdog features is hardware specific.
.SH "OPTIONS"
.sp
\fB\-f\fP, \fB\-\-flags\fP \fIlist\fP
.RS 4
Print only the specified flags.
.RE
.sp
\fB\-F\fP, \fB\-\-noflags\fP
.RS 4
Do not print information about flags.
.RE
.sp
\fB\-I\fP, \fB\-\-noident\fP
.RS 4
Do not print watchdog identity information.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Do not print a header line for flags table.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlist\fP
.RS 4
Define the output columns to use in table of watchdog flags. If no output arrangement is specified, then a default set is used. Use \fB\-\-help\fP to get list of all supported columns.
.RE
.sp
\fB\-O\fP, \fB\-\-oneline\fP
.RS 4
Print all wanted information on one line in key="value" output format.
.RE
.sp
\fB\-p\fP, \fB\-\-setpretimeout\fP \fIseconds\fP
.RS 4
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 \fB\-\-setpregovernor\fP.
.RE
.sp
\fB\-g\fP, \fB\-\-setpregovernor\fP \fIgovernor\fP
.RS 4
Set pre\-timeout governor name. For available governors see default \fBwdctl\fP output.
.RE
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
Use the raw output format.
.RE
.sp
\fB\-s\fP, \fB\-\-settimeout\fP \fIseconds\fP
.RS 4
Set the watchdog timeout in seconds.
.RE
.sp
\fB\-T\fP, \fB\-\-notimeouts\fP
.RS 4
Do not print watchdog timeouts.
.RE
.sp
\fB\-x\fP, \fB\-\-flags\-only\fP
.RS 4
Same as \fB\-I \-T\fP.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Display help text and exit.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Print version and exit.
.RE
.SH "AUTHORS"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ","
.MTO "lennart\(atpoettering.net" "Lennart Poettering" ""
.SH "REPORTING BUGS"
.sp
For bug reports, use the issue tracker at \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "AVAILABILITY"
.sp
The \fBwdctl\fP command is part of the util\-linux package which can be downloaded from \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."